rumble-bots is the reviewable, source-only catalog of bots eligible for ranked Tank Royale Rumble battles. Authors submit bots through pull requests; clients consume the generated bots/index.json catalog and run exactly the source tree named by its SHA-256 hash.
- Copy the bot template into
bots/<platform>/<BotName>/. - Include
<BotName>.json,<BotName>.sh,<BotName>.cmd, and source code that uses an official Tank Royale Bot API. - Declare one permitted SPDX license:
MIT,Apache-2.0,BSD-3-Clause, orGPL-3.0-or-later. - Run
python scripts/validate_bot.py --root . --owner <your-forge-account> --smokebefore opening a pull request.
Read CONTRIBUTING.md for the full submission, ownership, licensing, and moderation rules. The current validator proves the source-run entry point starts; connecting the smoke check to a temporary Tank Royale server is the next hardening increment before public ranked submissions open.
bots/index.json and bots/owners.json are generated by CI and must never be edited in a pull request. A catalog entry contains the bot identity, owner, source path, source-tree SHA-256, and active lifecycle status. Only active entries are eligible for matchmaking.
This repository is designed to be forkable: its validator is standard-library Python and GitHub Actions only invokes that script. The only forge seam is the workflow that supplies the pull-request author to the validator and publishes generated files after merge. Source-only catalog for ranked Tank Royale Rumble bots