Skip to content
Player's Guide

QI — Energy (Step 1 of 6)

One-line pitch: QI is your raw energy level — your SHIO holdings divided by an entropy factor. Step 1 of the power chain.

QI is the first stat in the soeng power progression:

QI → MAI → XIA → XIE → ZI → PANG

Each step builds on the previous one. QI is your base energy — pronounced “chi,” same sense as the East-Asian philosophical idea of life-force. It’s calculated as:

Your SHIO-token holdings ÷ your entropy

Higher SHIO holdings push QI up. Higher entropy (your personal randomness factor) tempers it. Two players with the same SHIOs but different entropies have different QI.

QI is measured in two flavors: one for players (ReactSoul) and one for venues (ReactWaat). Both feed forward into MAI.

  • Closest analogy: the base HP / MP / mana stat in an RPG — the foundation of your power profile.
  • Or: total value locked (TVL) for a protocol — how much resource you control.
  • Or: a weighted governance voting power based on staked supply.
Dysnomia term What it maps to
QI Base energy — SHIOs / entropy
ReactSoul QI computed against your Soul (your player side)
ReactWaat QI computed against a venue’s Waat (the venue side)
Entropy Your personal unpredictability factor
  • Hold SHIO — more SHIO = more QI.
  • Observe your entropy — evolves with each game action; low-entropy players have higher QI for the same SHIOs.
  • Preview QI — simulate ReactSoul(Soul) to inspect its output. It is a state-changing function; confirming a transaction persists its reaction.

Use these calls here. Simulations preview the current state; each confirmed call is a separate transaction.

QI0x4d9Ce396BE95dbc5F71808c38107eB7422FD9a03
QI.ReactSoul(uint64 Soul)Simulate / call

Open this function to load its call form.

  • Cost: none — QI is a derived value.
  • Reward: none directly. Higher QI means bigger payouts downstream.
  • None from QI itself. It just reads your state.

QI feeds into MAI (step 2), which combines it with your venue-token holdings into venue-specific power. QI reads your SHIO state (set up during signup via SHIOFactory) and your entropy (managed by CHO).

Q: Can my QI go to zero? A: Only if you hold zero SHIO. Even then, downstream math usually clamps it to non-zero.

Q: Is QI the same number every day? A: No — entropy evolves with your actions, so QI drifts. Think of it as slow-moving live data, not a static stat.

Q: Should I hoard SHIOs to max my QI? A: Up to a point. The full chain has diminishing returns and other inputs that often matter more than raw QI.

Q: Why divide by entropy? A: Entropy is the ecosystem’s anti-gaming factor — makes it harder to min-max by pumping one axis.


Want the Solidity? The contract reference lives at technical/docs/domain/soeng/QI.md.