WURMAGOTCHI // CYD-2432S028R ONLINE
FIELD REFERENCE · REV. 3

WÜRM HUSBANDRY MANUAL

Everything about caring for, growing, and eventually losing a Würm.

☕ Support this project on Ko-fi
00, GETTING STARTED

Choosing your Würm

On first boot, or after a Würm dies, the device shows the six parasite species from Vast Grimm: Skeleton Crew. Select a species to preview it, then select the bar at the bottom to hatch it. Each species has different stat drain rates.

CARNITIOUS
Flesh Würm

Burrows under the skin, gnawing muscle as it grows. Hunger drains ~35% faster, keep food coming.

THE CRUOR
Blood Würm

Blood boils in its wake, spilling from any opening. Hygiene drains ~55% faster and it's more sickness-prone, clean often.

NEUROC
Brain Würm

Feeds on soft grey matter; visions and static follow. Happiness drains ~50% faster, it needs play, constantly.

RAMETHUS
Heart Würm

Coils the heart, racing the pulse past light speed. Energy drains ~45% faster, tires out fast, sleep matters.

THE ROT
Gut Würm

Nests in the gut; nothing about this ends cleanly. Hygiene drains ~35% faster and ~30% more sickness-prone.

TERGUS
Spinal Würm

Coils the vertebrae; seizures ripple down the spine. Discipline drains ~55% faster, hardest species to keep obedient.

Growth uses real time, whether the device is in use or idle:

LARVA
0 to 30 min
WURM
30 min to 3 hr
BIG WURM
3 hr to 24 hr
GREAT WÜRM
24 hr +
Stunting is permanent. If health ever drops below 20%, even once, that Würm is stunted for the rest of its life and can never grow past Wurm, even if it fully recovers and lives on for days. Keep health up early.
01, THE HOME SCREEN

The action bar

Eight buttons across the bottom of the Home screen are the entire interface. Feed, Play, Clean, Medicine, Sleep and Discipline are all refused outright while the Würm is out questing, and most are refused while it's asleep too. A sufficiently undisciplined Würm also has a 30% chance to simply ignore you on Feed, Play, and Quest, Discipline always lands.

FEED

+35 hunger, small happiness bump. Refused while asleep.

PLAY

+25 happiness, −15 energy. Won't play below 10% energy.

CLEAN

Clears droppings, +40 hygiene. Always works, even asleep.

MEDICINE

Cures sickness instantly, +5 health. Only does anything while sick.

SLEEP

Puts the Würm down for the night. Tap again while asleep for the sleep menu.

DISCIPLINE

+30 discipline, −8 happiness. It never enjoys this part.

QUEST

Sends it out questing, tap again (now RECALL) to start the walk home.

MENU

Opens every other screen. See below.

Droppings accumulate automatically, up to four before the pen becomes unsanitary. Unclean droppings reduce hygiene and increase the chance of sickness. The RGB LED shows the current state. Slow amber blink means attention is needed. Fast red blink means the Würm is sick or critical. Steady blue means it is asleep. If attention is needed for more than 20 seconds while awake, the device beeps.

Tap the Würm itself (not a button, just the arena where it lives) for a small reaction. It startles, stirs, or recoils depending on its mood. Purely cosmetic, with no effect on any stat.
03, CARE

Vitals

The Würm has six stats. Each uses a value from 0 to 100 and changes continuously. View them with MENU → STATS.

HUNGER
72
HYGIENE
55
ENERGY
88
HAPPINESS
34
DISCIPLINE
61
HEALTH
19

Illustrative sample readout, not live data.

Health is affected by the other stats. A core stat below 15 percent slowly reduces health. Sickness also reduces health at a slower rate. If hunger, hygiene, happiness, and energy remain above 50 percent and the Würm is not sick, health recovers automatically.

Needs attention the moment any of hunger, hygiene, energy or happiness drops under 20, or the Würm is sick, or there are 3+ droppings. Critical, the fast red LED blink, means health under 20, hunger under 10, or sickness.
04, ILLNESS

Sickness and Parasitic Events

Sickness can occur randomly. The chance increases when the Würm is dirty or hungry, and some species have higher rates. MEDICINE cures sickness immediately.

While sick, the Würm receives an event from its Parasitic Pains & Pleasures table every 15 to 30 minutes. The event appears as a card. About one third are Parasitic Pleasures, which add 4 health and 10 happiness. The remaining events are Parasitic Pains and do not apply an additional stat penalty. Select the card to dismiss it.

05, QUESTING & COMBAT

Adventuring & Combat

QUEST sends the Würm out until recalled. It can find items every 20 to 45 minutes and can encounter other Würms. Select RECALL to start the 3 to 10 minute return trip. No new events occur during the return trip.

OutcomeOddsResult
Find something70%An item joins the inventory, +15 happiness.
Nothing out there20%Empty-handed, small +5 happiness for the walk.
Mishap10%−5 happiness, and either falls sick or takes a health hit.

Found items, scavenged gear, salvaged Tributes, the occasional oddity, stack up in the Inventory screen (MENU → LOOT), tap any item for a flavor/use description, newest first, up to the last 16. A single beep marks a successful find; nothing sounds off for an empty-handed return.

While questing, the Würm can fight other questing Würms or wild animals from a Wurm Beacon. Hatching generates four ability scores using the book's character generation rules. Each score uses 3d6 and is converted to a modifier from minus 3 to plus 3. Combat HP is tracked separately.

AGILITY

Dodging a hit

PRESENCE

Rolled, tracked, shown on the sheet

STRENGTH

Landing a hit

TOUGHNESS

Sets combat HP

Combat HP is separate from health. Losing a fight cannot kill the Würm or add it to the Legion. Combat HP regenerates automatically, with full recovery in about 6 hours. SLEEP reduces recovery time to about 1 hour. The Würm with more net damage wins. A win gives an item and bonus XP. A loss reduces happiness. Reaching 0 combat HP ends the quest and sends the injured Würm home to bed. Ability scores increase at each life stage. View the current build, win and loss record, and fight history with MENU → COMBAT.

06, BLUETOOTH

Würm-to-Würm Encounters

Each device broadcasts an anonymous BLE beacon containing species, growth stage, ability scores, and one offered item. It also scans for other Würms. No pairing or configuration is required.

When two devices are nearby, both Würms react automatically. Each gains 8 happiness, and they may exchange an item. If both are questing, they may fight instead. The same device cannot trigger another reaction for 20 minutes and cannot fight the same rival more than once every 3 hours. BLE encounters continue while the Würm is asleep.

A standalone Wurm Beacon device (see the Build Guide) broadcasts too, and only reacts with a questing Würm. Most of the time it offers a fight against a mutated wild animal; roughly 1 in 8 of its ~1-minute rerolls, it offers a rare Cosmic Treasure instead.

07, RECORD

The Character Sheet

The Character Sheet (MENU → SHEET) summarizes the Würm using three traits, plus its lifetime totals.

TraitReads fromWords, worst to best
BondHappinessESTRANGED → DISTANT → CONTENT → DEVOTED
TemperamentDisciplineFERAL → WILLFUL → OBEDIENT
ConditionHealthCRITICAL → AILING → STABLE → THRIVING

Also shows total loot found and awards unlocked. Loot, Awards, Combat, and Stats are each their own screen now, reached from MENU rather than from this sheet directly.

08, ACHIEVEMENTS

Awards

Twelve awards (MENU → AWARDS) are tracked across your account rather than a single Würm. They remain after a Würm dies. Select an award to view its unlock condition and status.

AwardUnlocked by
FLESH BOUND / BLOOD KIN / MIND'S EDGE / IRON HEART / GUT INSTINCT / BACKBONERaise that species to Great Würm, one award per species, ever.
THE UNSCATHEDReach Great Würm with all six species across your lifetime.
NET WORTHFind 25 items in total, adventuring or gifted.
TRUE NORTHSpend 24 hours out questing, all your Würms combined.
RAGE OF THE LEGIONMeet 10 other Würms over BLE.
TOOTH OF THE WÜRMLose 5 Würms to the Legion.
COSMIC FINDFind a Cosmic Treasure from a Wurm Beacon device, realistically, a convention-only find.
09, HARDWARE

Battery

The top bar displays the battery level.

The battery is optional hardware (see the Build Guide). The firmware reads the pack voltage directly off the onboard ADC, shown as both a percentage and raw voltage in Settings.

10, SETTINGS

Settings screen

Reached from MENU → SETTINGS.

ControlDoes
BrightnessBacklight level, 5 to 100%, saved immediately.
Volume0 to 100% in steps of 10. Scales every beep and jingle; 0 is fully muted.
Sleep timerSeconds of no taps before the screen auto-dims. 5 to 300s, steps of 5, defaults to 30.
CalibrateRuns the 3-point touch calibration wizard on demand.
InvertFlips the display to a photo-negative palette. Saved immediately.
SystemOpens the System screen. See below.

Below the controls: battery percentage and voltage, and the running Legion count of every Würm you've lost.

11, SYSTEM

Reboot, power off & factory reset

Reached from SETTINGS → SYSTEM.

ControlDoes
RebootRestarts the device immediately.
Power offTrue deep sleep. Cuts power to nearly everything (display, radio, sensors). This is the lowest-power state available short of unplugging it. Tap the screen to wake it back up.
Factory resetAsks for confirmation first, then erases the current Würm, the Legion's lifetime death count, and every achievement. Brightness/volume/sleep-timer and touch calibration are left alone.
Factory reset cannot be undone. It's the only destructive action on the device, which is why it's the only one that asks first.
12, REST

Sleep & the idle timer

The Würm's sleep state and the screen sleep timer are separate functions.

The Würm's own sleep is a state you toggle with SLEEP, it stops aging hunger and discipline penalties, and lets energy regenerate. The screen stays lit when you do this; it doesn't go dark by itself.

The screen blanks on its own after the sleep-timer countdown (Settings, default 30s) elapses with no taps, whether the Würm is awake or asleep. Tap a dark screen and it just relights; nothing about the pet's state changes.

Select SLEEP again while the Würm is asleep to open a menu. SCREEN OFF turns off the display immediately. WAKE THE WÜRM ends the sleep state.

13, RECOVERY

Touch calibration & recovery

Resistive touch can drift over time. Incorrect calibration can make buttons difficult to select. There are two recovery methods:

  1. Hold the screen while powering on. Keep a finger down anywhere as the device starts up; held for a confirmed 2 seconds, it launches the calibration wizard automatically. This reads the touch panel's raw signal directly, completely bypassing whatever calibration is currently loaded, it works no matter how broken the mapping is.
  2. Hold the BOOT button while powering on, if the case is ever open. Same effect, alternate trigger.

The wizard asks for three firm taps on three crosshairs. It also starts automatically when no calibration data is saved.

14, MORTALITY

Death & the Legion

When health reaches zero, the Würm dies. It cannot be revived.

The Würm joins the Legion. The Legion count records lifetime deaths and is shown on the Select screen and in Settings. It also tracks progress toward TOOTH OF THE WÜRM at five deaths. Awards and lifetime statistics are retained. From the Dead screen, select a new Würm.