A collection of custom Magic: The Gathering tokens for Cockatrice, with an easy-to-use installer to automatically download, install, and update token artwork.
Go to file
Dandaedre bbf3a8ccfe
Cockatrice assets CI Checks passed and artifacts archived. Stable publication was skipped for this branch.
Gitea/cockatrice-custom-tokens/pipeline/head This commit looks good Details
Restore original Command Zone name for the default artwork
2026-11-10 17:02:58 +01:00
archives Refresh archived token XML with current assets artwork URL 2026-11-10 11:15:54 +01:00
assets/fonts Render TOML reminder text onto card templates and add trigger-order reminder 2026-11-10 12:09:38 +01:00
config/servatrice Document verified manual Servatrice 3.1.2 upgrade and rollback 2026-11-10 12:45:23 +01:00
docs Restore original Command Zone name for the default artwork 2026-11-10 17:02:58 +01:00
scripts Build and publish XML-only customsets.zip for manual installation 2026-11-10 16:59:06 +01:00
sets/TKR Restore original Command Zone name for the default artwork 2026-11-10 17:02:58 +01:00
tests Build and publish XML-only customsets.zip for manual installation 2026-11-10 16:59:06 +01:00
.gitignore Render TOML reminder text onto card templates and add trigger-order reminder 2026-11-10 12:09:38 +01:00
AGENTS.md Preserve sanitized Servatrice configs and document safe upgrade assessment 2026-11-10 12:32:52 +01:00
Jenkinsfile Add PowerShell installer with shared Windows installation safeguards 2026-11-10 13:42:29 +01:00
LICENSE Initial commit 2026-11-10 10:53:33 +01:00
README.md Build and publish XML-only customsets.zip for manual installation 2026-11-10 16:59:06 +01:00
deploy.ps1 Organize custom sets and add packaging and mock deployment 2026-11-10 11:10:10 +01:00
deploy.sh Organize custom sets and add packaging and mock deployment 2026-11-10 11:10:10 +01:00
install.ps1 Clarify installer data directory and verify missing customsets creation 2026-11-10 15:20:19 +01:00
requirements-build.lock Render TOML reminder text onto card templates and add trigger-order reminder 2026-11-10 12:09:38 +01:00
requirements-build.txt Render TOML reminder text onto card templates and add trigger-order reminder 2026-11-10 12:09:38 +01:00
requirements-tools.lock Add read-only colorful Cockatrice deck checklist 2026-11-10 12:37:38 +01:00
requirements-tools.txt Add read-only colorful Cockatrice deck checklist 2026-11-10 12:37:38 +01:00

README.md

Cockatrice custom sets and tokens

Custom Command Zone artwork and rules-reminder cards for Cockatrice. The project turns editable TOML descriptions and images into sets you can install and update with one command. It includes multiple artwork choices for the Command Zone token and automatically typeset rules reminders.

Re-run the installer whenever you want the latest published files. It skips unchanged files; scheduled background updates are not implemented.

Before installing

Install and launch Cockatrice once, then close it. Run the installer from an interactive terminal as your normal user, without sudo or Administrator access. You need Python 3.8+ and curl; the installer does not install Cockatrice or these dependencies for you.

It finds your Cockatrice data folder, prompts if multiple installations exist, and shows where it will install the XML and artwork. Downloads are validated before replacement, and existing affected files are backed up for rollback during the operation. If no installation is found, it aborts with instructions.

The commands below use the assets published by a successful Jenkins build of main. Restart Cockatrice after installation or an update.

Install or update on Linux/macOS

curl --fail --show-error --silent --proto '=https' https://assets.dandaedre.com/mtg/install.sh | sh

Follow the prompts to select and confirm the installation. For custom paths, forced reinstalls, recovery details, and a download-first command that also propagates download failures, see the advanced installation chapter.

Install or update on Windows

Use Windows PowerShell 5.1+ or PowerShell 7, with Python available as py.exe, python.exe, or python3.exe, and curl.exe installed:

$p = Join-Path $env:TEMP ([guid]::NewGuid().ToString() + '.ps1'); try { Invoke-WebRequest -UseBasicParsing 'https://assets.dandaedre.com/mtg/install.ps1' -OutFile $p -ErrorAction Stop; & $p } finally { if (Test-Path -LiteralPath $p) { Remove-Item -LiteralPath $p } }

Your PowerShell execution policy must allow the downloaded script to run; the installer does not change or bypass it. Windows execution still needs testing on a Windows machine. See the Windows installation chapter for custom paths, local execution, prerequisites, and limitations.

Manual installation

Download customsets.zip after CI publishes it. Close Cockatrice, back up your customsets/ folder, then extract the XML files directly into that folder, replacing matching files. Keep unrelated custom sets. Restart Cockatrice afterward.

The archive contains XML only; artwork uses online URLs. For offline artwork, use the installer. See manual replacement details.

Advanced documentation

Advanced concepts and maintenance covers creating sets, adding artwork and alternatives, rendering reminders, building packages, installer safeguards, Jenkins publication, deck checks, Commander Spellbook analysis, and Servatrice configuration backups.