Dungeons & Enchanting — the crystal loop
Canon
Eternal Crystals are the enchanting fuel. Every enchant burns crystals as its material cost — amounts owner-tuned — and the ratified enchanting authority is otherwise untouched: it never fails, never harms, and the magnitude still rolls. The cost is paid, the result is guaranteed. Crystals are a tradeable material (D-CURRENCY-01), so the enchanting economy runs through the bazaar like any commodity — and in the world's story they are corruption residue: crystallized wound of the shattering (the D-QUESTS-NPCS-05 arc). Every enchantment draws on the thing the Forgers exist to mend.
Crystal sources: gathering nodes and magical enemies on the Violet Crystalshroom island, deep mining in Crystal Depths, dungeon rewards, and Enchantress quest rewards — several loops feed one sink.
The Violet Crystalshroom island is a mid-to-late combat-branch island (Combat Level portal gate, standard rules): corrupted fungal terrain, dark fog, violet glow; magical and fungal creatures paying the standard per-tier MobCoin rolls; Eternal Crystal gathering nodes; the Enchantress (anchor NPC — her questline is quests-npcs content, she guides magical progression and the corruption lore); and the dungeon entrances. It is the corruption's surface bloom — Crystal Depths, the endgame mining island, is its deep root; the two bracket the arc.
Dungeons are an interface, not our system. Instanced dungeons run on the external dungeon mods — their tiers, objectives, scaling, and their instance-world death rules (the 2026-07-16 ruling: players entering instances knowingly accept item risk; out of server-dev scope). Our canon owns exactly three things:
- Entrances — placed in the world (Crystalshroom island first), visually marked, walk-in.
- Keys — where entry requires one, keys are earned items (boss drops, quest rewards, crate loot) and tradeable unless their source says otherwise; the key vocabulary is shared with the crates session.
- The reward boundary — external loot enters our economy as items only: materials (crystals included), cosmetics, gear. No external reward may write progression — no XP, no deeds, no component touches. Anything progression-shaped routes through our config'd pipelines or does not enter.
Decisions
D-DUNGEONS-ENCHANTING-01 — dungeons: we own the interface, external mods own the inside (proposed)
Entrances, keys, and the reward boundary are ours; tiers, scaling, objectives, and instance death rules are the external dungeon mods' (per the standing ruling). The reward boundary is absolute: items in, progression never.
Rejected: building our own dungeon system (contradicts the ruling's scope line; adopts the instance item-death promise problem as ours); deferring dungeons entirely (leaves dungeon-sourced crystals and the Crystalshroom entrances dangling).
D-DUNGEONS-ENCHANTING-02 — Violet Crystalshroom is its own combat-branch island (proposed)
Combat Level gate, hostile creatures, crystal nodes, the Enchantress, the dungeon entrances — the corruption's surface bloom, distinct from Crystal Depths' deep root. Standard combat-island rules throughout (MobCoin rolls, soft-gated interior, encounter taxonomy).
Rejected: folding it into Crystal Depths (mixes hostile magic content into a ruled-peaceful mining island); instance-only existence (loses open-world gathering and the Enchantress's home).
D-DUNGEONS-ENCHANTING-03 — Eternal Crystals fuel enchanting; the authority stands untouched (proposed)
Every enchant consumes crystals — one clean permanent sink, several feeding loops, bazaar-priced. Never-fails, never-harms, magnitude-rolls all unchanged: cost is certain, outcome is certain, only magnitude varies. Lore: crystals are corruption residue — the arc's material signature.
Rejected: crystals gating only high-tier enchants (two-tier system, smaller sink); crystals as magnitude-reroll material (touches the ratified roll design — supersession not worth it); a new enchanting material family (Arcane Dust, Corrupted Shards et al. — Eternal Crystals ship alone, the specialty-essence precedent).
D-DUNGEONS-ENCHANTING-04 — the V1 corpus fate table (proposed)
| V1 idea | Fate |
|---|---|
| Dungeon tiers / objectives / scaling / hardcore modes | External mods' domain (D-DUNGEONS-ENCHANTING-01) |
| Dungeoneer progression / dungeon affinity masteries | Parked — tracking external-mod outcomes needs integration maturity first (carried from D-SKILL-TREES-07) |
| Enchantress questline | Adopted as quests-npcs content (anchor NPC); her quests pay crystals and lore |
| Enchanting material variants (Arcane Dust, Corrupted Shards, Magical Essence) | Rejected — crystals ship alone (D-DUNGEONS-ENCHANTING-03) |
| Crystal variants (Arcane/Corrupted/Pure/Volcanic) | Parked — introduce only if enchanting tuning ever needs a second axis |
| Enchantment skill trees / spell systems / magical abilities | Parked — blocks on the ability-engine probe |
| Dungeon-specific currencies / dungeon reputation | Dead — currency roster is closed (D-CURRENCY-01/08); no reputation system |
| Dungeon leaderboard times | Parked — possible hfrecords boards once external-mod results are readable |
| Fungal world boss / corruption-spreading events | Deferred → events content pass (encounter taxonomy ready) |
| Hidden dungeon rooms / secret content | External mods' domain; Crystalshroom island hidden areas → content pass |
Rejected: designing parked/dead items now.
Tuning
data/dungeons-enchanting.json— enchant crystal costs (per enchant family), crystal node density and respawn, source weights across loops, dungeon entrance registry, key types. Owner-edited; nulls until content passes.- Crystalshroom island entry lands in
data/world-islands.json(combat branch).
Implementation
Enchanting cost wiring is mods/hfenchanting work (a material cost on
the existing single mutation path — the authority's guarantees are
code-level invariants already). Dungeon-entrance placement is world
content; the reward boundary is enforced by what the integration
surfaces — external mods get no provider hooks into progression
components, which the classloader architecture already guarantees.
Crystal nodes ride the same gathering observation paths as ore.
Open questions
- Crystal costs per enchant family and node yields — owner tuning.
- Which external dungeon mod(s) integrate first, and what their loot tables may contain under the reward boundary — integration spec when chosen.
- Key vocabulary details — crates & keys session (shared).
- Whether Crystalshroom hosts a zone boss (fungal — taxonomy ready) — content pass.
- Enchantress questline content — quests-npcs content pass.