Mana-Loop/docs/specs/attunements/enchanter/enchanter-spec.md

Enchanter Attunement — Design Spec

Describes the Enchanter attunement: identity, unlock flow, mana behavior, full discipline list with stats/perks, systems unlocked, and attunement level interactions.

---

1. Objective

The Enchanter is the starting attunement and the gateway to the enchanting system. It provides access to Transference-based disciplines that unlock enchantment effects, boost enchantment power, and provide study/utility bonuses. The Enchanter is always the first attunement a player uses, and it remains relevant throughout all stages of the game through its 10 disciplines and the deep enchanting pipeline.

---

2. Identity

Property	Value
ID	enchanter
Slot	rightHand
Icon	✨
Color	#1ABC9C (Teal)
Primary Mana	transference
Raw Mana Regen	+0.5/hour (base, scales with 1.5^(level-1))
Conversion Rate	0.2 raw→transference/hour (base, scales with 1.5^(level-1))
Unlock	Starting attunement (unlocked by default)
Capabilities	['enchanting']
Skill Categories	['enchant', 'effectResearch']

---

3. Unlock Condition and Flow

The Enchanter is always unlocked — it is present in the initial game state:

attunements: {
  enchanter: { id: 'enchanter', active: true, level: 1, experience: 0 }
}

No unlock flow is required. The player begins the game with Enchanter active.

---

4. Raw Mana Regen Contribution

Base regen: +0.5/hour (at level 1). Scales exponentially:

effectiveRegen = 0.5 × 1.5^(level - 1)

Level	Raw Regen
1	0.500/hr
5	2.531/hr
10	19.221/hr

---

5. Mana Conversion Behavior

The Enchanter is the only attunement that converts raw mana to Transference:

effectiveConversionRate = 0.2 × 1.5^(level - 1)

This is an automatic per-hour conversion. Each tick:

• 0.2 × 1.5^(level-1) × HOURS_PER_TICK raw mana is consumed
• The same amount is added to the Transference mana pool

At level 10, the Enchanter converts 7.69 raw→transference/hour.

---

6. Disciplines

The Enchanter's discipline pool contains 10 disciplines across 4 files.

6.1 Core Disciplines (enchanter.ts) — 4 disciplines

Enchantment Crafting (enchant-crafting)

Field	Value
Mana Type	transference
Base Cost	8
Stat Bonus	enchantPower +8 (base)
Scaling Factor	60
Difficulty Factor	120
Drain Base	3

Perk ID	Type	Threshold	Bonus
enchant-1	infinite	150	+5 enchantPower per tier (repeats every 150 XP)
enchant-2	capped	300	+10 enchantPower per tier, interval 200 XP, max 3 tiers

Mana Channeling (mana-channeling)

Field	Value
Mana Type	transference
Base Cost	12
Stat Bonus	clickManaMultiplier +0.3 (base)
Scaling Factor	90
Difficulty Factor	180
Drain Base	5

Perk ID	Type	Threshold	Bonus
channel-1	once	250	elementCap_lightning +15

Study Basic Weapon Enchantments (study-basic-weapon-enchantments)

Field	Value
Mana Type	transference
Base Cost	10
Stat Bonus	enchantPower +3 (base)
Scaling Factor	80
Difficulty Factor	100
Drain Base	2

Perk ID	Type	Threshold	Unlocks
basic-weapon-fire	once	50	sword_fire
basic-weapon-frost	once	100	sword_frost
basic-weapon-lightning	once	150	sword_lightning

Study Advanced Weapon Enchantments (study-advanced-weapon-enchantments)

Field	Value
Mana Type	transference
Base Cost	20
Requires	study-basic-weapon-enchantments
Stat Bonus	enchantPower +5 (base)
Scaling Factor	120
Difficulty Factor	200
Drain Base	4

Perk ID	Type	Threshold	Unlocks
advanced-weapon-void	once	100	sword_void
advanced-weapon-damage-5	once	150	damage_5
advanced-weapon-crit	once	200	crit_5
advanced-weapon-attack-speed	once	250	attack_speed_10

6.2 Utility Disciplines (enchanter-utility.ts) — 2 disciplines

Study Utility Enchantments (study-utility-enchantments)

Field	Value
Mana Type	transference
Base Cost	8
Stat Bonus	studySpeed +0.05 (base)
Scaling Factor	60
Difficulty Factor	80
Drain Base	2

Perk ID	Type	Threshold	Unlocks
utility-meditate	once	50	meditate_10
utility-study	once	100	study_10
utility-insight	once	150	insight_5

Study Mana Enchantments (study-mana-enchantments)

Field	Value
Mana Type	transference
Base Cost	15
Stat Bonus	maxManaBonus +10 (base)
Scaling Factor	100
Difficulty Factor	150
Drain Base	3

Perk ID	Type	Threshold	Unlocks
mana-cap-50	once	75	mana_cap_50
mana-cap-100	once	150	mana_cap_100
mana-regen-1	once	100	mana_regen_1
mana-regen-2	once	200	mana_regen_2
click-mana-1	once	125	click_mana_1
click-mana-3	once	225	click_mana_3

6.3 Spell Disciplines (enchanter-spells.ts) — 3 disciplines

Study Basic Spell Enchantments (study-basic-spell-enchantments)

Field	Value
Mana Type	transference
Base Cost	18
Stat Bonus	enchantPower +4 (base)
Scaling Factor	100
Difficulty Factor	160
Drain Base	3

Perk ID	Type	Threshold	Unlocks
spell-mana-bolt	once	50	spell_manaBolt
spell-fireball	once	100	spell_fireball
spell-water-jet	once	100	spell_waterJet
spell-gust	once	100	spell_gust
spell-stone-bullet	once	100	spell_stoneBullet
spell-light-lance	once	150	spell_lightLance
spell-shadow-bolt	once	150	spell_shadowBolt
spell-drain	once	150	spell_drain

Study Intermediate Spell Enchantments (study-intermediate-spell-enchantments)

Field	Value
Mana Type	transference
Base Cost	25
Requires	study-basic-spell-enchantments
Stat Bonus	enchantPower +6 (base)
Scaling Factor	150
Difficulty Factor	250
Drain Base	5

Perk ID	Type	Threshold	Unlocks
spell-inferno	once	100	spell_inferno
spell-tidal-wave	once	100	spell_tidalWave
spell-earthquake	once	120	spell_earthquake
spell-chain-lightning	once	100	spell_chainLightning
spell-metal-shard	once	80	spell_metalShard
spell-sand-blast	once	80	spell_sandBlast

Study Advanced Spell Enchantments (study-advanced-spell-enchantments)

Field	Value
Mana Type	transference
Base Cost	35
Requires	study-intermediate-spell-enchantments
Stat Bonus	enchantPower +10 (base)
Scaling Factor	200
Difficulty Factor	350
Drain Base	7

Perk ID	Type	Threshold	Unlocks
spell-pyroclasm	once	100	spell_pyroclasm
spell-tsunami	once	100	spell_tsunami
spell-meteor-strike	once	120	spell_meteorStrike
spell-heaven-light	once	100	spell_heavenLight
spell-oblivion	once	100	spell_oblivion
spell-furnace-blast	once	100	spell_furnaceBlast
spell-dune-collapse	once	100	spell_duneCollapse
spell-stellar-nova	once	200	spell_stellarNova
spell-void-collapse	once	180	spell_voidCollapse
spell-crystal-shatter	once	160	spell_crystalShatter

6.4 Special Discipline (enchanter-special.ts) — 1 discipline

Study Special Enchantments (study-special-enchantments)

Field	Value
Mana Type	transference
Base Cost	22
Requires	study-advanced-weapon-enchantments
Stat Bonus	enchantPower +5 (base)
Scaling Factor	130
Difficulty Factor	220
Drain Base	4

Perk ID	Type	Threshold	Unlocks
special-spell-echo	once	100	spell_echo_10
special-guardian-dmg	once	80	guardian_dmg_10
special-overpower	once	150	overpower_80
special-first-strike	once	120	first_strike
special-combo-master	once	200	combo_master
special-adrenaline-rush	once	180	adrenaline_rush

---

7. Systems Unlocked

The Enchanter attunement gates the Enchanting System (see enchanting-spec.md):

• Design stage: Create named enchantment designs
• Prepare stage: Clear existing enchantments, ready equipment
• Apply stage: Apply saved designs to prepared equipment

---

8. Puzzle Room Behavior

In the spire, every 7th floor has a puzzle room. When the room type is enchanter_trial, progress scales at 2.5–3% per tick per Enchanter level.

---

9. Attunement Level Interactions

Higher Enchanter level affects:

1. Raw mana regen: 0.5 × 1.5^(level-1) per hour
2. Transference conversion rate: 0.2 × 1.5^(level-1) per hour
3. Enchanting XP → Attunement XP: Enchanting awards Enchanter XP (1 per 10 capacity used), feeding back into leveling

Attunement level does not directly affect enchantment strength or discipline power — those scale through discipline XP alone.

---

10. Discipline Dependency Chain

enchant-crafting                     (root)
mana-channeling                      (root)
study-basic-weapon-enchantments      (root)
  └── study-advanced-weapon-enchantments
        └── study-special-enchantments
study-utility-enchantments           (root)
study-mana-enchantments              (root)
study-basic-spell-enchantments       (root)
  └── study-intermediate-spell-enchantments
        └── study-advanced-spell-enchantments

6 root disciplines. Maximum dependency depth: 3.

---

11. Acceptance Criteria

#	Criterion
AC-1	Enchanter starts unlocked at level 1 with 0 XP.
AC-2	All 10 Enchanter disciplines are available when Enchanter is active.
AC-3	Discipline dependency chains are enforced — Advanced Weapon Enchantments requires Basic Weapon Enchantments.
AC-4	All perk thresholds unlock the correct enchantment effects at the specified XP values.
AC-5	Enchantment Power stat bonus from all active Enchanter disciplines stacks additively.
AC-6	The enchant-1 infinite perk grants +5 enchantPower every 150 XP beyond threshold.
AC-7	The enchant-2 capped perk grants +10 enchantPower per tier, max 3 tiers, interval 200 XP beyond threshold.
AC-8	Enchanting system is accessible when Enchanter is active, locked when inactive.
AC-9	Enchanter enchanter_trial puzzle rooms grant bonus progress per Enchanter level.
AC-10	Enchanter level scales raw regen and conversion rate by 1.5^(level-1).

---

12. Files Reference

File	Role
src/lib/game/data/attunements.ts	Enchanter definition
src/lib/game/data/disciplines/enchanter.ts	Core Enchanter disciplines (4)
src/lib/game/data/disciplines/enchanter-utility.ts	Utility enchantment disciplines (2)
src/lib/game/data/disciplines/enchanter-spells.ts	Spell enchantment disciplines (3)
src/lib/game/data/disciplines/enchanter-special.ts	Special enchantment discipline (1)
docs/specs/attunements/enchanter/systems/enchanting-spec.md	Enchanting system spec