Skip to main content

Creatures

Creatures are digital companions generated from the player's element choice and local environment. They grow through nurturing and evolve into more powerful forms.

Creature Cards​

Each creature has:

  • Name (player-chosen or generated)
  • Element (Water, Earth, Fire, Air)
  • Stage (Seed, Sprout, Bloom, Elder)
  • Traits (generated personality and physical features)
  • Signature move (unique ability text)
  • Stats (health, power, defense, speed)
  • Lore (short backstory)
  • Sprite/Model (2D image and/or 3D GLB)

Creature list with element badges

Creature Detail​

Tapping a creature opens a bottom sheet with two tabs:

Nurture Tab​

Shows creature hero image on a gradient background, element badge, health bar, growing stage, and a Nurture button.

Creature Nurture tab

Evolution Tab​

Shows the Evolve button (active when XP threshold is met), element badge, and an evolution grid showing current and future stages with level labels. Locked stages appear faded.

Creature Evolution tab

Nurturing​

Nurturing spends energy to increase creature XP and stats. The stat growth depends on element:

ElementPrimary Stat Boost
Water+defense
Earth+health
Fire+power
Air+speed

Cost: 2-3 energy per nurture action.

After nurturing, a celebration modal confirms the action:

Nurture celebration

Evolution​

Evolution is an explicit player action (never automatic). When a creature reaches the XP threshold for its current stage, the player can choose to evolve:

Stage TransitionXP Required
Seed -> Sprout100
Sprout -> Bloom300
Bloom -> Elder700

Evolution changes:

  • Stage label and visuals
  • Stat upgrades
  • Signature move (updated text)
  • Optional new "card frame"

See Evolution System for full details.

Filtering​

Creatures can be filtered by:

  • Element (Fire, Water, Earth, Air)
  • Health (healthy, fair, poor)
  • Evolution Level (1-5, 6-15, 16-33)

Creature filter sheet

Key Files​

  • src/views/Deck.tsx - Creature list and detail views
  • src/hooks/creatures/useNurture.ts - Nurture logic
  • src/hooks/creatures/useEvolve.ts - Evolution logic
  • src/machines/creatureCareMachine.ts - Nurture state machine
  • src/machines/creatureEvolveMachine.ts - Evolution state machine
  • src/modules/creature-generator/ - Generation pipeline