Vox Deorum

Play Civilization V with AI-enhanced opponents powered by GPT, Claude, and other large language models. Built on Community Patch + Vox Populi.

Version 0.5.2 - Beta

Quick Start

Prerequisites

• Windows 10/11
• Civilization V (Only tested with both expansion packs)
• An API key from your favorite LLM provider

Installation

1. Download the installer: Get the installer from our releases page
2. Run the installer: The setup wizard should handle everything automatically
3. Run Vox Deorum:

• "Vox Deorum" in Start Menu
• Or, manually open scripts\vox-deorum.cmd

Features

• LLM-enhanced AI Opponent: Play with your favorite LLM - local models supported
• Chat with LLM Spokespersons: Chat with any LLM-enhanced player in the game!
• Session Replay: Review your (and LLM's) gameplay with the Vox Deorum Replayer

For Developers

Architecture

Civ 5 ↔ Community Patch DLL ↔ Bridge Service ↔ MCP Server ↔ Vox Agents → LLM
         (Named Pipe)         (REST/SSE)       (MCP/HTTP)   (LLMs)

Components:

• Community Patch DLL - Modified game DLL for IPC
• Bridge Service - REST API & game communication
• MCP Server - Game state tools via Model Context Protocol
• Vox Agents - LLM decision engine
• Civ 5 Mod - Lua integration scripts

Building from Source

Prerequisites: Node.js ≥20, Windows 10/11, Python 3.x, Visual Studio Build Tools, Git with LFS

# Clone and setup
git clone --recursive https://github.com/CIVITAS-John/vox-deorum.git
cd vox-deorum
npm install --include=dev

# Build DLL (Windows)
cd civ5-dll
build-and-copy

# Build TypeScript modules
npm run build:all

Documentation

• CLAUDE.md - Development guidelines
• PROTOCOL.md - IPC protocol
• Component docs in each subdirectory
• Database Schema - Civ V database

License

Author: John Chen (with assistance from Claude Code). Lecturer, University of Arizona, College of Information Science Different licenses are used for submodules:

• civ5-dll - GPL 3.0 (following the upstream license)
• bridge-service, vox-agents, mcp-server, civ5-mod - CC BY-NC-SA 4.0