PROCEDURAL EQUIPMENT — generation + equipped visuals

STATUS: spec v1 (design locked; implementation is a build task on starborne.html).

Goal: generate most gear from (template × material × gem) with stats from BALANCE.md and a **composed

procedural visual that renders when equipped / used** (in-hand on the hero, body tint, light pool, and an

inventory icon). Quest-unique & chest-unique pieces are hand-authored and skip this generator.

1. GENERATION MODEL buildEquip(template, material, gem, seed) → piece

TEMPLATES
(fixed base shapes per slot, each a procedural draw fn + base factor):
Weapon: sword · axe · hammer · spear · dagger · staff (handedness, reach, swing arc).
Armor: light · medium · heavy · robe. · Light: lantern · lamp · torch. · Tool: pick · hoe · sickle.
Trinket: ring · amulet · charm.
MATERIAL
(one of the 13 RESOURCES, structural): sets the POWER band (metal tier → BALANCE band),

the palette (resource hex → 3 shades + metallic highlight), and feel mods (steel +stagger, leather

+speed/light, gold +arcane/+1 socket, silver +anti-Veil).

GEM
(optional socket): sets an affix (element + stat mod from RESOURCES.md) and a glow accent colour.
STAT roll:
POWER = templateFactor × materialTierFactor × (1 + gemBonus); derive weaponPWR / armorDef /

affix to land in the material's BALANCE band, with a small ±5% variance so drops "roll" (high-roll = the

Minecraft grind chase). Derive secondary stats (reach/speed/socket count) from template + material.

NAME:
"{Material} {Template}[ of {GemAffix}]" → e.g. "Silver Spear of Frost (Sapphire)",

"Gold Amulet of Storm (Topaz)", "Black-Iron Hammer of the Veil (Black Diamond)".

2. EQUIPPED / USED VISUALS (must render in-game)

Compose from layers so any generated piece can be drawn:

Silhouette
the template's procedural path (shape only).
Material fill
palette from the resource hex: dark base → mid → light edge + a metallic specular streak

(leather = matte; gold/silver = bright specular; black diamond = dark with violet sheen).

Gem accent
inlay/pommel/socket drawn in the gem colour with a soft glow.
Use-FX
element on action: Ruby→ember sparks on swing, Sapphire→frost puff, Topaz→spark arc,

Emerald→green motes, Diamond→white flash, Black Diamond→violet blood-wisp (+the blood-bias HP tick).

On the hero: the equipped weapon draws in-hand over the procedural hero (per facing/pose); armor

tints the body layer with the material palette (light→robe drape, heavy→bulkier silhouette); light gear

sets the carried lantern's colour + safe-pool radius. Inventory icon = the same composer at icon scale.

3. IMPLEMENTATION NOTES (for the build pass — not this design phase)

One module: EQUIP_TEMPLATES{}, MATERIALS{} (= RESOURCES palettes/bands), GEMS{} (affix+colour),

buildEquip(t,m,g,seed) returning {id,name,slot,stats,affix, drawIcon(ctx,x,y,s), drawOnHero(ctx,hero,pose)}.

Cache generated pieces by id; persist the id + (t,m,g,seed) in the save (regenerate visuals on load — tiny).
Hook into the existing Gear/Inventory panel + the hero draw (drawGideon/drawLyra) for in-hand + body tint.
Cave drops (CAVES.md) and forge recipes (RESOURCES.md) call buildEquip to mint pieces; bosses can mint a

high-roll. Keep procedural fallbacks; never break the build (comments end-of-line / / / only).

CROSS-REFS

RESOURCES.md (materials/gems) · CAVES.md (where mats come from) · BALANCE.md (POWER bands) · EQUIPMENT.md

(the fixed/uniques + tier ladder this generator fills out) · ITEMS.md (taxonomy).