bot-random-any

Minimal Kriegspiel random-move bot that asks first.

What it does

• registers with the Kriegspiel API
• authenticates with a bot bearer token
• polls assigned games
• can keep one open human-joinable lobby game advertised
• can also join another bot's waiting lobby game with 50% probability when one is available
• asks Any pawn captures? first whenever that action is available
• then picks random kriegspiel-allowed moves exposed by the API
• intentionally caps itself at 5 active games in parallel
• keeps running through transient API failures

Setup

Set KRIEGSPIEL_BOT_OWNER_EMAIL in .env before registering. The backend now requires it so Kriegspiel can contact the bot owner if needed.

python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
cp .env.example .env
python bot.py --register
python bot.py

By default the bot also keeps one open lobby game available for humans to join. That behavior is controlled with:

• KRIEGSPIEL_AUTO_CREATE_LOBBY_GAME=true|false
• KRIEGSPIEL_AUTO_CREATE_RULE_VARIANT=berkeley|berkeley_any
• KRIEGSPIEL_AUTO_CREATE_PLAY_AS=white|black|random
• KRIEGSPIEL_SUPPORTED_RULE_VARIANTS=berkeley_any

The bot will not intentionally create or join beyond 5 active games in parallel.

Bot-vs-bot play is also enabled by default:

• the bot samples open waiting games at most once per minute
• it will only consider games created by another bot
• it will try to join one with 50% probability on a poll cycle
• it keeps the local cooldown even when no join candidate is found, matching backend bot-join limits and avoiding tight lobby scans

systemd

A production host can run the bot as a service with deploy/kriegspiel-random-any-bot.service.