From f59be77e50b520ac4179952d418d7789ded5b9fb Mon Sep 17 00:00:00 2001 From: Refactoring Agent <[email protected]> Date: Sun, 26 Apr 2026 21:41:45 +0200 Subject: [PATCH] Docs: Update GAME_BRIEFING.md after Task 2 completion --- docs/GAME_BRIEFING.md | 98 +++++++++++++++++++++++++++++++++++++++---- 1 file changed, 90 insertions(+), 8 deletions(-) diff --git a/docs/GAME_BRIEFING.md b/docs/GAME_BRIEFING.md index 6e2d30f..2ff4808 100644 --- a/docs/GAME_BRIEFING.md +++ b/docs/GAME_BRIEFING.md @@ -1,7 +1,8 @@ # Mana-Loop: Comprehensive Game Briefing Document -**Document Version:** 1.0 +**Document Version:** 1.1 **Generated:** Game Systems Analysis +**Updated:** After Task 2 Completion --- @@ -67,15 +68,28 @@ | Action | Effect | Time Cost | |--------|--------|-----------| -| **Meditate** | Regen mana with meditation bonus multiplier | Passive | +| **Meditate** | Regen mana with meditation bonus multiplier | Passive (auto-selected after actions) | | **Climb** | Progress through spire floors, cast spells | Active combat | | **Study** | Learn skills/spells, requires mana cost | Hours per level | | **Craft** | Create/enchant equipment | Hours per stage | | **Convert** | Auto-convert raw mana to elements | Per tick | -| **Design** | Create enchantment designs | Hours | -| **Prepare** | Ready equipment for enchanting | Hours + mana | +| **Design** | Create enchantment designs (limited to owned gear types) | Hours | +| **Prepare** | Ready equipment for enchanting (disabled for non-enchanted items) | Hours + mana | | **Enchant** | Apply enchantment to equipment | Hours + mana | +### ActionButtons Rework (Task 2) + +**Changes Made:** +- **Manual action selection removed**: Players can no longer manually select actions from a list +- **Auto-transition to Meditate**: After completing Design, Prepare, Enchant, or Craft actions, the game automatically transitions to **Meditate** state +- **Simplified UI**: The ActionButtons component now displays only the current action with a progress indicator +- **Spire Mode integration**: Action buttons are hidden when in Spire Mode (climbing simplified UI) + +**Implementation:** +- `currentAction` state tracks the active action +- Crafting slice sets `currentAction: 'meditate'` when actions complete +- `ACTION_CONFIG` maps actions to display configs (label, icon, color) + --- ## Mana System @@ -86,10 +100,11 @@ Raw Mana (Base Resource) │ ├──▶ Base Elements (7) ─────────────────────────────────────┐ - │ Fire, Water, Air, Earth, Light, Dark, Death │ + │ Fire*, Water*, Air*, Earth*, Light, Dark, Death │ + │ *Locked at start - must be unlocked │ │ │ ├──▶ Utility Element (1) ───────────────────────────────────┤ - │ Transference (Enchanter attunement) │ + │ Transference (Enchanter attunement - UNLOCKED at start) │ │ │ ├──▶ Compound Elements (3) ── Created from 2 base ──────────┤ │ Metal = Fire + Earth │ @@ -102,6 +117,8 @@ Raw Mana (Base Resource) Void = Dark + Dark + Death │ ``` +**Note:** Fire, Water, Air, and Earth elements are **locked at start**. Only Transference is unlocked initially. Players must unlock the base elements through gameplay (element unlocking system). + ### Mana Formulas **Maximum Raw Mana:** @@ -132,6 +149,19 @@ With Void Meditation skill: 5.0x after 8 hours - Enchanter: Raw → Transference at 0.2/hour base (scales with level) - Fabricator: Raw → Earth at 0.25/hour base (scales with level) +### Starting Elements + +| Element | Unlocked at Start | +|---------|-------------------| +| Transference | ✅ Yes | +| Fire | ❌ No | +| Water | ❌ No | +| Air | ❌ No | +| Earth | ❌ No | +| Light | ❌ No | +| Dark | ❌ No | +| Death | ❌ No | + ### Mana Conversion Cost - **100 Raw Mana = 1 Elemental Mana** (for base elements) - Compound/Exotic elements are crafted, not converted @@ -315,6 +345,25 @@ aoeDamage = baseDamage × (1 - 0.1 × (numTargets - 1)) ## Guardian & Pact System +### Spire Mode (Task 2) + +**New Feature:** A simplified UI mode for climbing the spire. + +**How it works:** +- Click **"Climb the Spire"** button (available when not already in Spire Mode) +- Enters simplified UI showing only essential spire info +- Hides ActionButtons and other tabs +- Focuses on combat progression +- Exit condition: Automatically exits when player chooses to stop climbing + +**Implementation:** +- `spireMode` boolean state in game store +- `enterSpireMode()` and `exitSpireMode()` actions +- `simpleMode` prop passed to SpireTab for simplified rendering +- UI conditionally renders based on `store.spireMode` + +--- + ### Guardian Floors & Stats | Floor | Guardian | Element | HP | Pact Mult | Armor | Unique Perk | @@ -630,8 +679,8 @@ Hybrid Skills are advanced skills that require two attunements and combine their ### Equipment Slots ``` -mainHand - Staves, Wands, Swords -offHand - Shields, Catalysts +mainHand - Staves (2H), Wands, Swords +offHand - Shields, Catalysts (blocked by 2-handed weapons) head - Hoods, Hats, Helms body - Robes, Armor hands - Gloves, Gauntlets @@ -640,6 +689,21 @@ accessory1 - Rings, Amulets accessory2 - Rings, Amulets ``` +### Two-Handed Weapons + +**Supported:** The game now supports **2-Handed Weapons** (e.g., Staves). + +**Mechanics:** +- 2-handed weapons occupy both the `mainHand` and `offHand` slots +- When a 2-handed weapon is equipped in `mainHand`, the `offHand` slot is **blocked** +- 2-handed weapons cannot be equipped to the `offHand` slot +- The UI displays a "2-Handed" badge on applicable items and shows "Blocked by 2-handed weapon" for blocked slots + +**Implementation:** +- Equipment types have a `twoHanded: true` property +- `equipItem()` validates 2-handed weapon constraints +- `isSlotBlocked()` function checks if offhand is blocked by main hand 2H weapon + ### Equipment Categories | Category | Slots | Description | @@ -671,6 +735,7 @@ interface EquipmentInstance { #### Stage 1: Design - Create enchantment design - Select effects from unlocked pool +- **Limited to owned gear types** (cannot design for equipment you don't have) - Calculate capacity cost - Time: Base 1h + 0.5h per effect stack @@ -681,14 +746,17 @@ totalCost = Σ(effect.baseCost × (1 + 0.2 × stackIndex) × (1 - efficiencyBonu #### Stage 2: Prepare - Prepare equipment for enchanting +- **Disabled for non-enchanted items** - Mana cost: capacity × 10 - Time: 2h + 1h per 50 capacity +- **Auto-transitions to Meditate** when complete #### Stage 3: Apply - Apply enchantment design - Mana per hour: 20 + 5 per effect stack - Time: 2h + 1h per effect stack - Grants Enchanter XP: 1 XP per 10 capacity +- **Auto-transitions to Meditate** when complete ### Enchantment Effect Categories @@ -1001,6 +1069,17 @@ dps = (damage × castSpeed × attackSpeedMultiplier) / hour ## Appendix: Known Issues +### Task 2 Updates (Completed) + +The following issues/enhancements were completed in Task 2: + +1. **Combat UI Casting Bar** - Fixed progress animation +2. **Mana Well Bug** - Fixed Deep Basin perk (+20% Max Mana, was incorrectly 0.20 instead of 1.20) +3. **LootTab** - Removed Transference from essence list (it's a utility element, not a loot drop) +4. **Ascension Skills** - Deleted from the game (were unused/game design change) +5. **Show Component Names** - Fixed debug option to properly display component names in UI +6. **DebugTab** - Added Invoker Debugging Buttons for Pacts (`PactDebug` component) + ### Missing Implementations 1. **Field Repair** - Skill exists, no repair system @@ -1009,6 +1088,8 @@ dps = (damage × castSpeed × attackSpeedMultiplier) / hour 1. **Scroll Crafting** - Removed (violates NO INSTANT FINISHING pillar) 2. **Temporal Memory** - Removed (replaced by better mechanics) +3. **Ascension Skills** - Deleted (Task 2) +4. **Transference from LootTab** - Removed (Task 2, not a lootable essence) ### Balance Concerns @@ -1018,4 +1099,5 @@ dps = (damage × castSpeed × attackSpeedMultiplier) / hour --- +*Document Version: 1.1 (Updated after Task 2 completion)* *End of Game Briefing Document*