VITUS — Creator Credits¶
One-line pitch: VITUS is what you earn for building the world — claiming and coding territory near venues, not for fighting over it.
What this is¶
VITUS is an ERC-20 you earn when you develop territory through WORLD.Code() — that is, when you stake a position near a QING or GWAT and register meaningful presence there. Where H2O rewards PvP (battle), VITUS rewards PvE (building).
Earnings accumulate in your YUE bank by default. To pull them into your regular wallet, call Withdraw(Amount) — but only after opting in to VITUS via CHAN.
Like H2O, VITUS has an overflow-protection mechanism so giant creator balances don't just snowball unchecked.
If you've played a web3 game before¶
- Closest analogy: creator royalties — you earn passively for content you've produced and parked in the world.
- Or: LP fees — your presence at a location generates a fee stream over time.
- Or: a developer grant token paid out as you ship code.
| Dysnomia term | What it maps to |
|---|---|
| VITUS | Creator-reward ERC-20 |
| Code() | The action in WORLD that earns VITUS |
| Withdraw() | Pull VITUS from YUE bank to your wallet |
| CHAN opt-in | You must flip the VITUS opt-in flag before you can withdraw |
| Overflow | Same mechanism as H2O — excess spills |
What you actually do with it¶
- Code territory — call WORLD.Code() at a position near a venue.
- Opt in via CHAN — flip your VITUS opt-in so withdrawals work.
- Withdraw when ready —
Withdraw(Amount)moves VITUS from YUE to your wallet. - Hold or trade — once in your wallet, it's a plain ERC-20.
Rewards / costs¶
- Cost: gas + whatever WORLD.Code() costs (nominal).
- Reward: ongoing VITUS tied to how much you've built.
Requirements & gating¶
- You need a LAU to have a YUE account for the balance to land in.
- You need to opt in via CHAN before withdrawal works.
- Your Code() action must be validly placed on the MAP.
Where it connects¶
Earned through WORLD.Code(). Stored in YUE. Opt-in controlled by CHAN. Lives alongside H2O as one of the two main "earned" currencies.
Quick FAQ¶
Q: Why does VITUS go to YUE instead of my wallet? A: YUE is the default sink for earned game currencies — it gives the game a single point to apply overflow/anti-spam logic. Withdraw moves it to your hot wallet.
Q: Do I need to withdraw, or can I leave it in YUE forever? A: Leave it — YUE balance counts as yours. Withdraw is only if you want to trade it externally.
Q: What if I forget to opt in via CHAN first?
A: You'll still earn VITUS — it lands in YUE — but Withdraw will fail until you flip the flag.
Q: Is VITUS the same as H2O? A: No. H2O is from WAR (battles). VITUS is from WORLD.Code() (building). Different verbs, different tokens.
Want the Solidity? The contract reference lives at
technical/docs/domain/assets/VITUS.md.