PostCivilWar
A persistent multiplayer simulation of Nigeria in which players build the country's
towns, businesses and institutions from undeveloped land. Its home will be
postcivilwar.com. Until the second week of October 2026 the working name was Nigeria
Life World; the folder and a few storage keys still carry it.
The architecture and its reasoning are in the Architecture Decision Document
(shared separately). Read that first.
What exists
| Path | What it is | State |
|---|
prototype/ | A browser-playable prototype of the first vertical slice: Atani, Anambra State, on the River Niger. A town of 1,000 people with homes, jobs and daily routines; a hospital, schools, a university, a polytechnic, a college and two churches to walk into; okada riders who carry passengers for a fare; speech in English, Pidgin, Igbo, Yoruba and Hausa; chat with players who are near; positional sound; health and fighting, witnesses, police who arrest on foot, fines and the return of stolen money, a hospital, a clinic and an ambulance, a phone that is taken out and held, with fifteen apps, a camera and music, vehicles that can be taken, players who cannot walk through each other, vehicles that knock people down and can kill a player, buttons that are pictures and change with what the player is doing, and ten camera views. It opens with the brand, the game's cover with PLAY on it, and one question (hero or villain); its interface is black and white and kept small, and people walk and run from the planted foot up. Under it: a land registry, permits, staged construction, shops, jobs, a keke to hire, buy and drive | Playable. 242 headless tests pass, plus scripted browser sessions with keyboard and with real touch input. Not the production client. Players who meet can see and talk to each other and block each other's way, but each page still runs its own copy of the world: there is no zone server yet, so nothing involving health, money or the law works between two devices (docs/multiplayer-audit.md). On the website an account is needed before play, and accounts, each account's TR, the market and seeing other players go through api/. |
api/, server/ | The website's server: one function on PostgreSQL. Accounts (a username and a password), each account's one character (chosen once; changed only by a paid upgrade) and saved game, each account's TR (a wallet at the server's bank, with the 2,000 TR of starter TR kept apart from TR that was earned; earned TR is sent from player to player by username, with a history that cannot be edited), the shared market (what is for sale, who owns what, the talk and the sale, paid through the bank), and where signed-in players are. server/ runs it on this machine and tests it | Working. 66 tests against a real PostgreSQL, and a scripted session of two players in real browsers. What a character earns and spends in town is still worked out in the player's browser and reported to the bank, which caps it (see prototype/README.md, "The bank"). |
services/ledger/ | Append-only double-entry ledger in PostgreSQL, and the bitcoin settlement data model beside it | Working at the database level. 85 contract tests pass. No network service in front of it yet. |
The brand's font, mark and the supplied cover are in prototype/assets/brand
with the notes that go with them. People in the prototype are built on one supplied character model, in
prototype/assets/characters with its notes. Every keke and coach is one of two
supplied vehicle models, in prototype/assets/vehicles with theirs. There is no Unreal Engine client, no zone server and no network service in this
repository. prototype/README.md lists which parts of the prototype are interfaces
standing in for those, and what replaces each.
Money
- Bitcoin is the only real-world asset. Bitcoin deposits and bitcoin withdrawals.
No naira, no other fiat, no other cryptocurrency.
- Everything here runs on test bitcoin. The ledger is created as a sandbox and
refuses an asset on the live Bitcoin network. That cannot be changed with an update;
it takes a reviewed migration.
- Gameplay uses a separate game currency, TR (2,000 TR are the £20 a newcomer
arrives with; until 10 October 2026 it was called the cowrie and its asset code
CWR).
It is not naira and does not represent legal tender.
- On the website TR is kept by the server (11 October 2026): one wallet per
account, 2,000 TR issued once when the account is made, and sent between registered
players by username. The page has no way to add funds: the "Add funds (sandbox)"
screen, which turned test bitcoin into TR inside the browser, has been removed.
Nothing on the site touches bitcoin, test or real.
services/ledger (below) is
unchanged and is not used by the site.
- The 2,000 TR an account arrives with is starter TR (11 October 2026): it pays
the town's charges and the cost of living, and nothing else. It cannot be sent to
another player and cannot buy anything to own (land, vehicles, building materials,
market goods, a character upgrade); those take TR that was earned. The server keeps
the two apart, the database refuses an entry that breaks the rule, and the page never
says which kind a payment is. Details: "Starter TR, one character, the upgrade" in
prototype/README.md.
- The game cannot reach bitcoin. Custody and settlement are a separate schema with
separate database roles. The gameplay role cannot read or write a bitcoin account.
- Game funds are not redeemable for bitcoin unless the settlement policy enables
it and a named officer authorises each request. The policy is off.
- No key material is stored anywhere in this repository or its schemas. There is
no Bitcoin node, wallet or signer yet; the chain is simulated in tests.
This is the beginning of the README. Read the rest at the original. Read the full README ↗
