Galactic Chess

A 3-player hex-board strategy game with AI (Max-N and Paranoid search), wormholes, and a pygame UI.

Features

• 3-player hexagonal board
• Distinct piece types and faction colors
• Max-N and Paranoid AI search
• Wormhole mechanics
• Self-play learning mode
• Interactive UI

Requirements

• Python 3.10+ (tested with 3.11/3.12)
• pygame

Install pygame:

python -m pip install pygame

Run the Game

Run from the repo root:

python -m galactic_chess.main

CLI Modes

• Benchmark AI:

python -m galactic_chess.main --benchmark

• Self-play learning:

python -m galactic_chess.main --selfplay

• AI vs AI (no GUI):

python -m galactic_chess.main --nogui

Project Structure

ai/          # Search, heuristics, learning
controller.py
main.py

game/        # Core rules, state, movement
ui/          # pygame UI
utils/       # Constants

Notes

• Run commands from the parent folder so Python can resolve the package.