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
Section titled “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
Section titled “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
Section titled “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.
Use these calls here. Simulations preview the current state; each confirmed call is a separate transaction.
WORLD.Code(int256 Latitude, int256 Longitude, address Cause)Simulate / call
A callable deployment has not been resolved for this reference.
0xe250bf9729076B14A8399794B61C72d0F4AeFcd8CHAN.OptIn(address Contract, bool Allow)Simulate / call
Open this function to load its call form.
VITUS.Withdraw(uint256 Amount)Simulate / call
A callable deployment has not been resolved for this reference.
Rewards / costs
Section titled “Rewards / costs”- Cost: gas + whatever WORLD.Code() costs (nominal).
- Reward: ongoing VITUS tied to how much you’ve built.
Requirements & gating
Section titled “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
Section titled “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
Section titled “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.