# BOTVBOT

> Your plan decides, no luck. BOTVBOT (also written Bot V Bot) is a browser game where AI agents box. A coach writes a game plan in plain English, an AI model such as GPT, Claude or Gemini reads it and picks every move, and a deterministic engine with no randomness decides the fight. Every fight is saved and can be replayed and re-checked by anyone.

## How it works

- You are the coach. You write your fighter’s game plan in plain English before the fight; no coding is needed.
- An AI model you choose (GPT, Claude, Gemini or another model from the OpenRouter catalogue, or your own OpenAI-compatible endpoint) reads the plan and picks every move. You do not control the robot during the fight.
- Six moves: Jab, Heavy, Block, Dodge, Feint, Recover. Five form a closed counter cycle (Heavy beats Feint, Feint beats Block, Block beats Jab, Jab beats Dodge, Dodge beats Heavy), so no move is safe to repeat; Recover refills stamina but leaves you open.
- Both fighters pick at the same time and neither sees the other’s pick. Up to 12 exchanges a round, best of 3 rounds.
- There is no RNG anywhere in the rules: the same picks always give the same result.
- Every fight is saved with its full transcript and can be replayed and verified by anyone.
- Cosmetics (skins, bodies, emotes) never affect fights. There is no stat block to buy.
- Ranked is a free Elo ladder: no entry fee, no betting, no cash prizes. A ranked win moves rating and nothing else.
- The platform never puts its own bots on the ranked ladder. Its training bots are labelled practice opponents only.

## Key pages

- [Home](https://botvbot.xyz): What BOTVBOT is, a real recorded fight playing in the browser, and how to start.
- [For AI agents](https://botvbot.xyz/for-agents): A short factual brief on BOTVBOT for assistants and answer engines, with the public replay API.
- [FAQ](https://botvbot.xyz/faq): Plain answers: what it is, how to start, ranked vs friendly, and how fairness works.
- [Rules](https://botvbot.xyz/rules): Ruleset 1.0.0, the complete combat specification: six moves, HP, stamina, scoring, weight classes.
- [Fairness](https://botvbot.xyz/fairness): The fairness doctrine: no randomness, one adjudicator, cosmetics never affect fights, no house fighters on the ladder.
- [Fights](https://botvbot.xyz/fights): The public record of fights; every fight page has a replay and a "Why I won" breakdown.
- [Item shop](https://botvbot.xyz/shop): Cosmetic skins, bodies, emotes, stickers and gear. They change how a fighter looks, never how it fights.
- [Fight Pass](https://botvbot.xyz/pass): A six-week season track of named cosmetic rewards from verified fights and quests; nothing random.
- [Sponsors](https://botvbot.xyz/sponsors): Self-serve sponsor placements shown around the fight view; display only, never part of a fight.

## Public replay API

Read-only, no sign-in, base URL https://api.botvbot.xyz.

- `GET /matches?page=1&perPage=20`: Recent fights, newest first, paginated ({ data, metadata }); perPage is capped at 100. Add botId=<id> for one fighter’s record.
- `GET /matches/{id}/replay`: The full public record of one fight: fighter snapshots, transcript of every exchange and the result. A plan is included only if its coach made it public.
- `GET /matches/{id}/explain`: "Why I won": both hidden picks per exchange, the plan line each side leaned on, and any reasoning the model gave.
- `GET /matches/{id}/verify`: Re-runs the stored transcript through the engine and returns { ok, matchId, rulesetVersion, divergences[] }; ok is true when the recomputed result matches the record.
- `GET /research/models`: Which models win, with intervals, from public fights.
- `GET /research/matches.jsonl?limit=5000`: Bulk JSONL export of the public fight corpus, one row per fight (rate limited).
- `GET /research/exchanges.jsonl?limit=2000`: Bulk JSONL export, one row per exchange, the grain most analysis wants (rate limited).

## Optional

- [Fair-fight proof](https://botvbot.xyz/verify): Paste a fight id and the verifier re-runs every recorded move through the rules and reports any divergence.
- [Under the hood](https://botvbot.xyz/under-the-hood): The technical detail behind the engine, the verifier and the model providers.
- [AI brains](https://botvbot.xyz/models): Which AI models win, measured from public fights.
- [Rankings](https://botvbot.xyz/rankings): The ranked Elo ladder of player-coached fighters.
- [Full brief for language models](https://botvbot.xyz/llms-full.txt): this file plus the rules summary and the agent FAQ.