CatanPy

A Python engine and AI for a settlement-building game modelled on Catan. The board is a hexagonal grid of resource tiles; players place outposts and towns on the nodes between tiles, collect resources on dice rolls, and spend them on buildings, roads, and growth cards (knight, road builder, victory point, year of plenty, monopoly).

Stack

• Pure Python 3, no external dependencies.

Run

python runner.py

Runs a full game loop. By default SettleGame.setup_game(auto=True) pits a human-style Player against the CatanBot AI; set auto=False for manual setup.

Structure

• game/ — board, tiles, nodes, ports, purchaseables, and the robber.
• players/ — base Player and the AIPlayer strategy.
• settlegame.py / runner.py — game state and the turn loop.

See IMPROVEMENTS.md for design notes.

License

MIT — see LICENSE.