Dawnsorrow
35 lines
1.9 KiB
Markdown
35 lines
1.9 KiB
Markdown
# 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.
|