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, active lifecycle status, and teamMembers. Individual bots publish an empty member list; a TwinDuel team publishes exactly two active <name> <version> member identities, so a member release always forces the team entry to be resubmitted. A team directory contains nothing but its own JSON, its members may live under different platform directories, and its published platform is the members' shared platform or Mixed. 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