English · Deutsch · Français · Español
This repository contains an unofficial multilingual rules collection for Collapsi, the abstract strategy game invented by Mark S. Ball of Riffle Shuffle & Roll.
The current release, Collapsi Revival Edition, documents both Mark S. Ball's updated Jack setup for the standard 2-player game and the earlier Joker setup. It also includes optional Revival Variations created by Johann Duscher (a.k.a. Jonny Dee); these continue to use the Joker setup and let collapsed cards return to play in several controlled ways. This project is independent and is not an official release by Mark S. Ball.
The downloadable original rulebook identifies itself as Collapsi v1.3.1, last updated July 9, 2025. It uses two Jacks as starting cards, and each Jack allows a one-space opening move. This unofficial release documents that updated setup alongside the earlier Joker setup, in which a Joker allows a choice of 1, 2, 3, or 4 spaces. The Revival Variations remain based on the Joker setup. Other explanations on the Riffle Shuffle & Roll YouTube channel may reflect different stages of the original game's development; this repository does not infer an official version number for them.
| Language | Markdown | |
|---|---|---|
| English | Read online | Download PDF |
| Deutsch | Online lesen | PDF herunterladen |
| Français | Lire en ligne | Télécharger le PDF |
| Español | Leer en línea | Descargar PDF |
The root README is English because GitHub displays README.md automatically. Every README and rulebook starts with a compact language switcher, so readers can reach their language in one click.
This rules collection uses its own semantic version and an edition name. The current release is Collapsi Revival Edition, version 1.0.1. Compatible patch releases retain their edition name; releases that add new variants receive a new name. Releases and Git tags use edition-vMAJOR.MINOR.PATCH, for example edition-v1.0.1. Follow the release checklist when publishing a version.
This number identifies only this unofficial rules collection. It is deliberately independent of unknown or changing versions of the original Collapsi rules and must not be presented as an official Collapsi version. Compatibility with a particular original rules release should be documented in release notes instead of encoded in the version number.
docs/<language>/rules.md Translated Markdown sources
output/pdf/ Generated PDFs
assets/fonts/ Vendored fonts for stable layout
scripts/build_pdfs.py One build for every language
.github/workflows/ Automated PDF verification
Language directories use short, lowercase, BCP 47-compatible tags such as en, de, fr, or pt-br. Only translated prose belongs below docs/<language>/. Fonts, build logic, licensing, contributor guidance, and workflows stay language-independent at the repository root.
The PDF pipeline uses ReportLab. It avoids a LaTeX installation and native HTML-rendering dependencies while supporting embedded fonts, controlled page breaks, page numbers, links, and PDF metadata.
uv sync --locked
uv run --locked python scripts/build_pdfs.pyPinned dependencies, one shared renderer, vendored Noto Sans fonts, fixed release metadata, and stable filenames make builds reproducible. The GitHub Actions workflow rebuilds every language and rejects stale committed PDFs; it also publishes the PDFs as a workflow artifact.
Johann Duscher's original text and Revival contributions are offered under CC BY-NC-SA 4.0. This permits reuse and adaptation, but not commercial use, and requires adaptations to use the same license. Please keep every distributed rules edition available free of charge. Collapsi itself and material attributable to Mark S. Ball remain subject to his rights and are not relicensed by this repository.
If you derive a variant from these Revival rules, retain credit to both Mark S. Ball and Johann Duscher. A variant that does not use or derive from the Revival rules does not require attribution to Johann Duscher. See LICENSE.md for the precise scope and CONTRIBUTORS.md for roles.
New translations are welcome. The checklist in CONTRIBUTING.md explains how to add a language without duplicating build configuration.