- 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>
3.8 KiB
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 (1–8)
- Cross-World Link Shell (1–8)
- 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
- You set a trigger word in the plugin configuration (default:
inv). - The plugin listens to chat in the channels you enable (FC, LS, CWLS, tells).
- When a message contains the trigger text, the plugin invites the sender of that message to your party using the game’s party invite API.
For tells, the game provides the sender’s content ID and world, so invites work reliably. For FC, LS, and CWLS, the plugin uses the sender’s 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
-
Open
HSRTools.slnin Visual Studio or use the command line. -
Build in Release (or use your dev plugin folder for testing):
dotnet build HSRTools.sln -c Release -
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
- Bump
VersioninHSRTools/HSRTools.csprojand updateCHANGELOG.md. - Build:
dotnet build HSRTools.sln -c Release. - Zip the contents of
HSRTools/bin/Release/HSRTools/(DLL +HSRTools.json) asHSRTools.zip. - Create a new GitHub release with tag
v1.0.0(match version), attachHSRTools.zip. - Update
pluginmaster.json: setAssemblyVersion,LastUpdate(Unix timestamp), andDownloadLinkInstall/DownloadLinkUpdateto the release zip URL, e.g.https://github.com/Knack117/HSRTools/releases/download/v1.0.0/HSRTools.zip. - To get on the official Dalamud repo: open a PR to goatcorp/DalamudPlugins with your plugin and a
pluginmaster.jsonentry (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.