DalamudPlugins/README.md

DalamudPlugins – master list

This repo is the single custom repository for Dalamud. It contains only the master list (pluginmaster.json). Each plugin’s source and releases stay in their own repos (HSPosition, HSCompare, etc.).

If installs fail

1. Releases must exist. Each plugin needs a release on its repo with the zip attached:
   • HSPosition: repo HSPosition → Release tag HSPosition-0.0.0.1 (or the tag in the JSON) → attach latest.zip.
   • HSCompare: repo HSCompare → Release tag HSCompare-0.0.0.1 → attach latest.zip.
2. Download URL = release tag. The path is /releases/download/<TAG>/latest.zip. The <TAG> must match the release tag in Gitea exactly (e.g. HSPosition-0.0.0.1).
3. HTTP. All URLs in pluginmaster.json use http:// for this Gitea (port 33983). If you switch to HTTPS later, change them to https://.
4. No auth. The raw pluginmaster URL and the release zip URLs must be reachable without login.

What users add in Dalamud

1. Open xlsettings (or Dalamud Settings).

2. Go to Experimental → Custom Plugin Repositories.

3. Add this URL (raw link to pluginmaster.json):

   http://brassnet.ddns.net:33983/Dawnsorrow/DalamudPlugins/raw/branch/main/pluginmaster.json

(If your default branch is master, use raw/branch/master/pluginmaster.json.)

4. Save. In xlplugins, your repo will appear and list all plugins.

---

Adding or updating a plugin

• Edit pluginmaster.json and add or update an entry (copy an existing one and change fields).
• DownloadLinkInstall / DownloadLinkUpdate must point to the plugin’s zip, usually from that plugin’s own repo releases, e.g.
  https://brassnet.ddns.net:33983/Dawnsorrow/HSPosition/releases/download/HSPosition-0.0.0.1/latest.zip
• Set LastUpdate to current Unix timestamp (date +%s).
• Commit and push this repo. Users see changes after they refresh the plugin list.