|
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
|
||
|---|---|---|
| archives | ||
| assets/fonts | ||
| config/servatrice | ||
| docs | ||
| scripts | ||
| sets/TKR | ||
| tests | ||
| .gitignore | ||
| AGENTS.md | ||
| Jenkinsfile | ||
| LICENSE | ||
| README.md | ||
| deploy.ps1 | ||
| deploy.sh | ||
| install.ps1 | ||
| requirements-build.lock | ||
| requirements-build.txt | ||
| requirements-tools.lock | ||
| requirements-tools.txt | ||
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.