# 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.