Dysnomia — The Player's Guide¶

Welcome. If you've played a web3 game before or used an MMO, most of what follows will click quickly. If some term looks unfamiliar, check the Glossary — every in-world word is translated.

What is Dysnomia?¶

Dysnomia is an on-chain MMO that runs entirely on PulseChain. Your character, your inventory, your chatrooms, your territory, your currencies — everything lives as smart contracts. Nobody can shut down a server. Nobody can rug your account. Your wallet is your login, and your in-game actions settle on-chain.

Think of it as: MMO + chat platform + DeFi protocol, all sharing one persistent state.

The elevator pitch¶

You sign up by deploying a personal token called a LAU. That token is your character.
You start playing and a personal bank called a YUE gets set up for you.
You walk the MAP and find QINGs — venues, chatrooms, or marketplaces — each wrapped around a token.
You Join, Chat, and accumulate power.
You Claim land in the WORLD near venues you care about and earn VITUS (creator credits).
You fight WARs against other players to earn H2O (water tokens).
You Withdraw your earnings from your YUE to your wallet whenever you like.

That's the whole game in one paragraph. The rest of this guide fills in the details.

If you already know these, you already know Dysnomia¶

If you know…	Then Dysnomia's…
An ERC-20 token with transfers & allowances	Every Dysnomia asset behaves this way (LAU, YUE, QING, H2O, VITUS are all tokens).
A Uniswap v2 pool	A QING is kind of like that — a place holding value that other people interact with.
A Steam / Xbox profile	Your LAU plays the same role — display name, achievements, identity.
A Discord server with access rules	That's a QING with a cover charge and a guest list.
Minting an NFT to prove membership	"Entering Dysnomia" is minting your LAU.
Staking for rewards	Holding tokens at a venue (MAI) earns you chat rewards.
DAO voting weight	Yuan is your weighted token holdings — used as power in the game.
Land in The Sandbox / Decentraland	WORLD territory works similarly, but claimable via `Code()`.
Block hashes / state commits	Pole is a 3-slot commit of the game's global state.

The first 10 minutes as a new player¶

Sign up — LAUFactory.Enter() deploys a fresh LAU with your wallet as the owner.
Start playing — CHOA.Play() is your first real action. On the very first call it creates your YUE automatically.
Pick a venue — Browse the MAP. Every QING has coordinates. Walk in and Join (pay cover if there is one).
Chat — QING.Chat(myLAU, "hello world"). If you hold some of the venue's token you earn MAI on each message.
Claim territory — Stand on a spot you like and call WORLD.Code(). You've just become a landowner. Every claim earns VITUS into your YUE.
Pull your rewards — YUE holds your earnings. Call Withdraw to pull them to your external wallet whenever you want.

What can I own? What can I earn?¶

Own:

LAU — your player account token. Yours forever.
YUE — your in-game bank. Auto-created on first Play.
GWAT — optional: your own personal copy of a QING. You set the rules.
WORLD plots — territory around QINGs.

Earn:

H2O — water tokens, from winning WAR battles.
VITUS — creator credits, from claiming and holding territory.
MAI rewards — up to 1 venue-token per chat message, if you hold that venue's token.
Bonuses and distributions flowing out of CHEON based on your power score.

Core layout¶

                       ┌──────────────────┐
                       │   LAU Factory    │  ← sign up here (deploys your LAU)
                       └────────┬─────────┘
                                │
                  ┌─────────────▼──────────────┐
                  │           LAU              │  ← this IS you
                  │   (Soul, Aura, Username)   │
                  └─────────────┬──────────────┘
                                │ Play()
                  ┌─────────────▼──────────────┐
                  │   YUE  (your in-game bank) │
                  └─────────────┬──────────────┘
                                │ walks
                  ┌─────────────▼──────────────┐
                  │            MAP             │
                  └──┬───────────┬─────────┬───┘
                     │           │         │
                ┌────▼────┐  ┌───▼───┐  ┌──▼────┐
                │  QING   │  │ WORLD │  │ GWAT  │
                │ venues  │  │ land  │  │ your  │
                │         │  │       │  │ forks │
                └─────────┘  └───┬───┘  └───────┘
                                 │ fights happen here
                            ┌────▼─────┐
                            │   WAR    │───► H2O drops
                            └──────────┘

Safety and opt-in¶

Contracts can't touch your YUE unless you explicitly opt them in through CHAN. Think of it like a per-contract allowance list.
Your LAU is always owned by your wallet. onlyOwners protects every withdraw.
Your Soul is 64 bits — there are billions of possible IDs, randomly assigned. Souls are not reused or transferable.

Where to go next¶

New? Start with Your Player Account (LAU).
Want to browse venues? Read about the MAP, then QING.
Want rewards? See WAR + H2O, WORLD + VITUS, and the soeng power chain.
Curious about how it all hangs together under the hood? Read the Under the Hood section, starting with SHA.

A few things Dysnomia is NOT¶

Not a PvP arena game. WAR exists but battles are economic — winning means holding more power at a venue, not reflexes.
Not a play-to-earn pyramid. Rewards scale with real contributions (chat activity, held tokens, territory). There's no daily claim faucet.
Not custodial. Your wallet owns your LAU. Your LAU owns itself (via multi-owner). No intermediary can seize anything.
Not financial advice. Tokens are gameplay mechanics. Don't treat this guide as investment guidance.

Welcome in. Good luck out there.