Complete skill system redesign: Add all upgrade trees, special effects, and comprehensive tests
All checks were successful
Build and Publish Mana Loop Docker Image / build-and-publish (push) Successful in 1m51s

- Added upgrade trees for ALL skills with max > 1
- Added 40+ new special effects for upgrades
- Created 38 new comprehensive tests for skill system
- Updated docs/skills.md with full documentation
- All new tests pass, lint clean
This commit is contained in:
Z User
2026-04-03 12:29:49 +00:00
parent 359702c6ca
commit 69a1d87169
6 changed files with 1799 additions and 258 deletions

View File

@@ -1,55 +1,33 @@
# Mana Loop - Skill System Documentation
# Mana Loop - Complete Skill System Documentation
## Table of Contents
1. [Overview](#overview)
2. [Core Mechanics](#core-mechanics)
3. [Skill Categories](#skill-categories)
4. [All Skills Reference](#all-skills-reference)
5. [Upgrade Trees](#upgrade-trees)
6. [Tier System](#tier-system)
7. [Banned Content](#banned-content)
---
## Overview
The skill system in Mana Loop allows players to specialize their character through a deep progression system. Skills are organized by attunement, with each attunement providing access to specific skill categories.
The skill system in Mana Loop provides deep character customization through a branching upgrade tree system. Skills are organized by attunement, with each attunement granting access to specific skill categories.
### Skill Level Types
| Max Level | Description | Example Skills |
|-----------|-------------|----------------|
| 10 | Standard skills with full upgrade trees | Mana Well, Mana Flow, Enchanting |
| 5 | Specialized skills with limited upgrades | Efficient Enchant, Golem Mastery |
| 3 | Focused skills with no upgrades | Knowledge Retention, Golem Longevity |
| 1 | Effect research skills (unlock only) | All research skills |
---
## Core Mechanics
### Skill Levels
- Most skills level from **1 to 10**
- Some skills cap at **level 5** (specialized skills)
- Research skills are **level 1 only** (unlock effects)
### Tier Up System
When a skill reaches max level, it can **tier up**:
- **Tier 2, Level 1 = Tier 1, Level 10** in power
- Each tier multiplies the skill's base effect by 10x
- Maximum of 5 tiers per skill
- Tiering up requires attunement level prerequisites
### Milestone Upgrades (The Perk Tree)
At **every 5 levels** (5 and 10), you choose **1 upgrade/perk** from an upgrade tree:
- Starts with 3 base choices per milestone
- Each choice leads to branching paths
- You can always choose from previously available options
- Upgrades can be **upgraded again** at future milestones
- Upgrades meaningfully impact how the skill works
#### Example: Mana Well Upgrade Tree
```
Level 5 Choices:
├── Expanded Capacity (+25% max mana)
│ └── Level 10 upgrade: Deep Reservoir (+50% max mana)
│ └── Future: Can sacrifice capacity for regen
├── Natural Spring (+0.5 regen)
│ └── Level 10 upgrade: Flowing Spring (+1 regen)
│ └── Future: Regen scales with max mana
└── Mana Threshold (+20% max mana, -10% regen)
└── Level 10 upgrade: Mana Conversion (Convert capacity to click bonus)
└── Future: Threshold mechanics
Level 10 Choices (additional):
├── Mana Echo (10% chance double mana from clicks)
├── Emergency Reserve (Keep 10% mana on loop reset)
└── Deep Wellspring (+50% meditation efficiency)
```
### Study System
Leveling skills requires:
@@ -57,134 +35,426 @@ Leveling skills requires:
2. **Study time** - Hours required to complete
3. **Active studying** - Must be in "study" action mode
Study costs scale with:
- Current level (higher levels = more expensive)
- Skill tier (higher tiers = more expensive)
- Focused Mind skill (reduces cost)
#### Study Cost Formula
```
cost = baseCost × (currentLevel + 1) × tier × costMultiplier
```
### Attunement Requirements
#### Study Time Formula
```
time = baseStudyTime × tier / studySpeedMultiplier
```
Skills have attunement requirements for:
1. **Access** - Which attunement unlocks the skill category
2. **Tier Up** - Required attunement levels to advance tiers
### Milestone Upgrades
| Requirement Type | Example |
|-----------------|---------|
| Single Attunement | Enchanting skills require Enchanter |
| Multiple Attunements | Hybrid skills require both attunements leveled |
| Any Attunement | Core skills just need any attunement active |
| No Requirement | Basic skills always available |
At **levels 5 and 10**, you choose **1 upgrade** from an upgrade tree:
- Each skill has its own unique upgrade tree
- Trees have branching paths with prerequisites
- Choices are permanent for that tier
- Upgrades persist when tiering up
---
## Skill Categories
### Core Skills (No Attunement Required)
### Core Categories (No Attunement Required)
Always available to all players.
| Category | Icon | Description |
|----------|------|-------------|
| Mana | 💧 | Mana pool and regeneration |
| Study | 📚 | Learning speed and efficiency |
| Research | 🔮 | Permanent bonuses |
| Ascension | ⭐ | Loop-persisting benefits |
#### Mana Category
| Skill | Max Level | Effect | Description |
|-------|-----------|--------|-------------|
| Mana Well | 10 | +100 max mana per level | Increases your mana reservoir |
| Mana Flow | 10 | +1 regen/hour per level | Faster mana regeneration |
| Elemental Attunement | 10 | +50 element cap per level | Store more elemental mana |
### Attunement Categories
#### Study Category
| Skill | Max Level | Effect | Description |
|-------|-----------|--------|-------------|
| Quick Learner | 10 | +10% study speed per level | Learn faster |
| Focused Mind | 10 | -5% study cost per level | Learn cheaper |
| Knowledge Retention | 3 | +20% progress saved on cancel | Don't lose study progress |
| Meditation Focus | 1 | Up to 2.5x regen after 4hr meditating | Enhanced meditation |
#### Research Category (Long Study Times)
| Skill | Max Level | Effect | Description |
|-------|-----------|--------|-------------|
| Mana Tap | 1 | +1 mana/click | Better clicking |
| Mana Surge | 1 | +3 mana/click | Requires Mana Tap |
| Mana Spring | 1 | +2 mana regen | Passive bonus |
| Deep Trance | 1 | 6hr meditation = 3x regen | Requires Meditation |
| Void Meditation | 1 | 8hr meditation = 5x regen | Requires Deep Trance |
### Enchanter Skills (Requires Enchanter Attunement)
#### Enchanting Category
| Skill | Max Level | Effect | Attunement Req |
|-------|-----------|--------|----------------|
| Enchanting | 10 | Unlocks enchantment design | Enchanter 1 |
| Efficient Enchant | 5 | -5% capacity cost per level | Enchanter 2 |
| Disenchanting | 3 | +20% mana recovery per level | Enchanter 1 |
| Enchant Speed | 5 | -10% enchant time per level | Enchanter 1 |
| Essence Refining | 5 | +10% effect power per level | Enchanter 2 |
#### Effect Research Category
Research skills unlock enchantment effects. All are level 1 only and require Enchanter attunement.
**Tier 1 Research (Basic Spells)**
- Mana Spell Research → Mana Strike enchantment
- Fire Spell Research → Ember Shot, Fireball enchantments
- Water Spell Research → Water Jet, Ice Shard enchantments
- Air Spell Research → Gust, Wind Slash enchantments
- Earth Spell Research → Stone Bullet, Rock Spike enchantments
- Light Spell Research → Light Lance, Radiance enchantments
- Dark Spell Research → Shadow Bolt, Dark Pulse enchantments
- Death Research → Drain enchantment
**Tier 2 Research (Advanced Spells)** - Requires Enchanter 3
- Advanced Fire/Water/Air/Earth Research
- Advanced Light/Dark Research
**Tier 3 Research (Master Spells)** - Requires Enchanter 5
- Master Fire/Water/Earth Research
**Compound Mana Research** - Requires parent element research
- Metal Spell Research (Fire + Earth)
- Sand Spell Research (Earth + Water)
- Lightning Spell Research (Fire + Air)
- Plus Advanced/Master variants
**Utility Research**
- Transference Spell Research
- Damage Effect Research
- Mana Effect Research
- Utility Effect Research
### Invoker Skills (Requires Invoker Attunement)
#### Pact Category
| Skill | Max Level | Effect | Attunement Req |
|-------|-----------|--------|----------------|
| Pact Mastery | 5 | +10% pact bonus per level | Invoker 1 |
| Guardian Insight | 3 | See guardian weaknesses | Invoker 2 |
| Pact Efficiency | 3 | -10% pact ritual cost | Invoker 2 |
### Fabricator Skills (Requires Fabricator Attunement)
#### Golemancy Category
| Skill | Max Level | Effect | Attunement Req |
|-------|-----------|--------|----------------|
| Golem Mastery | 5 | +10% golem damage per level | Fabricator 2 |
| Golem Efficiency | 5 | +5% attack speed per level | Fabricator 2 |
| Golem Longevity | 3 | +1 floor duration per level | Fabricator 3 |
| Golem Siphon | 3 | -10% maintenance per level | Fabricator 3 |
| Advanced Golemancy | 1 | Unlock hybrid golem recipes | Fabricator 5 |
| Golem Resonance | 1 | +1 golem slot at max level | Fabricator 8 |
### Ascension Skills (Require Any Attunement Level 5+)
| Skill | Max Level | Effect | Requirement |
|-------|-----------|--------|-------------|
| Insight Harvest | 5 | +10% insight per level | Any attunement 5 |
| Temporal Memory | 3 | Keep 1 spell per level across loops | Any attunement 5 |
| Category | Icon | Attunement | Description |
|----------|------|------------|-------------|
| Enchanting | ✨ | Enchanter | Enchantment design and efficiency |
| Effect Research | 🔬 | Enchanter | Unlock spell enchantments |
| Invocation | 💜 | Invoker | Pact-based abilities |
| Pact Mastery | 🤝 | Invoker | Guardian pact bonuses |
| Fabrication | ⚒️ | Fabricator | Crafting and construction |
| Golemancy | 🗿 | Fabricator | Golem summoning and control |
---
## Tier Up Requirements
## All Skills Reference
Each tier requires specific attunement levels:
### Mana Skills (Core)
### Core Skills (Mana, Study)
| Skill | Max | Effect | Base Cost | Study Time |
|-------|-----|--------|-----------|------------|
| Mana Well | 10 | +100 max mana/level | 100 | 4h |
| Mana Flow | 10 | +1 regen/hour/level | 150 | 5h |
| Elemental Attunement | 10 | +50 element cap/level | 200 | 4h |
| Mana Overflow | 5 | +25% click mana/level | 400 | 6h |
**Prerequisites:**
- Mana Overflow: Mana Well 3
### Study Skills (Core)
| Skill | Max | Effect | Base Cost | Study Time |
|-------|-----|--------|-----------|------------|
| Quick Learner | 10 | +10% study speed/level | 250 | 4h |
| Focused Mind | 10 | -5% study cost/level | 300 | 5h |
| Meditation Focus | 1 | Up to 2.5x regen after 4hrs | 400 | 6h |
| Knowledge Retention | 3 | +20% progress saved on cancel/level | 350 | 5h |
### Research Skills (Core)
| Skill | Max | Effect | Base Cost | Study Time |
|-------|-----|--------|-----------|------------|
| Mana Tap | 1 | +1 mana/click | 300 | 12h |
| Mana Surge | 1 | +3 mana/click | 800 | 36h |
| Mana Spring | 1 | +2 mana regen | 600 | 24h |
| Deep Trance | 1 | 6hr meditation = 3x regen | 900 | 48h |
| Void Meditation | 1 | 8hr meditation = 5x regen | 1500 | 72h |
**Prerequisites:**
- Mana Surge: Mana Tap 1
- Deep Trance: Meditation 1
- Void Meditation: Deep Trance 1
### Ascension Skills (Any Attunement)
| Skill | Max | Effect | Base Cost | Study Time | Attunement Req |
|-------|-----|--------|-----------|------------|----------------|
| Insight Harvest | 5 | +10% insight/level | 1000 | 20h | Any level 5+ |
| Temporal Memory | 3 | Keep 1 spell/level across loops | 2000 | 36h | Any level 5+ |
| Guardian Bane | 3 | +20% dmg vs guardians/level | 1500 | 30h | Invoker 1 |
### Enchanting Skills (Enchanter)
| Skill | Max | Effect | Base Cost | Study Time | Attunement Req |
|-------|-----|--------|-----------|------------|----------------|
| Enchanting | 10 | Unlocks enchantment design | 200 | 5h | Enchanter 1 |
| Efficient Enchant | 5 | -5% capacity cost/level | 350 | 6h | Enchanter 2 |
| Disenchanting | 3 | +20% mana recovery/level | 400 | 6h | Enchanter 1 |
| Enchant Speed | 5 | -10% enchant time/level | 300 | 4h | Enchanter 1 |
| Scroll Crafting | 3 | Store enchantment designs | 500 | 8h | Enchanter 3 |
| Essence Refining | 5 | +10% effect power/level | 450 | 7h | Enchanter 2 |
**Prerequisites:**
- Efficient Enchant: Enchanting 3
- Disenchanting: Enchanting 2
- Enchant Speed: Enchanting 2
- Scroll Crafting: Enchanting 5
- Essence Refining: Enchanting 4
### Golemancy Skills (Fabricator)
| Skill | Max | Effect | Base Cost | Study Time | Attunement Req |
|-------|-----|--------|-----------|------------|----------------|
| Golem Mastery | 5 | +10% golem damage/level | 300 | 6h | Fabricator 2 |
| Golem Efficiency | 5 | +5% attack speed/level | 350 | 6h | Fabricator 2 |
| Golem Longevity | 3 | +1 floor duration/level | 500 | 8h | Fabricator 3 |
| Golem Siphon | 3 | -10% maintenance/level | 400 | 8h | Fabricator 3 |
| Advanced Golemancy | 1 | Unlock hybrid recipes | 800 | 16h | Fabricator 5 |
| Golem Resonance | 1 | +1 golem slot | 1200 | 24h | Fabricator 8 |
**Prerequisites:**
- Advanced Golemancy: Golem Mastery 3
- Golem Resonance: Golem Mastery 5
### Effect Research Skills (Enchanter)
All effect research skills are **max level 1** and unlock specific enchantment effects.
#### Tier 1 Research (Basic Spells)
| Skill | Unlocks | Study Time |
|-------|---------|------------|
| Mana Spell Research | Mana Strike enchantment | 4h |
| Fire Spell Research | Ember Shot, Fireball | 6h |
| Water Spell Research | Water Jet, Ice Shard | 6h |
| Air Spell Research | Gust, Wind Slash | 6h |
| Earth Spell Research | Stone Bullet, Rock Spike | 6h |
| Light Spell Research | Light Lance, Radiance | 8h |
| Dark Spell Research | Shadow Bolt, Dark Pulse | 8h |
| Death Research | Drain enchantment | 8h |
#### Tier 2 Research (Advanced Spells)
Requires Enchanter 3+ and parent element research.
| Skill | Unlocks | Study Time |
|-------|---------|------------|
| Advanced Fire Research | Inferno, Flame Wave | 12h |
| Advanced Water Research | Tidal Wave, Ice Storm | 12h |
| Advanced Air Research | Hurricane, Wind Blade | 12h |
| Advanced Earth Research | Earthquake, Stone Barrage | 12h |
| Advanced Light Research | Solar Flare, Divine Smite | 14h |
| Advanced Dark Research | Void Rift, Shadow Storm | 14h |
#### Tier 3 Research (Master Spells)
Requires Enchanter 5+ and advanced research.
| Skill | Unlocks | Study Time |
|-------|---------|------------|
| Master Fire Research | Pyroclasm | 24h |
| Master Water Research | Tsunami | 24h |
| Master Earth Research | Meteor Strike | 26h |
#### Compound Element Research
Requires parent element research + Enchanter 3+.
| Skill | Unlocks | Study Time |
|-------|---------|------------|
| Metal Spell Research | Metal Shard, Iron Fist | 6h |
| Sand Spell Research | Sand Blast, Sandstorm | 6h |
| Lightning Spell Research | Spark, Lightning Bolt | 6h |
| Advanced Metal Research | Steel Tempest | 12h |
| Advanced Sand Research | Desert Wind | 12h |
| Advanced Lightning Research | Chain Lightning, Storm Call | 12h |
| Master Metal Research | Furnace Blast | 26h |
| Master Sand Research | Dune Collapse | 26h |
| Master Lightning Research | Thunder Strike | 26h |
#### Utility Research
| Skill | Unlocks | Study Time |
|-------|---------|------------|
| Transference Spell Research | Transfer Strike, Mana Rip | 5h |
| Advanced Transference Research | Essence Drain | 12h |
| Master Transference Research | Soul Transfer | 26h |
#### Effect Research
| Skill | Unlocks | Study Time |
|-------|---------|------------|
| Damage Effect Research | Minor/Moderate Power, Amplification | 5h |
| Combat Effect Research | Sharp Edge, Swift Casting | 6h |
| Mana Effect Research | Mana Reserve, Trickle, Mana Tap | 4h |
| Advanced Mana Research | Mana Reservoir, Stream, River | 8h |
| Utility Effect Research | Meditative Focus, Quick Study | 6h |
| Special Effect Research | Echo Chamber, Siphoning, Bane | 10h |
| Overpower Research | Overpower effect | 12h |
---
## Upgrade Trees
### Mana Well Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Expanded Capacity (+25% max mana)
│ └── Level 10: Deep Reservoir (+50% max mana) [replaces]
├── Natural Spring (+0.5 regen/hour)
│ └── Level 10: Flowing Spring (+1.5 regen) [replaces]
├── Mana Threshold (+30% max mana, -10% regen)
│ └── Level 10: Mana Conversion (5% max → click bonus)
└── Desperate Wells (+50% regen when below 25% mana)
└── Level 10: Panic Reserve (+100% regen below 10%)
```
**Level 10 Additional Choices:**
- Mana Echo (10% chance double mana from clicks)
- Emergency Reserve (Keep 10% mana on loop reset)
- Deep Wellspring (+50% meditation efficiency)
#### Tier 2 Upgrades (Deep Reservoir)
- Abyssal Depth (+50% max mana)
- Ancient Well (+500 starting mana per loop)
- Mana Condense (+1% max per 1000 gathered)
- Deep Reserve (+0.5 regen per 100 max mana)
- Ocean of Mana (+1000 max mana)
- Mana Tide (Regen pulses ±50%)
- Void Storage (Store 150% max temporarily)
- Mana Core (0.5% max mana as regen)
---
### Mana Flow Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Rapid Flow (+25% regen speed)
│ └── Level 10: Mana Torrent (+50% regen above 75% mana)
├── Steady Stream (Immune to incursion penalty)
│ └── Level 10: Eternal Flow (Immune to all penalties)
├── Mana Cascade (+0.1 regen per 100 max mana)
│ └── Level 10: Mana Waterfall (+0.25 per 100 max) [replaces]
└── Mana Overflow (Raw mana can exceed max by 20%)
```
**Level 10 Additional Choices:**
- Ambient Absorption (+1 permanent regen)
- Flow Surge (Clicks boost regen for 1 hour)
- Flow Mastery (+10% mana from all sources)
---
### Elemental Attunement Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Expanded Attunement (+25% element cap)
│ └── Level 10: Element Master (+50% element cap) [replaces]
├── Elemental Surge (+15% elemental spell damage)
│ └── Level 10: Elemental Power (+30% damage) [replaces]
└── Elemental Affinity (New elements start with 10 capacity)
```
**Level 10 Additional Choices:**
- Elemental Resonance (Spell use restores element)
- Exotic Mastery (+20% exotic element damage)
---
### Quick Learner Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Deep Focus (+25% study speed)
│ └── Level 10: Deep Concentration (+50% speed) [replaces]
├── Quick Grasp (5% chance double study progress)
│ └── Level 10: Knowledge Echo (15% instant complete)
├── Parallel Study (Study 2 things at 50% speed each)
└── Quick Mastery (-20% time for final 3 levels)
```
**Level 10 Additional Choices:**
- Study Momentum (+5% speed per hour, max 50%)
- Knowledge Transfer (New skills start at 10% progress)
---
### Focused Mind Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Mind Efficiency (+25% cost reduction)
│ └── Level 10: Efficient Learning (-15% study cost) [replaces]
├── Mental Clarity (+10% speed when mana > 75%)
│ └── Level 10: Study Rush (First hour 2x speed)
└── Study Refund (25% mana back on completion)
└── Level 10: Deep Understanding (+10% skill bonuses)
```
**Level 10 Additional Choices:**
- Chain Study (-5% cost per maxed skill)
---
### Enchanting Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Enchantment Capacity (+20% equipment capacity)
├── Swift Enchanting (-15% design time)
└── Quality Control (+10% effect power)
└── Level 10: Perfect Refinement (+25% power) [replaces]
```
**Level 10 Additional Choices:**
- Enchantment Mastery (2 designs in progress)
- Mana Preservation (25% chance free enchant)
---
### Golem Mastery Upgrade Tree
#### Tier 1 Upgrades
**Level 5 Choices:**
```
├── Golem Power (+25% golem damage)
├── Golem Durability (+1 floor duration)
└── Efficient Summons (-20% summon cost)
└── Level 10: Golem Siphon (-30% maintenance)
```
**Level 10 Additional Choices:**
- Golem Fury (+50% attack speed for first 2 floors)
- Golem Resonance (Golems share 10% damage)
---
### Other Skill Upgrade Trees
#### Mana Overflow (Max 5)
- **Level 5:** Click Surge (+50% click mana above 90% mana)
- **Tier 2 Level 5:** Mana Flood (+75% click mana above 75% mana)
#### Efficient Enchant (Max 5)
- **Level 5:** Thrifty Enchanter (+10% free enchant chance)
- **Tier 2 Level 5:** Optimized Enchanting (+25% free chance)
#### Enchant Speed (Max 5)
- **Level 5:** Hasty Enchanter (+25% speed for repeat designs)
- **Tier 2 Level 5:** Instant Designs (10% instant completion)
#### Essence Refining (Max 5)
- **Level 5:** Pure Essence (+25% power for tier 1 enchants)
- **Tier 2 Level 5:** Perfect Essence (+50% all enchant power)
#### Efficient Crafting (Max 5)
- **Level 5:** Batch Crafting (2 items at 75% speed each)
- **Tier 2 Level 5:** Mass Production (3 items at full speed)
#### Field Repair (Max 5)
- **Level 5:** Scavenge (Recover 10% materials from broken items)
- **Tier 2 Level 5:** Reclaim (Recover 25% materials)
#### Golem Efficiency (Max 5)
- **Level 5:** Rapid Strikes (+25% speed for first 3 floors)
- **Tier 2 Level 5:** Blitz Attack (+50% speed for first 5 floors)
#### Insight Harvest (Max 5)
- **Level 5:** Insight Bounty (+25% insight from guardians)
- **Tier 2 Level 5:** Greater Harvest (+50% insight from all sources)
---
## Tier System
### How Tiers Work
1. **Reach max level** (10 for most skills, 5 for specialized)
2. **Meet attunement requirements**
3. **Tier up** - Skill resets to level 1 with 10x power multiplier
### Tier Power Scaling
| Tier | Multiplier | Level 1 Power = |
|------|------------|-----------------|
| 1 | 1x | Base |
| 2 | 10x | Tier 1 Level 10 |
| 3 | 100x | Tier 2 Level 10 |
| 4 | 1000x | Tier 3 Level 10 |
| 5 | 10000x | Tier 4 Level 10 |
### Tier Up Requirements
#### Core Skills (Mana, Study)
| Tier | Requirement |
|------|-------------|
| 1→2 | Any attunement level 3 |
@@ -192,7 +462,7 @@ Each tier requires specific attunement levels:
| 3→4 | Any attunement level 7 |
| 4→5 | Any attunement level 10 |
### Enchanter Skills
#### Enchanter Skills
| Tier | Requirement |
|------|-------------|
| 1→2 | Enchanter level 3 |
@@ -200,7 +470,7 @@ Each tier requires specific attunement levels:
| 3→4 | Enchanter level 7 |
| 4→5 | Enchanter level 10 |
### Fabricator Skills (Golemancy)
#### Fabricator Skills (Golemancy)
| Tier | Requirement |
|------|-------------|
| 1→2 | Fabricator level 3 |
@@ -208,116 +478,49 @@ Each tier requires specific attunement levels:
| 3→4 | Fabricator level 7 |
| 4→5 | Fabricator level 10 |
### Hybrid Skills (Multiple Attunements)
| Tier | Requirement |
|------|-------------|
| 1→2 | Both attunements level 3 |
| 2→3 | Both attunements level 5 |
| etc. | Both attunements leveled together |
---
## Upgrade Tree Design Principles
## Banned Content
### Branching Paths
Each skill's upgrade tree should:
1. Offer meaningful choices that change playstyle
2. Allow players to specialize or generalize
3. Provide trade-offs (gain X, lose Y)
4. Scale with future milestone choices
### Upgrade Categories
**Multiplier Upgrades**: Increase the base effect
- Example: "+25% max mana" → "+50% max mana"
**Bonus Upgrades**: Add flat bonuses
- Example: "+0.5 regen" → "+1 regen"
**Special Mechanics**: Unique behaviors
- Example: "Mana Cascade" (+0.1 regen per 100 max mana)
- Example: "Steady Stream" (immune to incursion regen penalty)
**Trade-offs**: Risk/reward
- Example: "+20% max mana, -10% regen"
- Example: "+50% damage when below 50% mana"
### Upgrade Persistence
- **Milestone upgrades persist through tier-ups**
- Tier 2 starts with all Tier 1's chosen upgrades
- New tier offers new upgrade paths
---
## Banned Effects
The following effects are **NOT allowed** in skill upgrades:
The following effects/mechanics are **NOT allowed** in skill upgrades:
| Banned Effect | Reason |
|---------------|--------|
| Lifesteal | Player cannot take damage |
| Healing | Player cannot take damage |
| Healing (for player) | Player cannot take damage |
| Life/Blood/Wood/Mental/Force mana | Removed elements |
| Execution effects | Instant kills bypass gameplay |
| Instant finishing | Skip mechanics |
| Execution effects | Bypasses gameplay mechanics |
| Instant finishing | Skips mechanics |
| Direct spell damage bonuses | Spells only via weapons |
| Familiar system | Replaced by golemancy |
### Design Philosophy
1. **Player cannot take damage** - Only floors/enemies have HP
2. **No healing needed** - Player health doesn't exist
3. **Weapons matter** - Player attacks through enchanted weapons
4. **Golems fight** - Fabricator's constructs do the combat
5. **Enchantments empower** - Enchanter enhances equipment
6. **Pacts grant power** - Invoker makes deals with guardians
---
## Removed Skills
## Example Progression
The following skills have been removed because the player cannot cast offensive spells directly:
### Mana Well Complete Journey
| Removed Skill | Reason |
|---------------|--------|
| Combat Training | No direct spell casting |
| Arcane Fury | Combat damage bonus |
| Precision | Crit chance for spells |
| Quick Cast | Spell cast speed |
| Elemental Mastery | Elemental damage bonus |
| Spell Echo | Spell mechanics |
| Guardian Bane | Direct damage to guardians |
1. **Level 1-4:** +400 max mana (100 per level)
2. **Level 5:** Choose "Expanded Capacity" (+25% max)
- Total: 500 base + 125 bonus = 625 max mana
3. **Level 6-9:** +400 more max mana
4. **Level 10:** Choose "Deep Reservoir" (replaces to +50%)
- Total: 1000 base + 500 bonus = 1500 max mana
5. **Tier Up to Tier 2:** Mana Well becomes "Deep Reservoir"
6. **Tier 2 Level 1:** 100 × 10 = 1000 base (same as T1 L10)
7. **Tier 2 Level 5:** Choose "Abyssal Depth" (+50% max)
8. **Continue progression...**
---
## Implementation Notes
### Study Cost Formula
```
cost = baseCost * (currentLevel + 1) * tier * costMultiplier
```
### Study Time Formula
```
time = baseStudyTime * tier / studySpeedMultiplier
```
### Tier Multiplier
```
tierMultiplier = 10^(tier - 1)
```
- Tier 1: 1x
- Tier 2: 10x
- Tier 3: 100x
- Tier 4: 1000x
- Tier 5: 10000x
---
## Example: Complete Skill Progression
### Mana Well Journey
1. **Study Mana Well** → Level 1 (+100 max mana)
2. **Continue studying** → Level 2-4 (+400 more max mana)
3. **Level 5 Milestone** → Choose "Expanded Capacity" (+25% max mana)
4. **Continue studying** → Level 6-9 (+400 more max mana)
5. **Level 10 Milestone** → Choose "Deep Reservoir" (upgrades Expanded Capacity to +50%)
6. **Tier Up** → Mana Well becomes "Deep Reservoir" (Tier 2)
7. **Continue at Tier 2** → Level 1-5 with 10x multiplier
8. **New upgrades available** at Tier 2 milestones
Total effect at Tier 2, Level 5:
- Base: 500 * 10 = 5000 max mana
- +50% from upgrades: +2500 max mana
- Total: 7500 max mana from one skill!
### Total Power at Tier 2 Level 5:
- Base: 500 × 10 = 5000 max mana
- Upgrades: +50% from Tier 1 +50% from Tier 2 = +100%
- Total: 5000 × 2 = **10,000 max mana**