Anexim/Mana-Loop

Fork 0

Files

T

n8n-gitea 20c2ebd7b5

Build and Publish Mana Loop Docker Image / build-and-publish (push) Failing after 56s

Details

Updated docs

2026-05-18 11:26:24 +02:00

32 KiB

Raw Blame History

Mana-Loop: Comprehensive Game Briefing Document

Document Version: 2.0
Updated: Disciplines Refactor (skills system removed; disciplines replace it entirely)

Executive Summary
Core Game Loop
Mana System
Time & Incursion System
Spire & Floor System
Combat System
Guardian & Pact System
Attunement System
Discipline System
Equipment & Enchantment System
Golemancy System
Prestige/Loop System
Achievement System
Formulas & Calculations
System Interactions
Code Architecture

Executive Summary

Mana-Loop is a browser-based incremental/idle game with a 30-day time loop mechanic. Players gather mana, practice disciplines, climb a 100-floor spire, defeat guardians, sign pacts, enchant equipment, and prestige for permanent progression.

Key Differentiators:

3-class Attunement system (Enchanter, Invoker, Fabricator)
Equipment-based spell system (spells come from enchanted gear)
Practice-based Discipline system — no discrete skill levels, only continuous XP growth
Time pressure through the incursion mechanic
Guardian pacts provide permanent multipliers

Code Architecture: Modular stores, crafting actions, discipline data, and constants. The old skill system (study, skill tiers, milestone upgrades) has been fully removed and replaced by the Discipline system.

Core Game Loop

Primary Loop (Within Each Run)

┌─────────────────────────────────────────────────────────────┐
│                      TIME LOOP (30 Days)                     │
├─────────────────────────────────────────────────────────────┤
│  ┌─────────┐    ┌────────────┐    ┌───────────┐    ┌──────┐ │
│  │ GATHER  │───▶│  PRACTICE  │───▶│   CLIMB   │───▶│CRAFT │ │
│  │  MANA   │    │ DISCIPLINES│    │   SPIRE   │    │ GEAR │ │
│  └─────────┘    └────────────┘    └───────────┘    └──────┘ │
│       │               │                │               │    │
│       └───────────────┴────────────────┴───────────────┘    │
│                            │                                 │
│                            ▼                                 │
│  ┌─────────────────────────────────────────────────────┐   │
│  │           DEFEAT GUARDIANS → SIGN PACTS              │   │
│  └─────────────────────────────────────────────────────┘   │
│                            │                                 │
│                            ▼                                 │
│  ┌─────────────────────────────────────────────────────┐   │
│  │           DAY 30: LOOP ENDS → GAIN INSIGHT           │   │
│  └─────────────────────────────────────────────────────┘   │
└─────────────────────────────────────────────────────────────┘

Game Actions

Action	Effect	Time Cost
Meditate	Regen mana with meditation bonus multiplier	Passive (auto-selected after actions)
Climb	Progress through spire floors, cast spells	Active combat
Practice	Run active disciplines, consuming mana each tick	Continuous
Craft	Create/enchant equipment	Hours per stage
Convert	Auto-convert raw mana to elements	Per tick
Design	Create enchantment designs (limited to owned gear types)	Hours
Prepare	Ready equipment for enchanting	Hours + mana
Enchant	Apply enchantment to equipment	Hours + mana

Action Transitions

After completing Design, Prepare, Enchant, or Craft the game automatically transitions to Meditate
Action buttons are hidden when in Spire Mode
currentAction state lives in stores/gameStore.ts

Mana System

Mana Types Hierarchy

Raw Mana (Base Resource)
    │
    ├──▶ Base Elements (7) ─────────────────────────────────────┐
    │    Fire*, Water*, Air*, Earth*, Light, Dark, Death        │
    │    *Locked at start - must be unlocked                    │
    │                                                           │
    ├──▶ Utility Element (1) ───────────────────────────────────┤
    │    Transference (Enchanter attunement - UNLOCKED at start) │
    │                                                           │
    ├──▶ Compound Elements (3) ── Created from 2 base ──────────┤
    │    Metal = Fire + Earth                                   │
    │    Sand  = Earth + Water                                  │
    │    Lightning = Fire + Air                                 │
    │                                                           │
    └──▶ Exotic Elements (3) ── Created from advanced recipes ──┤
         Crystal = Sand + Sand + Light                          │
         Stellar = Fire + Fire + Light                          │
         Void    = Dark + Dark + Death                          │

Fire, Water, Air, and Earth are locked at start. Only Transference is unlocked initially.

Mana Formulas

Maximum Raw Mana:

maxMana = (100 + (manaWellLevel × 100) + (prestigeManaWell × 500) + equipmentBonuses) × maxManaMultiplier

Maximum Elemental Mana:

elementMax = (10 + (elemAttuneLevel × 50) + (prestigeElemAttune × 25)) × elementCapMultiplier

Base Regeneration (per hour):

baseRegen       = 2 + (manaFlowLevel × 1) + (manaSpringLevel × 2) + (prestigeManaFlow × 0.5)
effectiveRegen  = baseRegen × (1 - incursionStrength) × meditationMultiplier

Meditation Bonus:

Base: 1 + min(hours/4, 0.5)  →  up to 1.5× after 4 hours

Attunement Mana Conversion:

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

Time & Incursion System

Time Constants

Constant	Value	Description
`TICK_MS`	200ms	Real time per game tick
`HOURS_PER_TICK`	0.04	Game hours per tick
`MAX_DAY`	30	Days per loop
`INCURSION_START_DAY`	20	When incursion begins

Time Progression

1 real second = 5 game hours (at 5 ticks/second)
1 game day = 24 game hours = 4.8 real seconds
Full 30-day loop ≈ 2.4 real minutes

Incursion Mechanic

if (day < 20): incursionStrength = 0
else:          incursionStrength = min(0.95, (totalHours / maxHours) × 0.95)

Reduces mana regeneration by (1 - incursionStrength). Starts at 0% on Day 20, reaches 95% by Day 30.

Spire & Floor System

Floor Generation

Floor Element Cycle:

FLOOR_ELEM_CYCLE = ["fire", "water", "air", "earth", "light", "dark", "death"]
element = FLOOR_ELEM_CYCLE[(floor - 1) % 7]

Floor HP Formula:

normalFloorHP  = floor(100 + floor × 50 + floor^1.7)
guardianFloorHP = GUARDIANS[floor].hp  // in constants/guardians.ts

Guardian Floors: 10, 20, 30, 40, 50, 60, 80, 90, 100

Room Types

Room Type	Chance	Description
Combat	Default	Single enemy, normal combat
Guardian	Fixed	Boss floor
Swarm	15%	3–6 enemies with 40% HP each
Speed	10%	Enemy with dodge chance (25% base + 0.5%/floor)
Puzzle	20% on puzzle floors	Progress-based, faster with relevant attunement

Armor Scaling

FLOOR_ARMOR_CONFIG = {
  baseChance:     0,      // No armor before floor 10
  chancePerFloor: 0.01,   // +1% chance per floor after 10
  maxArmorChance: 0.5,    // Max 50% of floors have armor
  minArmor:       0.05,   // Min 5% damage reduction
  maxArmor:       0.25    // Max 25% on non-guardians
}

Combat System

Spell Casting Mechanics

progressPerTick = HOURS_PER_TICK × spellCastSpeed × totalAttackSpeed

Lightning spells get +30% effective cast speed.

Damage Calculation

baseDamage     = spellDamage + disciplineBonus(combatStat)
pctBonus       = 1 + disciplineMultiplier
pactMultiplier = product of all signed pact multipliers
elementalBonus = getElementalBonus(spellElement, floorElement)

finalDamage = baseDamage × pctBonus × pactMultiplier × elementalBonus

Elemental Effectiveness

Condition	Multiplier
Spell same element as floor	1.25×
Spell is opposite of floor element	1.50× (Super Effective)
Spell's opposite matches floor	0.75× (Not Very Effective)
Raw mana spells	1.00×

Element Opposites:

Fire ↔ Water    Air ↔ Earth    Light ↔ Dark
Lightning — no opposite (has armor pierce instead)

Armor & Damage Reduction

effectiveArmor = max(0, enemyArmor - armorPierce)
damageDealt    = damage × (1 - effectiveArmor)

Critical Hits

Critical chance and multiplier come from discipline bonuses (no fixed skill levels).

Special Combat Effects

Effect	Description
Burn	Damage over time
Freeze	Prevents dodge
Stun	Temporary disable
Pierce	Ignores % armor
Chain	Hits multiple targets
AOE	Area damage
Buff	Damage multiplier

Guardian & Pact System

Guardian Floors & Stats

Floor	Guardian	Element	HP	Pact Mult	Armor	Unique Perk
10	Ignis Prime	Fire	5,000	1.5×	10%	Fire spells cast 10% faster
20	Aqua Regia	Water	15,000	1.75×	15%	Water spells +15% damage
30	Ventus Rex	Air	30,000	2.0×	18%	Air spells 15% crit chance
40	Terra Firma	Earth	50,000	2.25×	25%	Earth spells +25% vs guardians
50	Lux Aeterna	Light	80,000	2.5×	20%	Light spells reveal weaknesses
60	Umbra Mortis	Dark	120,000	2.75×	22%	Dark spells +25% vs armored
80	Mors Ultima	Death	250,000	3.25×	25%	Death spells execute <20% HP
90	Primordialis	Void	400,000	4.0×	30%	Void spells ignore 30% resistance
100	The Awakened One	Stellar	1,000,000	5.0×	35%	All spells +50% dmg, 25% faster

Guardian Boons (on pact)

Boon Type	Effect
`maxMana`	+Max raw mana
`manaRegen`	+Regen/hour
`castingSpeed`	+% cast speed
`elementalDamage`	+% element damage
`rawDamage`	+% all damage
`critChance`	+% crit chance
`critDamage`	+% crit multiplier
`insightGain`	+% insight

Victory Condition

Defeat floor 100 guardian and sign the pact → 3× normal insight.

Attunement System

Attunements are class-like specializations that unlock discipline pools and grant unique capabilities.

The Three Attunements

1. Enchanter (Right Hand) ✅

Property	Value
Slot	Right Hand
Primary Mana	Transference
Raw Regen	+0.5/hour base
Conversion	0.2 raw→transference/hour
Unlock	Starting attunement

Disciplines Unlocked: Enchanter discipline pool (data/disciplines/enchanter.ts)
Capabilities: Enchanting & disenchanting equipment

2. Invoker (Chest) ✅

Property	Value
Slot	Chest
Primary Mana	None (gains from pacts)
Raw Regen	+0.3/hour base
Conversion	None
Unlock	Defeat first guardian

Disciplines Unlocked: Invoker discipline pool (data/disciplines/invoker.ts)
Capabilities: Form pacts with guardians, access guardian powers

3. Fabricator (Left Hand) ✅

Property	Value
Slot	Left Hand
Primary Mana	Earth
Raw Regen	+0.4/hour base
Conversion	0.25 raw→earth/hour
Unlock	Prove crafting worth

Disciplines Unlocked: Fabricator discipline pool (data/disciplines/fabricator.ts)
Capabilities: Golem crafting, gear crafting, Earth shaping

Attunement Leveling

Level 2: 1,000 XP
Level 3: 2,500 XP
Level 4: 5,000 XP
Level 5: 10,000 XP
// Each level ≈ 2× previous; Max Level: 10

regenMultiplier  = 1.5^(level - 1)
conversionRate   = baseRate × 1.5^(level - 1)

Discipline System

Disciplines replace the old skill system entirely. There are no discrete levels or study actions — disciplines grow continuously through practice. The player activates a discipline and it drains mana each tick in exchange for permanent stat growth.

Core Concept

The more you practice a discipline, the stronger its effect — but the more mana it costs to maintain.

XP accumulates each tick the discipline is active and has enough mana to drain
Stat bonus grows as a power curve of XP (never resets within a run)
Mana drain also increases with XP — mastery has a cost
Perks unlock at XP thresholds, granting bonus effects

Disciplines vs Old Skills

Old Skill System	Discipline System
Discrete levels (1–10 per tier)	Continuous XP accumulation
Mana cost paid once on study	Mana drained every tick
Required hours to level up	Grows passively while active
Milestone upgrades at L5/L10	Perks unlock at XP thresholds
5-tier evolution (T1–T5)	Single continuous curve per discipline

Formulas

Stat Bonus (continuous):

StatBonus = baseValue × (XP / scalingFactor)^0.65

Mana Drain Per Tick:

ManaDrainPerTick = drainBase × (1 + (XP / difficultyFactor)^0.4)

scalingFactor controls how quickly stats grow
difficultyFactor controls how quickly drain increases
Higher scalingFactor → slower stat gain; higher difficultyFactor → slower drain increase

Concurrent Discipline Limit

concurrentLimit = 1 + floor(totalXP / 500)   // capped at base + 3

Players start with 1 active discipline slot. As total XP across all disciplines grows, additional slots unlock (max 4 total).

Perk Types

Type	Behaviour
`once`	Unlocks permanently when XP reaches `threshold`
`capped`	Grants stacking bonus tiers; each tier requires another `interval` XP beyond `threshold`
`infinite`	Repeating bonus — a new stack every `interval` XP past `threshold` (no cap)

Attunement Pools

Pool	File	Requires
Base	`data/disciplines/base.ts`	None (all attunements)
Enchanter	`data/disciplines/enchanter.ts`	Enchanter attunement
Invoker	`data/disciplines/invoker.ts`	Invoker attunement
Fabricator	`data/disciplines/fabricator.ts`	Fabricator attunement

Example Disciplines

Discipline	Attunement	Mana Type	Stat Bonus	Description
Raw Mana Mastery	Base	Raw	`maxManaBonus`	More raw mana from practice
Elemental Attunement	Base	Fire	`elementCap_fire`	Expanded fire capacity
Lightning Surge	Invoker	Lightning	`lightningDamage`	Boosts lightning spell damage
Void Echo	Invoker	Void	`voidCastSpeed`	Increases void spell cast speed
Metalworking	Fabricator	Metal	`craftSpeed_metal`	Faster metal equipment crafting
Crystal Shaping	Fabricator	Crystal	`durability_crystal`	More durable crystal equipment
Soulforge	Enchanter	Light	`enchantPower`	Stronger enchantment effects
Mana Prism	Enchanter	Light	`manaReflect`	Prismatic mana focusing

Discipline Lifecycle

1. Player opens Disciplines tab → sees available disciplines for their attunements
2. Player activates discipline (costs nothing up-front; requires mana type unlocked)
3. Each game tick:
   a. ManaDrain deducted from mana pool
   b. If insufficient mana → discipline auto-pauses
   c. If sufficient mana → disc.xp += 1; stat bonuses recomputed
4. Player can manually pause/resume disciplines
5. On loop end, XP resets (stat bonuses are per-run, not permanent)
   — Prestige upgrades may eventually preserve some XP

Discipline UI

src/components/game/tabs/DisciplinesTab.tsx
src/lib/game/stores/discipline-slice.ts — Zustand store (persisted)
src/lib/game/effects/discipline-effects.ts — integrates into getUnifiedEffects()

Equipment & Enchantment System

Equipment Slots

mainHand   - Staves (2H), Wands, Swords
offHand    - Shields, Catalysts (blocked by 2-handed weapons)
head       - Hoods, Hats, Helms
body       - Robes, Armor
hands      - Gloves, Gauntlets
feet       - Boots, Shoes
accessory1 - Rings, Amulets
accessory2 - Rings, Amulets

Two-Handed Weapons

2-handed weapons (Staves) occupy both mainHand and offHand. The offhand slot is blocked when a 2H weapon is equipped. The UI shows a "Blocked by 2-handed weapon" label on the offhand slot.

Equipment Instance Structure

interface EquipmentInstance {
  instanceId:     string;
  typeId:         string;
  name:           string;
  enchantments:   AppliedEnchantment[];
  usedCapacity:   number;
  totalCapacity:  number;
  rarity:         'common' | 'uncommon' | 'rare' | 'epic' | 'legendary' | 'mythic';
  quality:        number;  // 0–100
}

Enchantment Process (3 Stages)

Stage 1: Design

Select effects from unlocked pool (data/enchantment-effects.ts)
Limited to owned gear types
Time: 1h base + 0.5h per effect stack
Implemented in crafting-actions/design-actions.ts

Stage 2: Prepare

Mana cost: capacity × 10
Time: 2h + 1h per 50 capacity
Auto-transitions to Meditate on complete
Implemented in crafting-actions/preparation-actions.ts

Stage 3: Apply

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 on complete
Implemented in crafting-actions/application-actions.ts

Enchantment Effect Categories

Category	Description	Equipment Types
Spell	Grants spell ability	Casters only
Mana	Max/regen/click bonuses	Casters, Catalysts, Head, Body, Accessories
Combat	Damage, crit, speed	Casters, Hands
Utility	Meditation, insight	Most equipment
Special	Unique effects	Various
Elemental	Weapon enchantments	Swords, Casters

Starting Equipment

Slot	Item	Enchantment	Capacity
Main Hand	Basic Staff	Mana Bolt spell	50/50
Body	Civilian Shirt	None	0/30
Feet	Civilian Shoes	None	0/15

Golemancy System

Golem Slots

Fabricator Level 2: 1 slot
Fabricator Level 4: 2 slots
Fabricator Level 6: 3 slots
Fabricator Level 8: 4 slots
Fabricator Level 10: 5 slots

slots = floor(fabricatorLevel / 2)

Golem Types

Base Golems

Golem	Element	Damage	Speed	Armor Pierce	Unlock
Earth Golem	Earth	8	1.5/h	15%	Fabricator 2

Elemental Variants

Golem	Element	Damage	Speed	Pierce	Unlock
Steel Golem	Metal	12	1.2/h	35%	Metal mana unlocked
Crystal Golem	Crystal	18	1.0/h	25%	Crystal mana unlocked
Sand Golem	Sand	6	2.0/h	10%	Sand mana unlocked

Advanced Hybrid Golems (Enchanter 5 + Fabricator 5)

Golem	Elements	Damage	Speed	Pierce	Special
Lava Golem	Earth + Fire	15	1.0/h	20%	AOE 2
Galvanic Golem	Metal + Lightning	10	3.5/h	45%	Fast
Obsidian Golem	Earth + Dark	25	0.8/h	50%	High damage
Prism Golem	Crystal + Light	20	1.5/h	35%	AOE 3
Quicksilver Golem	Metal + Water	8	4.0/h	30%	Very fast
Voidstone Golem	Earth + Void	40	0.6/h	60%	Ultimate

Golem Combat

progressPerTick = HOURS_PER_TICK × attackSpeed × efficiencyBonus
damage          = baseDamage × (1 + golemMasteryBonus)   // bonus from discipline

Prestige/Loop System

Loop End Conditions

Condition	Result
Day 30 reached	Loop ends, gain insight
Floor 100 + Pact 100 signed	Victory! 3× insight

Insight Formula

baseInsight  = floor(maxFloorReached × 15 + totalManaGathered / 500 + signedPacts.length × 150)
finalInsight = floor(baseInsight × (1 + insightAmpLevel × 0.25) × disciplineBonus)

Prestige Upgrades

Upgrade	Max	Cost	Effect
Mana Well	5	500	+500 starting max mana
Mana Flow	10	750	+0.5 permanent regen
Deep Memory	5	1000	+1 memory slot
Insight Amp	4	1500	+25% insight gain
Spire Key	5	4000	Start at floor +2
Temporal Echo	5	3000	+10% mana generation
Steady Hand	5	1200	-15% durability loss
Ancient Knowledge	5	2000	Start with blueprint
Elemental Attune	10	600	+25 element cap
Spell Memory	3	2500	Start with random spell
Guardian Pact	5	3500	+10% pact multiplier
Quick Start	3	400	+100 starting mana
Elem. Start	3	800	+5 each unlocked element

Memory System

Base slots: 3
Additional: +1 per Deep Memory prestige level
Memories: Spells preserved across loops

Achievement System

Category	Description
`mana`	Mana gathering milestones
`combat`	Combat achievements
`progression`	Floor/guardian progression
`crafting`	Equipment and enchanting
`prestige`	Loop and insight milestones

Reward Types

Reward	Effect
`insight`	One-time insight bonus
`manaBonus`	Permanent max mana
`damageBonus`	Permanent damage increase
`regenBonus`	Permanent regen increase
`title`	Cosmetic title
`unlockEffect`	Unlocks enchantment effect

Formulas & Calculations

Damage Calculation (Complete)

function calcDamage(state, spellId, floorElement) {
  const spell = SPELLS_DEF[spellId];        // constants/spells.ts

  // Base damage + discipline bonuses
  let damage = spell.dmg + disciplineBonus('combatDamage');

  // Discipline multiplier bonus
  damage *= 1 + disciplineBonus('damagePct');

  // Guardian bane (vs guardians only)
  if (isGuardian) {
    damage *= 1 + disciplineBonus('guardianBane');
  }

  // Pact multiplier
  damage *= state.signedPacts.reduce((m, f) => m * GUARDIANS[f].pact, 1);

  // Elemental effectiveness
  damage *= getElementalBonus(spell.elem, floorElement);

  // Critical hit (from discipline crit bonus)
  const critChance = disciplineBonus('critChance');
  if (Math.random() < critChance) damage *= 1.5;

  // Equipment effects
  damage *= effects.baseDamageMultiplier;
  damage += effects.baseDamageBonus;

  // Armor reduction
  const effectiveArmor = Math.max(0, enemyArmor - armorPierce);
  damage *= (1 - effectiveArmor);

  return Math.floor(damage);
}

DPS Calculation

dps = (damage × castSpeed × attackSpeedMultiplier) / hour

System Interactions

Primary Interaction Map

┌─────────────────────────────────────────────────────────────────────────┐
│                         CORE SYSTEM INTERACTIONS                         │
├─────────────────────────────────────────────────────────────────────────┤
│                                                                          │
│  ┌──────────┐        ┌────────────┐        ┌──────────┐                │
│  │   MANA   │───────▶│ DISCIPLINES│───────▶│  COMBAT  │                │
│  └──────────┘        └────────────┘        └──────────┘                │
│       │                    │                    │                       │
│       │                    │                    │                       │
│       ▼                    ▼                    ▼                       │
│  ┌──────────┐        ┌──────────┐         ┌──────────┐                │
│  │ATTUNEMENT│───────▶│ENCHANTING│────────▶│  SPIRE   │                │
│  └──────────┘        └──────────┘         └──────────┘                │
│       │                    │                    │                       │
│       │                    │                    │                       │
│       ▼                    ▼                    ▼                       │
│  ┌──────────┐        ┌──────────┐         ┌──────────┐                │
│  │GOLEMANCY │        │EQUIPMENT │────────▶│ GUARDIAN │                │
│  └──────────┘        └──────────┘         └──────────┘                │
│                                                 │                       │
│                                                 ▼                       │
│                                          ┌──────────┐                  │
│                                          │   PACT   │                  │
│                                          └──────────┘                  │
│                                                 │                       │
│                                                 ▼                       │
│                                          ┌──────────┐                  │
│                                          │ PRESTIGE │                  │
│                                          └──────────┘                  │
└─────────────────────────────────────────────────────────────────────────┘

Key System Dependencies

System	Depends On	Unlocks/Enables
Disciplines	Mana (drain cost), Attunement (pool access)	All combat/crafting stat bonuses
Enchanting	Enchanter attunement, Enchanter disciplines	Equipment spells, bonuses
Golemancy	Fabricator attunement, Earth mana	Additional combat damage
Pacts	Guardian defeat	Permanent multipliers, boons
Prestige	Loop completion	Permanent upgrades, memories
Equipment	Crafting/Blueprints	Spell access, stat bonuses

Progression Gates

Early Game (Floors 1–10): Mana gathering and regen, base disciplines, starting equipment
Mid Game (Floors 10–40): First guardian pacts, attunement unlocking, attunement discipline pools, equipment enchanting, Golemancy
Late Game (Floors 40–80): Compound/exotic elements, hybrid golems, advanced discipline perks, advanced enchantments
End Game (Floors 80–100): Void/Stellar/Crystal spells, ultimate golems, victory preparation

Code Architecture

Modular Structure Overview

Store Architecture

Active Stores (src/lib/game/stores/):

gameStore.ts — Core state, tick logic, main actions
manaStore.ts — Mana gathering, elements, conversion
combatStore.ts — Combat system, spells, floor progression
prestigeStore.ts — Prestige/loop system, insight, upgrades
discipline-slice.ts — Discipline activation, XP ticking, perk evaluation
uiStore.ts — UI state, modals, debug settings

Legacy Store (Migration in Progress):

store.ts — Legacy monolithic store (reduced)
store/ — Legacy store slices being migrated to stores/
store-modules/ — Legacy store utilities

Discipline System (`src/lib/game/`)

data/disciplines/ — Per-attunement discipline definitions
types/disciplines.ts — DisciplineDefinition, DisciplineState, perk types
utils/discipline-math.ts — calculateStatBonus, calculateManaDrain, perk helpers
effects/discipline-effects.ts — computeDisciplineEffects() → feeds getUnifiedEffects()
stores/discipline-slice.ts — Zustand store for active discipline state

Crafting System (`src/lib/game/crafting-actions/`)

Modular action files for each crafting stage
Design, preparation, application, equipment, disenchant actions

Constants (`src/lib/game/constants/`)

Domain-specific constant files: elements, guardians, spells, rooms, prestige
Barrel exports via constants/index.ts

Game Data (`src/lib/game/data/`)

Enchantment effects, equipment types, golems, disciplines, achievements, loot tables
Organized by domain for easy navigation

File Size Guidelines

All files kept under 400 lines (enforced by pre-commit hook).

Appendix: Removed Systems

The following systems no longer exist and should not be re-introduced:

Removed	Replacement
Skill System (study, tiers T1–T5, milestone upgrades)	Discipline System
`skillStore.ts`	`discipline-slice.ts`
`skill-evolution-modules/`	`data/disciplines/` + `discipline-math.ts`
`docs/skills.md`	This document (Discipline System section)
`docs/strategy/`	Fully implemented; folder removed
Ascension skills	Deleted (no replacement)
Scroll crafting	Deleted (violates no-instant-finishing pillar)
Lifesteal/healing	Banned permanently

Document Version: 2.0 — Disciplines Refactor
End of Game Briefing Document

32 KiB Raw Blame History Unescape Escape