Tank Royale Rumble bots

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.

Submit a bot

1. Choose a runnable bot template and follow its copy-and-rename instructions into bots/<platform>/<BotName>/.
2. Include <BotName>.json, <BotName>.sh, <BotName>.cmd, and source code that uses an official Tank Royale Bot API.
3. Declare one permitted SPDX license: MIT, Apache-2.0, BSD-3-Clause, or GPL-3.0-or-later.
4. Run python scripts/validate_bot.py --root . --owner <your-forge-account> --smoke before opening a pull request.

Read CONTRIBUTING.md for the full submission, ownership, licensing, and moderation rules. The template guide explains smoke markers, runtime prerequisites and executable bits. JSON-only TwinDuel teams use the team template. The validator's smoke check starts the source entry point; it does not establish a server connection or completed battle. Connecting the smoke check to a temporary Tank Royale server is the next hardening increment before public ranked submissions open.

Catalog

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. Pull-request validation runs bot smoke checks with read-only permissions; after merge, a trusted main publisher verifies the merged pull request passed validation and regenerates catalog data without launching bot code. See moderator governance for required Actions permissions and recovery. Source-only catalog for ranked Tank Royale Rumble bots