A full-featured Civilization-style 4X strategy game with both terminal and local Web UI modes.

Build cities, research technologies, command armies, and negotiate diplomacy from a fast terminal UI. Prefer a browser? Run the built-in single-player Web UI locally and play the same core game through a character-map interface. No external game engine required.

Complete 4X Gameplay Loop -- Explore, Expand, Exploit, Exterminate in ~5,900 lines of Go.

• Procedural Maps -- Fractal noise terrain generation with continent-style layouts. 9 terrain types, 3 map sizes, fog of war, coordinate grid labels
• 8 Unit Types -- Settlers, Scouts, Warriors, Archers, Spearmen, Swordsmen, Horsemen, Workers -- each with unique stats
• City Building -- Found cities, manage population growth, construct buildings, queue production
• 11-Tech Tree -- Research technologies to unlock advanced units, buildings, and improvements
• Combat System -- Melee & ranged combat, terrain defense bonuses, experience & leveling, combat logs with civ names and coordinates
• Pathfinding & Goto -- Set movement destinations with Dijkstra pathfinding; units auto-advance each turn. Reachable tiles highlighted via BFS flood-fill
• Diplomacy -- Declare war, negotiate peace. Multiple AI civilizations with strategic decision-making
• 5 Civilizations -- Rome, Mongolia, Egypt, China, Greece -- each with historical city names
• Workers & Improvements -- Build farms, mines, roads, and lumber mills to boost your economy
• Bilingual (EN/ZH) -- Full English and Simplified Chinese support with automatic system language detection
• TUI + Local Web UI -- Play in the terminal by default, or start an embedded browser UI with -web
• Save/Load -- Full game state persistence via JSON with 10 save slots. Pick up where you left off
• Multiple Victory Conditions -- Domination, Science, or survive to turn 200

go install github.com/RockChinQ/civ-tui@latest
civ-tui

git clone https://github.com/RockChinQ/civ-tui.git
cd civ-tui
make run

The Web UI is a single-player local mode served by the same Go binary. It uses the shared game/ package, keeps one active game in the server process, and stores saves in the same ~/.civ-tui/saves/ directory as the TUI.

go run . -web
# then open http://127.0.0.1:8080

Use a different bind address if needed:

go run . -web -addr 127.0.0.1:9090

Prebuilt binaries for Linux, macOS, and Windows are available on the Releases page.

Requirements: Go 1.24+ (for building from source), a terminal with 256-color support.

Vim users rejoice -- hjkl navigation works everywhere.

The Web UI supports mouse and keyboard input:

Top bar buttons provide New, Save, Load, Build, Research, and End Turn actions. See Web UI docs for API details and current limitations.

Configure from the New Game screen before starting:

Language can be changed in the Settings menu (English / 简体中文). The game auto-detects your system language on first launch and saves the preference to ~/.civ-tui/config.json.

civ-tui/                 (~5,900 lines of Go)
├── main.go              # Entry point
├── i18n/                # Internationalization (EN / ZH)
├── game/                # Game logic (zero TUI dependencies)
│   ├── model/           #   Domain models (unit, city, civ, tech, tile)
│   └── worldmap/        #   Procedural map generation
├── tui/                 # Terminal UI (Bubble Tea)
└── web/                 # Local Web UI server, JSON API, embedded static assets

Game logic is fully decoupled from the UI layers -- the game/ package has zero TUI or Web UI imports, making it independently testable and reusable by both front ends.

• Go -- Simple, fast, compiles to a single binary
• Bubble Tea -- Elm Architecture for terminal apps
• Lipgloss -- Terminal styling and layout
• Go net/http + embedded static assets -- Single-binary local Web UI
• Vanilla HTML/CSS/JS -- Lightweight browser client without a frontend build step
• Custom fractal noise -- No external dependencies for map generation

make build    # Compile
make run      # Build and run
go run . -web # Run the local Web UI on 127.0.0.1:8080
make test     # Run tests
make lint     # Run go vet
make clean    # Clean build artifacts

All core gameplay phases are complete, and the local Web UI mode is available. Future directions include:

• Strategic & luxury resources
• Naval units
• Rivers & advanced terrain
• Culture, religion, and policy systems
• World wonders
• Trade routes
• TUI mouse support
• Battle animations
• Web UI parity improvements (diplomacy screen, help overlay, richer city management)
• More unit types and civilizations

GPL-3.0