HSRTools/RELEASING.md

Releasing HSRTools

1. Version and changelog

• Bump <Version> in HSRTools/HSRTools.csproj (e.g. 1.0.0.0 → 1.0.1.0).
• Update CHANGELOG.md with the new version and date.

2. Build

dotnet build HSRTools.sln -c Release

3. Create release zip

Zip the contents of HSRTools/bin/Release/HSRTools/ (so the zip contains HSRTools.dll and HSRTools.json at the root), and name it HSRTools.zip.

• Windows (PowerShell):
  Compress-Archive -Path "HSRTools\bin\Release\HSRTools\*" -DestinationPath "HSRTools.zip"
• From repo root:
  Run the above from the repo root so the archive has no extra folder layer.

4. GitHub release

1. Push your commits and ensure main is up to date.
2. Create a new release: Releases → Draft a new release.
3. Tag: v1.0.0 (match the version, e.g. v1.0.0.0 or v1.0.0).
4. Title: e.g. v1.0.0 or HSRTools 1.0.0.
5. Description: Paste the relevant section from CHANGELOG.md.
6. Attach HSRTools.zip.
7. Publish the release.

5. pluginmaster.json (for third-party repo)

If you host your own plugin list:

• Set AssemblyVersion to the same version (e.g. 1.0.0.0).
• Set LastUpdate to current Unix timestamp (e.g. date +%s or epoch converter).
• Set DownloadLinkInstall and DownloadLinkUpdate to the zip URL, e.g.:
  https://github.com/Knack117/HSRTools/releases/download/v1.0.0/HSRTools.zip
• Host pluginmaster.json at a stable URL and add that URL as a “custom plugin repository” in XIVLauncher → Dalamud Settings.

6. Official Dalamud repo (optional)

To get HSRTools on the main Dalamud plugin list:

1. Open goatcorp/DalamudPlugins and check their README and pluginmaster.json format.
2. Fork, add your plugin (or a manifest entry pointing to your repo), and open a PR.
3. They may host the zip on their CDN; follow their instructions for new plugins.