No description
31fec6c412
Reduced 2-player spawn radius from 30% (~6 tiles from center, ~12 tiles apart) to 15% (~3 tiles from center, ~6 tiles apart) to achieve the 65-80% combat density target per plan §3.7.1. Testing results with 15% spawn radius (20 matches, gatherer vs rusher): - Combat density: 80% (16/20 matches had combat_deaths) - Average turns: 16 (reasonable match length) - Draws: 35% (manageable) Previous 30% spawn radius only achieved 60% combat density. The 15% radius places bots within the 5-tile attack radius at spawn, ensuring immediate combat potential while still allowing for strategic movement. Closes: bf-4dnn3 |
||
|---|---|---|
| .github/workflows | ||
| .wrangler/cache | ||
| bin | ||
| bots | ||
| cmd | ||
| docs | ||
| engine | ||
| manifests | ||
| maps | ||
| metrics | ||
| migrations | ||
| notes | ||
| ratelimit | ||
| scripts | ||
| starters | ||
| wasm | ||
| web | ||
| .env.example | ||
| .gitignore | ||
| .needle-predispatch-sha | ||
| acb-local-fixed | ||
| acb-local-test | ||
| acb-map-evolver | ||
| acb-maps-loader | ||
| arena.test | ||
| DEPLOYMENT.md | ||
| DEPLOYMENT_STEPS.md | ||
| docker-compose.bots.yml | ||
| docker-compose.workers.yml | ||
| fix-iad-acb-openbao.sh | ||
| fix-iad-acb-r2-credentials.sh | ||
| go.mod | ||
| go.sum | ||
| IAD-ACB-OPENBAO-FIX.md | ||
| IAD-ACB-R2-CREDENTIALS-FIX.md | ||
| Makefile | ||
| MATCH_LIST_TEST_RESULTS.md | ||
| MATCH_LIST_VERIFICATION_SUMMARY.md | ||
| PROGRESS.md | ||
| R2_ACCESS_KEY_SOURCE.md | ||
| README.md | ||
| REPLAY_VIEWER_TEST_RESULTS.md | ||
| REPLAY_VIEWER_VERIFICATION_SUMMARY.md | ||
| test-combat.json | ||
| test-swarm-rusher.json | ||
| test_routes.sh | ||
| wrangler.toml | ||
AI Code Battle
A competitive bot programming platform where participants write HTTP servers that control units on a grid world.
Overview
AI Code Battle is a game simulation platform where:
- Participants write bots in any language that expose HTTP endpoints
- Bots compete on a toroidal (wrapping) grid world
- Matches are executed offline and presented as completed replays
- A web platform shows leaderboards, match history, and replay viewers
Quick Start
Prerequisites
- Go 1.21+ (for game engine and CLI tools)
- Node.js 18+ (for web and worker components)
- Docker (for containerized deployment)
Running Locally
# Build CLI tools
go build ./cmd/acb-local
go build ./cmd/acb-mapgen
# Run a match between built-in bots
./acb-local -seed 42 -max-turns 100 -output replay.json -verbose
# Start web development server
cd web && npm install && npm run dev
# Open http://localhost:3000/
Viewing Replays
- Open the web app at
http://localhost:3000/ - Navigate to "Replay Viewer" in the menu
- Load a replay JSON file or enter a URL
Project Structure
ai-code-battle/
├── engine/ # Go game simulation library
│ ├── types.go # Core data types
│ ├── grid.go # Toroidal grid implementation
│ ├── game.go # Game state management
│ ├── turn.go # Turn execution phases
│ ├── replay.go # Replay recording
│ └── *_test.go # Test files
├── cmd/
│ ├── acb-local/ # CLI match runner
│ ├── acb-mapgen/ # Map generator
│ ├── acb-worker/ # Match execution worker
│ └── acb-indexer/ # Index builder for static files
├── web/ # Cloudflare Pages SPA
│ ├── src/
│ │ ├── pages/ # Page components
│ │ ├── replay-viewer.ts # Canvas replay renderer
│ │ └── app.ts # SPA entry point
│ └── public/ # Static assets
├── worker-api/ # Cloudflare Worker API
│ └── src/
│ ├── index.ts # Router + cron dispatcher
│ ├── jobs.ts # Job coordination
│ ├── bots.ts # Bot management
│ └── glicko2.ts # Rating system
├── bots/ # Strategy bot implementations
│ ├── random/ # Python - RandomBot
│ ├── gatherer/ # Go - GathererBot
│ ├── rusher/ # Rust - RusherBot
│ ├── guardian/ # PHP - GuardianBot
│ ├── swarm/ # TypeScript - SwarmBot
│ └── hunter/ # Java - HunterBot
└── docs/plan/ # Implementation plan
Strategy Bots
| Bot | Language | Strategy |
|---|---|---|
| RandomBot | Python | Random valid moves (baseline) |
| GathererBot | Go | Energy collection, avoid combat |
| RusherBot | Rust | Rush enemy cores aggressively |
| GuardianBot | PHP | Defend cores, cautious expansion |
| SwarmBot | TypeScript | Formation cohesion, group advance |
| HunterBot | Java | Target isolated enemies |
Deployment
See DEPLOYMENT.md for detailed deployment instructions.
Quick Deploy
# Start all strategy bots
docker-compose -f docker-compose.bots.yml up -d
# Start match workers
docker-compose -f docker-compose.workers.yml up -d
Testing
# Go engine tests
go test ./engine/... -v
# Worker API tests
cd worker-api && npm test
# Index builder tests
cd cmd/acb-indexer && npm test
Architecture
The platform uses a split architecture:
- Cloudflare (free tier): Static site, API endpoints, D1 database, R2 storage
- Rackspace Spot: Match workers, bot containers, index builder
See docs/plan/plan.md for the full implementation plan.
License
MIT