# Fabricator Attunement — Design Spec

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

---

## 1. Objective

The Fabricator is the crafting and golemancy attunement. It provides access to
Earth-based disciplines that unlock equipment fabrication recipes, golem summoning,
and crafting cost reduction. The Fabricator is the primary source of custom
equipment and the golem combat system.

---

## 2. Identity

| Property | Value |
|---|---|
| **ID** | `fabricator` |
| **Slot** | `leftHand` |
| **Icon** | `⚒️` |
| **Color** | `#F4A261` (Earth) |
| **Primary Mana** | `earth` |
| **Raw Mana Regen** | +0.4/hour (base, scales with `1.5^(level-1)`) |
| **Conversion Rate** | 0.25 raw→earth/hour (base, scales with `1.5^(level-1)`) |
| **Unlock** | Prove crafting worth |
| **Capabilities** | `['golemCrafting', 'gearCrafting', 'earthShaping']` |
| **Skill Categories** | `['fabrication', 'golemancy']` |

---

## 3. Unlock Condition and Flow

**Condition:** Prove your worth as a crafter.

**Unlock flow:**
1. Meet the crafting-related unlock condition
2. Fabricator becomes available for activation
3. Player activates Fabricator → initialized at `{ active: true, level: 1, experience: 0 }`
4. Fabricator disciplines become available (5 total)

The unlock condition is stored as a descriptive string:
`"Prove your worth as a crafter"`

---

## 4. Raw Mana Regen Contribution

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

```
effectiveRegen = 0.4 × 1.5^(level - 1)
```

| Level | Raw Regen |
|---|---|
| 1 | 0.400/hr |
| 5 | 2.025/hr |
| 10 | 15.377/hr |

---

## 5. Mana Conversion Behavior

The Fabricator converts raw mana to Earth:

```
effectiveConversionRate = 0.25 × 1.5^(level - 1)
```

At level 10, the Fabricator converts **9.61 raw→earth/hour**.

---

## 6. Disciplines

The Fabricator's discipline pool contains **5 disciplines**.

### 6.1 Golem Crafting (`golem-crafting`)

| Field | Value |
|---|---|
| **Mana Type** | `earth` |
| **Base Cost** | 10 |
| **Stat Bonus** | `golemCapacity` +2 (base) |
| **Scaling Factor** | 80 |
| **Difficulty Factor** | 150 |
| **Drain Base** | 4 |

**Perks:**

| Perk ID | Type | Threshold | Bonus |
|---|---|---|---|
| `golem-1` | `once` | 200 | Unlock golem summoning |
| `golem-2` | `capped` | 500 | +1 Golem Capacity per tier, interval 500 XP, max 2 tiers |

### 6.2 Crafting Efficiency (`crafting-efficiency`)

| Field | Value |
|---|---|
| **Mana Type** | `earth` |
| **Base Cost** | 12 |
| **Stat Bonus** | `craftingCostReduction` +15 (base) |
| **Scaling Factor** | 90 |
| **Difficulty Factor** | 180 |
| **Drain Base** | 6 |

**Perks:**

| Perk ID | Type | Threshold | Bonus |
|---|---|---|---|
| `efficiency-1` | `once` | 300 | +10% Crafting Cost Reduction |

### 6.3 Study Fabricator Recipes (`study-fabricator-recipes`)

| Field | Value |
|---|---|
| **Mana Type** | `earth` |
| **Base Cost** | 10 |
| **Stat Bonus** | `enchantPower` +3 (base) |
| **Scaling Factor** | 80 |
| **Difficulty Factor** | 100 |
| **Drain Base** | 2 |

**Perks:**

| Perk ID | Type | Threshold | Unlocks |
|---|---|---|---|
| `fabricator-earth` | `once` | 50 | `earthHelm`, `earthChest`, `earthBoots` |
| `fabricator-metal` | `once` | 100 | `metalBlade`, `metalShield`, `metalGloves` |
| `fabricator-sand` | `once` | 150 | `sandBoots`, `sandGloves`, `sandVest` |
| `fabricator-crystal` | `once` | 200 | `crystalWand`, `crystalRing`, `crystalAmulet` |

### 6.4 Study Wizard Equipment (`study-wizard-branch`)

| Field | Value |
|---|---|
| **Mana Type** | `earth` |
| **Base Cost** | 15 |
| **Requires** | `study-fabricator-recipes` |
| **Stat Bonus** | `enchantPower` +5 (base) |
| **Scaling Factor** | 100 |
| **Difficulty Factor** | 150 |
| **Drain Base** | 3 |

**Perks:**

| Perk ID | Type | Threshold | Unlocks |
|---|---|---|---|
| `wizard-oak` | `once` | 50 | `oakStaff` |
| `wizard-arcanist-staff` | `once` | 100 | `arcanistStaff` |
| `wizard-battlestaff` | `once` | 150 | `battlestaff` |
| `wizard-arcanist-gear` | `once` | 200 | `arcanistCirclet`, `arcanistRobe` |
| `wizard-void-catalyst` | `once` | 250 | `voidCatalyst` |
| `wizard-arcanist-pendant` | `once` | 300 | `arcanistPendant` |

### 6.5 Study Physical Equipment (`study-physical-branch`)

| Field | Value |
|---|---|
| **Mana Type** | `earth` |
| **Base Cost** | 15 |
| **Requires** | `study-fabricator-recipes` |
| **Stat Bonus** | `enchantPower` +5 (base) |
| **Scaling Factor** | 100 |
| **Difficulty Factor** | 150 |
| **Drain Base** | 3 |

**Perks:**

| Perk ID | Type | Threshold | Unlocks |
|---|---|---|---|
| `physical-crystal-blade` | `once` | 50 | `crystalBlade` |
| `physical-arcanist-blade` | `once` | 100 | `arcanistBlade` |
| `physical-void-blade` | `once` | 150 | `voidBlade` |
| `physical-battle-gear` | `once` | 200 | `battleHelm`, `battleRobe` |
| `physical-battle-boots` | `once` | 250 | `battleBoots` |
| `physical-combat-gauntlets` | `once` | 300 | `combatGauntlets` |

---

## 7. Systems Unlocked

The Fabricator attunement gates two systems:

1. **Golemancy** (see `golemancy-spec.md`): Summon and maintain golems for spire combat
2. **Item Fabrication** (see `item-fabrication-spec.md`): Craft equipment and materials from recipes

---

## 8. Puzzle Room Behavior

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

---

## 9. Attunement Level Interactions

Higher Fabricator level affects:

1. **Raw mana regen**: `0.4 × 1.5^(level-1)` per hour
2. **Earth conversion rate**: `0.25 × 1.5^(level-1)` per hour
3. **Golem slots**: `floor(fabricatorLevel / 2)` — Fabricator level directly determines golem capacity

| Fabricator Level | Golem Slots |
|---|---|
| 1 | 0 |
| 2–3 | 1 |
| 4–5 | 2 |
| 6–7 | 3 |
| 8–9 | 4 |
| 10 | 5 |

---

## 10. Discipline Dependency Chain

```
golem-crafting                  (root)
crafting-efficiency             (root)
study-fabricator-recipes        (root)
  └── study-wizard-branch
  └── study-physical-branch
```

3 root disciplines. Maximum dependency depth: 2.

---

## 11. Acceptance Criteria

| # | Criterion |
|---|---|
| AC-1 | Fabricator is locked until the unlock condition is met. |
| AC-2 | All 5 Fabricator disciplines are available when Fabricator is active. |
| AC-3 | `study-wizard-branch` and `study-physical-branch` require `study-fabricator-recipes`. |
| AC-4 | Golem summoning is unlocked at Golem Crafting discipline threshold 200 XP. |
| AC-5 | Golem capacity is 2 (base) + up to 2 (from capped perk) = max 4 from disciplines. |
| AC-6 | Golem slots from attunement level: `floor(fabricatorLevel / 2)`, max 5 at level 10. |
| AC-7 | All recipe unlock perks fire at the correct discipline XP thresholds. |
| AC-8 | Crafting Efficiency discipline reduces material costs by 15% (base) + 10% (perk). |
| AC-9 | Fabricator `fabricator_trial` puzzle rooms grant bonus progress per Fabricator level. |
| AC-10 | Fabricator level scales raw regen and earth conversion by `1.5^(level-1)`. |

---

## 12. Files Reference

| File | Role |
|---|---|
| `src/lib/game/data/attunements.ts` | Fabricator definition |
| `src/lib/game/data/disciplines/fabricator.ts` | Fabricator disciplines (5) |
| `src/lib/game/data/golems/` | Golem component definitions (4 cores, 7 frames, 4 mind circuits, 8 enchantments) |
| `src/lib/game/crafting-fabricator.ts` | Fabrication crafting logic |
| `src/lib/game/data/fabricator-recipes.ts` | Core equipment recipes |
| `src/lib/game/data/fabricator-material-recipes.ts` | Material recipes |
| `src/lib/game/data/fabricator-physical-recipes.ts` | Physical branch recipes |
| `src/lib/game/data/fabricator-wizard-recipes.ts` | Wizard branch recipes |
| `src/components/game/tabs/GolemancyTab.tsx` | Golemancy UI |
| `docs/specs/attunements/fabricator/systems/golemancy-spec.md` | Golemancy system spec |
| `docs/specs/attunements/fabricator/systems/item-fabrication-spec.md` | Item fabrication spec |
