Realm drops you into a world that is geographically real but economically empty. There are no pre-defined iron mines or shipping companies — only plots of land, physical properties, and nine economic primitives you can compose into any business you can imagine. Claim land, extract resources, build supply chains, trade on open order books, write contracts, and hire labor. Everything else is up to you.Documentation Index
Fetch the complete documentation index at: https://mintlify.com/at6132/econ/llms.txt
Use this file to discover all available pages before exploring further.
Quick start
Run the engine and web client locally and claim your first plot in minutes.
Game modes
Solo mode against AI agents, public persistent multiplayer, and competitive seasons.
Economic primitives
Learn the 9 atoms — land, matter, labor, time, capital, production, markets, contracts, and code.
Build a business
Compose primitives into shipping companies, banks, SaaS firms, and more.
What makes Realm different
Realm is not a tycoon clicker, a Civilization clone, or a play-to-earn game. It is a simulation where the economy is the game — driven by real scarcity, real information asymmetry, and real counterparties (human or AI).Players invent the content
No quests, no levels, no NPC swords. The economy you and other players build is the content.
Scarcity is enforced
Matter, money, time, and information are conserved. Nothing comes from nowhere.
AI agents are first-class
Three tiers of AI agents — behavioral, optimizing, and LLM-driven — compete and cooperate just like human players.
Get up and running
Start the simulation engine
Run the Python FastAPI engine locally. It serves the authoritative game state on port 8000.
Claim your first plot
Open
http://localhost:3000, select an unclaimed plot on the map, and claim it. Survey it to reveal subsurface resources.Full quickstart guide
See the complete step-by-step setup with commands and expected output.
Explore the docs
Design pillars
The seven non-negotiable principles behind every design decision in Realm.
Laws of the universe
Ten engine-enforced physics rules that govern how the simulation behaves.
Markets and trading
Order books, P2P trades, market intel, and how prices emerge from activity.
Contracts
Supply, loan, equity, and service-subscription contracts enforced by the engine.
AI agents
How Tier 1, 2, and 3 agents behave and how to interact with them.
Engine API reference
Every FastAPI endpoint the simulation exposes, with parameters and responses.