Files
HSRTools/README.md
T
jorg 4dcea5d7de Add auto-accept party invites from friends and FC members
- New AutoAcceptPartyService uses IAddonLifecycle to detect party invite popup
- Checks inviter against InfoProxyFriendList and InfoProxyFreeCompanyMember
- Config options: AutoAcceptEnabled, AutoAcceptFromFriends, AutoAcceptFromFreeCompany
- Bump version to 1.0.4, update CHANGELOG and README

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-20 20:40:44 -06:00

3.8 KiB
Raw Blame History

HSRTools

A Dalamud plugin for FFXIV (XIVLauncher) that automatically invites players to your party when they say a specific trigger word or phrase in chat.

Features

  • Configurable trigger text Set any word or phrase (e.g. inv, invite, party). When someone types it in a monitored channel, they are invited to your party.
  • Auto-accept party invites Optionally automatically accept party invites when the inviter is on your friend list or is a member of your Free Company.
  • Channel selection Choose which channels to monitor:
    • Free Company
    • Link Shell (18)
    • Cross-World Link Shell (18)
    • Tells / Whispers
  • Case sensitivity Option to match the trigger with or without case sensitivity.
  • Enable/disable Turn the plugin on or off without uninstalling.

How it works

  1. You set a trigger word in the plugin configuration (default: inv).
  2. The plugin listens to chat in the channels you enable (FC, LS, CWLS, tells).
  3. When a message contains the trigger text, the plugin invites the sender of that message to your party using the games party invite API.

For tells, the game provides the senders content ID and world, so invites work reliably. For FC, LS, and CWLS, the plugin uses the senders content ID when available (e.g. from the last message in CWLS), so cross-world invites work for CWLS and same-world for FC/LS.

Auto-accept party invites

When enabled, the plugin detects incoming party invites and automatically accepts them if the inviter is on your friend list or is a member of your Free Company. You can toggle friends and FC members independently. The friend list and FC roster must have been opened in-game at least once for the plugin to recognize members.

Building

  1. Open HSRTools.sln in Visual Studio or use the command line.

  2. Build in Release (or use your dev plugin folder for testing):

    dotnet build HSRTools.sln -c Release
    
  3. The SDK uses your XIVLauncher dev environment; the built DLL goes to your dev plugin folder.

Configuration

  • Open the plugin config from the Dalamud plugin list (right-click HSRTools → Settings).
  • Set the trigger text, enable/disable the plugin, choose channels, set case sensitivity, and configure auto-accept (friends/FC).
  • Settings are saved when you close the game or disable the plugin.

Requirements

  • XIVLauncher with Dalamud
  • .NET (as required by your Dalamud version)

Installation

  • From official Dalamud repo: If this plugin is accepted, install via XIVLauncher → Dalamud Settings → Plugin Installer.
  • Third-party / dev: Add a custom plugin repo that points to a pluginmaster.json (see Releasing), or download the latest release zip from Releases and extract into your Dalamud plugin folder.

Releasing

  1. Bump Version in HSRTools/HSRTools.csproj and update CHANGELOG.md.
  2. Build: dotnet build HSRTools.sln -c Release.
  3. Zip the contents of HSRTools/bin/Release/HSRTools/ (DLL + HSRTools.json) as HSRTools.zip.
  4. Create a new GitHub release with tag v1.0.0 (match version), attach HSRTools.zip.
  5. Update pluginmaster.json: set AssemblyVersion, LastUpdate (Unix timestamp), and DownloadLinkInstall / DownloadLinkUpdate to the release zip URL, e.g. https://github.com/Knack117/HSRTools/releases/download/v1.0.0/HSRTools.zip.
  6. To get on the official Dalamud repo: open a PR to goatcorp/DalamudPlugins with your plugin and a pluginmaster.json entry (they host the zip; see their repo for the exact format).

License

MIT. See LICENSE. This plugin is not officially affiliated with Square Enix or the FFXIV project.