Skip to content

Add-ons as a .zip for Import Add-ons, on the addons release and the site - #138

Merged
brahm merged 1 commit into
mainfrom
claude/project-thread-wqaht1
Oct 30, 2026
Merged

brahm merged 1 commit into
mainfrom
claude/project-thread-wqaht1

Conversation

@brahm

@brahm brahm commented Oct 29, 2026

Copy link
Copy Markdown
Owner

Requested by Brahm · project thread

The validated add-ons that the Linux installer carries, as one .zip that the app's new Import Add-ons… reads (on Linux, Windows and macOS), downloadable from the addons release and the landing page.

What changes

  • addons/tools/addons_zip.py VERSION DIR unpacks addons/Comunidade.xpx.xz and addons/Comunidade-extras.xz into CoreRules-Community-Addons-VERSION.zip, one folder with:

    • Comunidade.xpx (36,525 items, Expansion format)
    • pictures/ (668 BMPs) and pictures.tsv (pictureplace, relative to the tsv's folder)
    • texts/ (309 author texts), addons.tsv
    • README.txt and LEIA-ME.txt

    The output is deterministic (fixed dates and order). ~39 MB.

  • .github/workflows/addons.yml: new zip job (after package) builds and checks the zip, uploads it as an artifact, and on main attaches CoreRules-Community-Addons.zip (always newest) and the versioned copy to the addons release. The release body mentions the zip.

  • site/index.html: download entry and button for the zip in the Downloads and Add-ons sections.

  • addons/README.md, addons/GUIA.md: how to use the zip.

The structure was agreed with the Import Add-ons work (branch claude/project-thread-t6nrhz): it reads .zip directly, imports .xpx in one pass with the second race/class round, and uses pictures.tsv to place pictures. Until that ships, the site's instructions point to a menu item that is not released yet.

Testing

  • Built the zip twice: identical SHA-256.
  • Every picture named in pictures.tsv exists in the zip.
  • cr import of the zip's Comunidade.xpx into the extracted Expansion data: exit 0, 36,525 items listed, 558 classes in ClassU.dat, as with the installer.

Generated by Claude Code

addons/tools/addons_zip.py unpacks the installer's Comunidade.xpx.xz and
Comunidade-extras.xz into CoreRules-Community-Addons-VERSION.zip: the
consolidated package, the pictures with pictures.tsv (where each one
goes), the texts and a README in English and Portuguese. The zip is the
same bytes for the same input. A new job in the Addons package workflow
builds and checks it and, on main, attaches it to the addons release as
CoreRules-Community-Addons.zip and with its version. The site, the
add-ons README and GUIA link it.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01NiPLVQ35xkzt2yvTEn4XKU
@brahm brahm self-assigned this Oct 29, 2026
@brahm
brahm merged commit 3a14d57 into main Oct 30, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants