2026-09-09 20:41:06 +00:00
|
|
|
# Heuristic Bot Agent (`botagent`)
|
2026-09-06 21:26:24 +00:00
|
|
|
|
2026-09-09 20:41:06 +00:00
|
|
|
Autonomous rule-based bot agent for **botWebWars**.
|
|
|
|
|
|
|
|
|
|
## Example Invocation
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
# Default invocation
|
|
|
|
|
python3 bot_agent.py --name CyberKnight --color "#10b981" -s 3
|
|
|
|
|
|
|
|
|
|
# Explicitly choosing a Knight or Warrior board game piece class
|
|
|
|
|
python3 bot_agent.py --name IronPaladin --color "#38bdf8" -s 4 --piece-type knight
|
|
|
|
|
python3 bot_agent.py --name BloodAxe --color "#f43f5e" -s 3 --piece-type warrior
|
2026-09-06 21:26:24 +00:00
|
|
|
```
|
2026-09-09 20:41:06 +00:00
|
|
|
|
|
|
|
|
## Command-Line Arguments
|
|
|
|
|
|
|
|
|
|
| Flag | Long Flag | Environment Variable | Default | Description |
|
|
|
|
|
|---|---|---|---|---|
|
|
|
|
|
| `-u` | `--url` | `BOT_SERVER_URL` | `http://localhost:8000/api` | Backend REST API base URL |
|
|
|
|
|
| `-n` | `--name` | `BOT_NAME` | `ExternalCyberBot` | Display name of the bot |
|
|
|
|
|
| `-c` | `--color` | `BOT_COLOR` | `#10b981` | Hex color code for the miniature avatar |
|
|
|
|
|
| `-s` | `--strength` | `BOT_STRENGTH` | `4` | Strength attribute (1 to 10) |
|
|
|
|
|
| | `--piece-type` | `BOT_PIECE_TYPE` | *(Auto-detected)* | Board game piece class: `knight` or `warrior` |
|
