Skip to content

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.PATCH section in CHANGELOG.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)

  1. Make sure CHANGELOG.md has a section for the new version and addons/signal_fish/plugin.cfg version matches it (without the v).
  2. Push a vMAJOR.MINOR.PATCH tag on a commit in main, or run the Release workflow (Actions -> Release -> Run workflow) with the version, e.g. v0.1.0.
  3. The workflow:
  4. validates the tag format,
  5. cuts release notes from the matching CHANGELOG.md section,
  6. packages the addon zip and publishes the matching draft, or creates a release,
  7. 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.