How etrl-z/ciociariaguerrabot works
Ciociaria Guerra Bot simulates territorial conquest among Frosinone municipalities. The batch runner selects a municipality according to Short or Long mode, delegates each turn to the game engine, and repeats until a winner remains; the replay runner instead loads a saved extraction history and replays it. Conquest logic resolves attackers and targets, transfers ownership, and recalculates territorial centers. The engine renders turn and victory maps and uploads them to Firestore. The README also documents optional GIF creation, represented as a capability, though no caller is shown. Relationships are limited to excerpted calls and README statements.
Main entry points: GameEngine.cs Turn engine · MapRenderer.cs Map renderer · FirebaseClient.cs Firestore client · Program.cs Batch runner
Components 13
Game execution
- Batch runner
CiociariaGuerraBot.Batch/Program.cs - Replay runner
CiociariaGuerraBot.Replay/Program.cs - Turn engine
CiociariaGuerraBot.Core/GameEngine.cs
Conquest domain
- Conquest rules
CiociariaGuerraBot.Core/Utilities.cs - Municipality state
CiociariaGuerraBot.Core/Municipality.cs
Maps and media
- SVG map input
- Map renderer
CiociariaGuerraBot.Core/MapRenderer.cs - SVG-to-JPG conversion
CiociariaGuerraBot.Core/Utilities.cs - Optional GIF maker
CiociariaGuerraBot.Core/GifMaker.cs
Persistence and logging
- Firestore client
CiociariaGuerraBot.Core/FirebaseClient.cs - Firestore
- Run logger
CiociariaGuerraBot.Core/Logger.cs
Other components
- Operator
Connections 22
- Operator → Batch runner: starts game
- Operator → Replay runner: starts replay
- Batch runner → Map renderer: loads map
CiociariaGuerraBot.Batch/Program.cs - Batch runner → Conquest rules: finds active
CiociariaGuerraBot.Batch/Program.cs - Batch runner → Turn engine: plays turns
CiociariaGuerraBot.Batch/Program.cs - Replay runner → Map renderer: loads map
CiociariaGuerraBot.Replay/Program.cs - Replay runner → Firestore client: loads history
CiociariaGuerraBot.Replay/Program.cs - Replay runner → Turn engine: replays turns
CiociariaGuerraBot.Replay/Program.cs - Turn engine → Conquest rules: resolves conquest
CiociariaGuerraBot.Core/GameEngine.cs - Turn engine → Map renderer: renders turn
CiociariaGuerraBot.Core/GameEngine.cs - Turn engine → Firestore client: uploads image
CiociariaGuerraBot.Core/GameEngine.cs - Turn engine → Firestore client: records victory
CiociariaGuerraBot.Core/GameEngine.cs - Turn engine → Run logger: logs events
CiociariaGuerraBot.Core/GameEngine.cs - Conquest rules → Municipality state: updates ownership
CiociariaGuerraBot.Core/Utilities.cs - Conquest rules → Run logger: logs conquest
CiociariaGuerraBot.Core/Utilities.cs - Map renderer → SVG map input: loads SVG
CiociariaGuerraBot.Core/MapRenderer.cs - Map renderer → Municipality state: creates records
CiociariaGuerraBot.Core/MapRenderer.cs - Map renderer → SVG-to-JPG conversion: converts output
CiociariaGuerraBot.Core/MapRenderer.cs - Map renderer → Run logger: logs issues
CiociariaGuerraBot.Core/MapRenderer.cs - Firestore client → Firestore: reads and writes
README.md - Firestore client → Run logger: logs victory
CiociariaGuerraBot.Core/FirebaseClient.cs - Optional GIF maker → SVG-to-JPG conversion: converts frames
CiociariaGuerraBot.Core/GifMaker.cs