This repository hosts plugin binaries that are used with Dalamud, which is managed by FFXIVQuickLauncher.

To install plugins, you'll need to use XIVLauncher with the in-game addon (Dalamud) enabled. Once Dalamud has loaded, you can type /xlplugins in game to open a plugin installed.

You do not need to download any of the plugins here manually. Plugin installation is handled inside of the game directly.

Please see the API documentation for information about creating plugins.

Make sure that your plugin does not directly interact with the game servers in a way that is:
a) automatic, as in polling data or making requests without direct interaction from the user.
b) outside of specification, as in allowing the player to do submit things to the server that would not be possible by normal means.

Create a pull request with your own subfolder in the plugins directory of this folder. It should be named the "internal" name(name of the DLL) of your plugin and contain a plugin definition file with the same name. It should also contain a zip called "latest.zip" containing your plugin DLL, dependencies, resources and the plugin definition json in the same folder as the plugin DLL.

When the AssemblyVersion of the locally installed plugin doesn't match the "AssemblyVersion" field of the plugin definition json pushed to this repository, a redownload of the plugin is forced.

For a sample of this, please see my sample plugin.

When releasing a new plugin or making bigger changes, please PR your plugin inside the testing folder on this repository first - this lets users that opt into receiving testing releases see the plugin in their installer. You can join our Discord server to make an announcement in our testers channel.

This should usually not take more than a week - but it helps weeding out bigger issues that could cause crashes or prevent the plugin from being updated.