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

🎒 Unique Equipment & Mechanics

This document outlines the special equipment, items, and abilities available to the Player (Bounty Hunter). These items provide unique ways to interact with tasks (Enemies) and manage the player's workflow.

🏹 Combat & Utility Items

These items are used primarily to manage tasks (Enemies) in the "Battle" view.

Item Icon MP Cost Cooldown Effect Mechanic Implementation
Silver Arrow bow-arrow 25 MP None Instantly removes one task from your battle queue. Deletes a task or marks it as "skipped/bypassed" (requires logic to handle rewards/penalties, likely no XP/GP).
Hook Shot expand-alt 15 MP None Moves a future task to the current day. Fetches a task from a future date (e.g., tomorrow) and adds it to today's "Battle Queue".
Bombs bomb 40 MP None Breaks down one large task into three smaller pieces. Splits a "Hard" difficulty task into 3 "Easy" tasks. Requires "Sub-task" system or simply replacing 1 task with 3 new ones.
Thor's Hammer hammer-war 60 MP None Completes 50% of any single task. Mark a task as 50% progress? Or damage it? Since tasks are binary (done/not done), this might mean "Reduces effort/duration" or deals HP damage to a Boss Task.
Lantern flashlight 5 MP None Reveal hidden tasks (forgotten/overdue). Queries the database for tasks with status: overdue or hidden and adds them to the view.
Fire Wand wand-magic fire 50 MP None Reduces time needed for quick tasks by 50%. If tasks have a "duration" field, reduce it by half.
Ice Wand wand-magic ice 50 MP None Extends task deadlines by 24 hours. Modifies due_date of a selected task +1 day.

🌟 Ultimate Abilities (High Cost/Cooldown)

Powerful items with significant cooldowns.

Item Icon MP Cost Cooldown Effect Mechanic Implementation
Sol's Flare flame 100 MP None All tasks take 100HP damage. Useful for "Boss Battles" or tasks with HP. For standard tasks, might auto-complete "Easy" tasks (assuming they have <100HP).
Tesla's Bolt bolt 100 MP 2 Hours Instant task completion. Instantly marks a selected task as Complete (Awarding full XP/GP).
Gaia's Quake wave-sine 100 MP 24 Hours Randomly reorders all tasks. Shuffles the sort order of the current task list. "Fresh perspective".
Chronos' Clock flux-capacitor 100 MP 1 Hour Pause all task timers for 1 hour. Pauses any active "Transformation" or "Due Date" countdowns.
Night's Light moon-stars 100 MP 3 Days Remove bedtime restrictions for one night. Disables "Sleep Mode" or "Late Night" penalties for the current calendar day.
Gale's Wind wind 300 MP 7 Days Blows away all "Chore" type tasks for 24h. Bulk "Skip" for tasks tagged category: chore for today.
X's Invisibility hat-wizard 300 MP 2 Days Avoid random task encounters for 24h. Prevents "Random Encounters" or "Pop-up Tasks" if that system exists.

🎒 Storage & Navigation

Item Icon MP Cost Cooldown Effect Mechanic Implementation
Bottles flask-potion - - Store Potions/Ethers. Inventory slots for consumable recovery items (Health Potion: +50HP, Ether: +30MP).
Portal Home portal-enter 10 MP 15 Min Return to Home immediately. Router push to my-home. Already implemented.