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 (
quoteBedRestinsrc/lib/services/hometown/Lodging.ts, stamped asbedRestAt). 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);
chargedoubles 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.