Release Operations (Godot Asset Library)¶
The addon already has Asset Library entry #5489. Configure the repository settings once to submit edits from release tags. Each store edit waits for moderation.
What you need¶
- A Godot Asset Library account (your forum login works).
- Admin access to this repository (to add secrets and run workflows).
- A merged
vMAJOR.MINOR.PATCHsection inCHANGELOG.md.
v0.1.1 listing¶
Entry #5489 points to this repository. Edit #24491 was submitted on
October 1, 2026, and the v0.1.1 listing went live on October 2.
Use this entry for later releases.
The v0.1.1 GitHub Release
is published. Its tag points to
5a0b00d3e78edac16e41f2bff978b500eeb2c4d6.
The live entry has these values:
| Field | Value |
|---|---|
| Title | Signal Fish Client |
| Category | Scripts |
| Godot version | 4.3 |
| Version | 0.1.1 |
| License | MIT |
| Download provider | GitHub |
| Repository URL | https://github.com/Ambiguous-Interactive/signal-fish-client-godot |
| Issues URL | repository URL + /issues |
| Icon URL | https://raw.githubusercontent.com/Ambiguous-Interactive/signal-fish-client-godot/main/docs/assets/icon-256.png |
| Download commit | 5a0b00d3e78edac16e41f2bff978b500eeb2c4d6 |
The live download contains only addons/ and loads in Godot 4.3. The
release workflow run
contains the submission job and its logs.
Repository settings¶
In Settings -> Secrets and variables -> Actions, set:
- Secret
GODOT_ASSET_LIBRARY_USERNAME- your Asset Library username. - Secret
GODOT_ASSET_LIBRARY_PASSWORD- your Asset Library password. Use a password without quotes, backslashes, or control characters. - Variable
GODOT_ASSET_LIBRARY_ASSET_ID-5489.
Review the release draft¶
Each push to main updates a draft in
Releases.
You can also run Release Draft from Actions.
It collects merged addon, docs, and README changes since the last release.
Dependency updates and skip-changelog PRs are excluded.
PR labels feature, enhancement, or added select Added. Labels bug,
bugfix, fix, or regression select Fixed. Conventional feat: and fix:
titles select those sections too. Other changes go under Changed.
Labels major and minor raise the suggested version; the default is patch.
Review the draft and copy its user-facing entries into the new changelog section. Complete the release steps below to publish it with the addon ZIP. Publishing the draft in the GitHub UI skips packaging and store submission.
Every release (automated)¶
- Make sure
CHANGELOG.mdhas a section for the new version andaddons/signal_fish/plugin.cfgversionmatches it (without thev). - Push a
vMAJOR.MINOR.PATCHtag on a commit inmain, or run the Release workflow (Actions -> Release -> Run workflow) with the version, e.g.v0.1.0. - The workflow:
- validates the tag format,
- cuts release notes from the matching
CHANGELOG.mdsection, - packages the addon zip and publishes the matching draft, or creates a release,
- submits a store edit with the new version and tag.
Both downloads contain only addons/. Demo scenes and the full docs remain in
the source repository.
The release workflow rejects invalid versions, an existing tag on manual cuts, and an already published release. A draft stays unpublished if its ZIP upload fails. Publishing uses the reviewed changelog section as the final notes.
No secrets configured? The store step skips with a log line and the GitHub Release still publishes.
After release: moderation¶
Every store submission creates a pending edit that a moderator must accept. A green workflow run means "submitted", not "live". Check your entry at the Asset Library after each release.
Troubleshooting¶
- Store step skipped. A secret or the asset ID variable is missing. Check the names above - they must match exactly.
- Submission failed. The action logs its render env, so a leaked password is possible with exotic characters; see the password rule above.
- Manual fallback. Edit entry #5489 by hand with the field values above,
or use the curl flow documented in
.llm/skills/asset-library-release.md.