Learn the game.
Take the Belt.
How to build a colony, manage resources, move fleets, and capture asteroids in Belt Wars.
GET STARTED ↗Explore the manual ↓
UNLOCK BUILDINGS AND UPGRADES.
Choose a chapter.
Start with account setup, or go straight to the system you need help with.
Getting started
Choose a wallet, set up your game session, and build your first colony.
READ CHAPTER ↗CHAPTER 02 / FIELD GUIDE
Economy & buildings
Learn what each building produces, what it uses, and when to add storage or housing.
READ CHAPTER ↗CHAPTER 03 / FIELD GUIDE
Fleets & conquest
Load a fleet, compare combat stats, raid for resources, and capture asteroids.
READ CHAPTER ↗CHAPTER 04 / FIELD GUIDE
Troubleshooting
Find a missing colony, resolve a pending action, and recover unused session gas.
READ CHAPTER ↗CHAPTER 05 / FIELD GUIDE
Agents & automation
Addresses, table reads, the full action list, and the two ways a bot can sign: as its own player or as a delegate.
READ CHAPTER ↗What exists in the game today.
Live on the public Base mainnet World, counted from the game's own catalogs. If a feature is not listed here, it does not exist yet.
| Area | What is there | Where to read |
|---|---|---|
| Clients | Two: Original (pixel art) and Reimagined (3D), sharing one World and one colony per wallet | Choose your client |
| Sign-in | Email, Google, or an Ethereum wallet (MetaMask, Rabby, Phantom, any wallet your browser exposes, WalletConnect for mobile wallets) | Supported sign-in and wallets |
| Resources | 3 basic, 3 manufactured, 4 rare, plus electricity, housing, and fleet capacity as limits | Resources and limits |
| Buildings | 23 building types, from the Main Base and the three basic mines to the Wormhole Base | Building reference |
| Units | 7 combat units (Minuteman and Trident Marines, Lightning Craft, Anvil, Hammer, Aegis, and Stinger Drones) plus the Colony Ship | Training units |
| Objectives | 77, in 12 categories: Fundamentals, Resource Production, Unit Production, Unit Storage, Fleet, Defense, Combat, Conquest, Motherlode, Victory (Shard), Victory (Wormhole), Social | Objectives and rewards |
| Asteroids | Primary colonies, Common asteroids, Kimberlite, Iridium, Platinum, and Titanium motherlodes, Wormhole asteroids, and Volatile shards, in Micro, Small, Medium, and Large sizes | Travel and inspect |
| Fleets | Fleets with cargo, three stances (Follow, Defend, Block), raids, and capture with a Colony Ship | Fleets, combat, and conquest |
| Scoring | Player and alliance leaderboards for Shard, Wormhole, and Overall points; alliances can be created and joined in game | Points and special objectives |
| Market | In-game resource exchange at a quoted rate | Getting rare resources |
| Money | A one-time entry fee, a session gas deposit you control, and an optional name claim. No prize pool, no cash payouts, no automatic top-ups | Enter the game |
| Automation | The World contract, its 124 tables, and 87 Pri_11__ functions are the whole interface; a shared read-only indexer exists. No REST API or bot framework |
Agents and automation |
Not in the game today: in-game chat, trading between players other than the Market and raiding, a game API other than the chain itself, and any way to move ETH out of your wallet without a wallet prompt. If a feature is not on this list, assume it does not exist yet.
Storage full?
Make room to upgrade.
If an upgrade costs more than your storage can hold, build or upgrade a Storage Unit first. More mines cannot fix a storage limit.
UNDERSTAND YOUR ECONOMY ↗The game loop.
Mine resources, build your colony, then send units out to fight and capture asteroids.
Produce Iron, Copper, and Lithium.
Add factories, power, and storage.
Train units and transfer them to a fleet.
Choose a destination and wait for arrival.
Lower encryption and capture asteroids.
September 2026 edition. Includes useful explanations from the original Primodium docs, checked against this fork. Read the sources ↗