Equipment Mechanics - xopherdeep/do-it-for-the-xp GitHub Wiki

🎒 Unique Equipment & Mechanics

Items are in-game tools. They work in temples and in fights, nowhere else. They are earned in temple order, used from the two hands, and paid for in MP (5 to 25). Anything that bends a real chore or a house rule is a Power the Game Master prices: see docs/Items-And-Classes-Contract.md.

The table below is the source of truth in code: src/lib/services/items/ItemRules.ts (per item name: mp, temple, fight, consumes, the two lines a card shows). The fight and the temple read it by name; a profile's stored desc is never read for a rule, so an old copy of the Ice Wand ("50MP | ...") costs what the table says.

Rule zero: no tool completes a chore. A temple use opens the way, a fight use buys time or blunts the beast. The chore is still done in the real world.

🏹 Tools

MP is the list price. The hero's class discount (Mage 25%, Sage 50%) and trained intelligence come off it. A tool with a dash has no use there; its card says where it works. Holding one is allowed.

Item Icon MP Earned In a temple In a fight
Lantern flashlight 5 From the start Shows this temple's map and compass —
Bottles flask-potion 0 From the start Bottles a spring: at an unused health or mana spring, keeps it as Spring Water (+10 HP) or Silver Water (+10 MP) in the pack Opens the potions sheet
Bombs bomb a Bomb From the start; the Bombs it spends are sold only in temple shops (20 GP; crafting comes later) Blows open a cracked (bombable) wall on both rooms when a room lies beyond it; "Nothing to blow up here." otherwise, and the Bomb is kept (never a locked door, never a fight's seal, never the boss door) stun: the beast misses its next strike
Gaia's Quake wave-sine 10 Earth Temple chest (Gaia's Hammer) Hidden rooms on this floor appear on the map (the temple's map comes first) —
Hook Shot expand-alt 5 Water Temple chest (Trident of Tides) Swings over a pit or void to the room beyond —
X's Invisibility hat-wizard 15 Shadow Temple chest (Void Dagger) Slips out of a free-fight monster room without its fight; a quest room cannot be skipped vanish: run away with no parting strike
Fire Wand wand-magic fire 10 Fire Temple chest (Flame Shield) — kindle: chores earn 1.5x the minutes
Thor's Hammer hammer-war 15 Free Ignis (Fire Temple) — stun: the beast misses its next strike
Silver Arrow bow-arrow 25 Light Temple chest (Dawnbreaker Bow) — pin: the beast misses its next two strikes
Sol's Flare flame 20 Free Sol (Light Temple's world) — weaken: halves the beast's attack
Ice Wand wand-magic ice 10 Ice Temple chest (Frost Wand) Freezes a trap: the traps next to you do not bite this visit frost: +10 minutes on the clock
Tesla's Bolt bolt 5 Storm Temple chest (Lightning Rod) — charge: chores give back double MP
Gale's Wind wind 15 Free Ventus (Storm Temple) — gust: the clock refills to full
Night's Light moon-stars 10 Moon Temple chest (Lunar Pendant) Moonlight on the glyphs: one wrong answer of the riddle fades moonlight: each chore heals 5% of max HP
Chronos' Clock flux-capacitor 20 Free Umbra (Moon Temple) — time-stop: pauses the clock for 15 minutes

The Light Temple is the Sun Temple of Sol's world (the desert); the Shadow Temple is the swamp's. Free a Pegasus and its gift unlocks; open a chest and the relic unlocks the tool beside it. The locks are ALWAYS_UNLOCKED, PEGASUS_INDEX, CHEST_ALIASES and CHEST_TEMPLE in src/lib/services/quests/ItemEffects.ts; a profile without an unlockedItems list predates the locks and keeps everything, and the Game Master can unlock any tool for a hero from the Compendium.

The fight effects

Eleven effects live in src/lib/services/battle/BattleEffects.ts. Every one is once per fight, counted per effect whatever cast it: Bombs and Thor's Hammer share stun, Chronos' Clock and the Stop Power share time-stop. heal (25% of max HP) is for Powers only. The full table is section H of docs/Battle-Field-Contract-v2.md.

The temple uses

Each use, its refusals and its sounds are TEMPLE_USES in src/lib/services/temples/ItemUse.ts; the summary is in docs/Temple-Interactions-Contract.md.

🎒 Storage & Navigation

These are not tools: they have no MP price and no fight use.

Item Icon MP Earned What it does
Bottles flask-potion 0 From the start The potion tool above; the Potions tab of My Goods holds the potions themselves
Pegasus Boots boot 0 Free Aura (Wind Temple) Toggles the Retro / Modern Area menu style
Wind Whistle whistle 0 Wind Temple chest Opens the Pegasus map for fast travel
My Quests, Book Of Spells, Goods, Wallet 0 From the start Open their page; in a fight Goods and the Book Of Spells open the potions and the Powers
Portal Home portal-enter 0 From the start Returns home from anywhere (router push to my-home)

🔋 Where the MP comes from

  • The bed at home: all HP and MP, free, once per local day (quoteBedRest in src/lib/services/hometown/Lodging.ts, stamped as bedRestAt). A second night the same day: "You're not sleepy yet. Come back tomorrow."
  • The Hotel: all HP and MP for 10 GP plus 5 GP per hero level (roomCost(level)).
  • Quest fights: each chore finished in a fight that holds a quest gives back 10% of max MP (at least 1); charge doubles it. Free fights give nothing (src/lib/services/battle/choreGains.ts).
  • Mana Potions, Ether, Silver Water, mana springs, camps and the class win regen are unchanged.

📜 Not items

The things the old tools did to real chores are Powers now (Snooze, Extra Time, Quiet Day, Trusted Hour): see section B of docs/Items-And-Classes-Contract.md. Tapping a tool on the portal (outside a temple or a fight) shows its card: its MP, its temple use and its fight use. The only item that touches the quest board is the Lantern: there it lists the hero's overdue quests, free, and it only reads.