Skip to content

COREREACTIONSLIB — The Physics Engine

One-line pitch: This library runs the cryptographic "reactions" that happen whenever anything significant occurs in the game. It tracks BLACK/WHITE/HUE/BRIGHTNESS — color-metaphor entropy values that evolve with every action.

What this is

COREREACTIONSLIB (aka ReactionsLib) is the central entropy-processing library. Every time the game moves forward — a chat, a battle, a claim — reactions fire that:

  • Read current BLACK, WHITE, HYUN, SHUTTER, BRIGHTNESS, HUE values.
  • Mix in your action's specific data.
  • Produce new state values that affect downstream math.

The color names are a metaphor: BLACK is "unclaimed entropy," WHITE is "clarified state," BRIGHTNESS is "intensity of recent activity," HUE is the current flavor. None of this is visually rendered — they're just evocative names for abstract state.

If you've played a web3 game before

  • Closest analogy: a shared VRF-ish state machine — every action nudges the seed.
  • Or: a chaos-engine accumulator — all the noise from every player feeds into one big pool.
  • Or: the entropy module of a cryptographic protocol.
Dysnomia term What it maps to
COREREACTIONSLIB Reaction / entropy library
BLACK / WHITE Light/dark entropy axes
HUE Current flavor/color of state
BRIGHTNESS Intensity of recent activity
HYUN / SHUTTER Specialized lanes

What you actually do with it

  • Nothing directly. This library is called by CHO, VOID, and YI on your behalf.
  • Observe that all the "entropy" numbers sprinkled through the technical docs trace here.

Rewards / costs

  • Cost: none directly — its work is bundled into other calls.
  • Reward: none direct — but its outputs flavor your future rewards.

Requirements & gating

  • None for players.

Where it connects

Fed by VOID and CHO. Its outputs ripple into QI, XIE, and other stats.

Quick FAQ

Q: What's the difference between BLACK, WHITE, HUE, and BRIGHTNESS? A: They're separate entropy lanes. Some mix with some inputs, others with others. The split exists so different flavors of action (chat vs. battle vs. territory) don't all muddy the same pool.

Q: Why color names? A: Atropa-ecosystem aesthetic — cryptographic state visualized as a color field. Not rendered anywhere, just poetic.

Want the Solidity? The contract reference lives at technical/docs/lib/REACTIONS_CORE.md.