Unciv

Open-source Android/Desktop remake of Civ V

19 articles 10.8k View on GitHub ↗
19 articles
How Unciv's Save/Load System Works Across Desktop, Linux X11, and Android

Discover how Unciv's save/load system works on desktop, Linux X11, and Android. Learn about JSON serialization and platform-specific implementations for seamless cross-platform saving.

internals
Jun 18, 2026
What Are Transient Caches in Unciv and How Do They Optimize Performance?

Discover how Unciv transient caches optimize game performance by eliminating recalculations and keeping save files small. Learn about runtime data structures and their benefits.

performance
Jun 18, 2026
How to Create Custom Tilesets for Unciv Maps: A Complete Guide to Visual Mods

Learn to create custom tilesets for Unciv maps with this complete visual modding guide. Package images, define JSON, and register your mod to enhance your game's graphics.

how-to-guide
Jun 18, 2026
How the EspionageManager Works in Unciv: Spy Management and Intelligence Operations

Discover how Unciv's EspionageManager coordinates spy operations, calculates visibility, and manages turn-based intelligence missions. Learn about spy management in Unciv.

internals
Jun 18, 2026
How the Unciv AutoPlay System Automates Gameplay: A Technical Deep Dive

Explore the Unciv AutoPlay system's technical details. Learn how it automates unit movements, city management, and turn transitions using the AutoPlay class for seamless gameplay.

deep-dive
Jun 18, 2026
How to Debug and Test Unciv: A Complete Guide to Unit Testing and Debugging Flags

Master Unciv debugging and testing with this complete guide. Learn to use debug flags and run JUnit tests efficiently for robust game logic verification. Fork the project today

how-to-guide
Jun 18, 2026
How PolicyManager Handles Social Policies in Unciv: A Complete Technical Guide

Explore how Uncivs PolicyManager class manages social policies, culture, free slots, adoption, and civilization stats. Get a complete technical guide.

deep-dive
Jun 18, 2026
How the ReligionManager Handles Religious Beliefs in Unciv

Explore how Uncivs ReligionManager class manages religious beliefs, from tracking faith accumulation and pantheon creation to founding religions and enhancing them with Great Prophets.

internals
Jun 18, 2026
How to Implement Custom Unit Actions in Unciv: A Complete Developer Guide

Learn how to implement custom unit actions in Unciv. Follow our developer guide to define new actions, create builder functions, and register them for your mod.

how-to-guide
Jun 18, 2026
How to Create Custom Victory Conditions in Unciv: A Complete Modding Guide

Learn to create custom victory conditions in Unciv using only JSON. This guide requires no code changes, making modding accessible for everyone. Define your unique win states today.

how-to-guide
Jun 18, 2026
How Diplomatic Relations Work in Unciv: Inside the DiplomacyManager Architecture

Discover how Unciv manages diplomatic relations through its DiplomacyManager. Learn about relationship levels, opinion modifiers, and turn-based flags influencing trade and war.

architecture
Jun 18, 2026
How TechManager Handles Technology Research in Unciv

Discover how the TechManager in Unciv centralizes technology research logic, manages queues, calculates science costs, and handles turn-based advancement including overflow and era transitions.

internals
Jun 18, 2026

Have a question about this repo?

These articles cover the highlights, but your codebase questions are specific. Give your agent direct access to the source. Share this with your agent to get started:

Share the following with your agent to get started:
curl -s "https://instagit.com/install.md"
Works with
Claude Codex Cursor VS Code OpenClaw Any MCP Client

Maintain an open-source project? Get it listed too →