A custom Dalamud plugin repository for FINAL FANTASY XIV — host for NexusFFXIV plugins plus a curated mirror of third-party Dalamud repos.
| Repo file | Plugin count | Scope |
|---|---|---|
pluginmaster.json |
 |
NexusFFXIV plugins only |
|
||
common-repo.json |
 |
Plugins from selected third-party repos |
|
||
external-repo.json |
 |
Individual third-party plugins |
|
||
all-repo.json |
 |
Everything above — default subscribe URL |
|
||
gen-repo.json |
 |
Auto-discovered third-party repos (standalone, not in all-repo) |
|
||
The build script warns when an entry's AssemblyVersion or TestingAssemblyVersion disagrees with the release tag its download link points at, e.g. a link to v0.2.0 next to an AssemblyVersion of 0.1.2.0.
That combination is worth flagging because it fails silently. Dalamud decides whether an update exists by comparing the version in this file against the installed assembly, so a stale version means the entry looks healthy, the link points at the new zip, and no user is ever offered the update. PlayerNexusTracker v0.2.0 shipped that way once; the plugin repo now gates its own releases on tag/manifest/assembly agreement, and this is the second net.
It stays a warning rather than a hard failure: external plugins are not ours to gate, and some upstreams version their assemblies independently of their tags. Tags that are not plain versions (release-2024-01, and similar) are skipped rather than guessed at.
-
Open Dalamud's Settings → Experimental tab (the
⚠️ icon in the Settings window). -
Under Custom Plugin Repositories, paste the default URL:
https://raw.githubusercontent.com/NexusFFXIV/DalamudRepo/main/all-repo.json -
Tick the new entry as Enabled and hit Save.
-
Open
/xlplugins, switch to All Plugins, search for the plugin you want, click Install.
Note
Other scopes — pick a different URL from the table at the top if you want a narrower view (e.g. only NexusFFXIV plugins).
Testing builds — tick Settings → Experimental → Get plugin testing builds to surface pre-release versions when available.
Want to add a plugin, mirror another repo, or understand how the pipeline works? See CONTRIBUTING.md.
AGPL-3.0-only — consistent with the rest of the NexusFFXIV org.