/** * Metal materials (and coal) — name, tint, rank, and skill gates. * Equip min level is the tier gate; mining = half (ceil), smelting = 75% (ceil). */ export const MaterialTier = Object.freeze({ bronze: "bronze", iron: "iron", steel: "steel", mithril: "mithril", adamantium: "adamantium", orichalcum: "orichalcum", dragon: "dragon" }); /** * Wood materials — same ranks / skill gates as metals (gather with axe later). * Matching metal: pine↔bronze … elder↔dragon. */ export const WoodTier = Object.freeze({ pine: "pine", birch: "birch", oak: "oak", ebony: "ebony", lignum: "lignum", heartwood: "heartwood", elder: "elder" }); /** * Cloth / fibre tiers (tailoring). Gathering methods vary (plant / shear / drop); * ranks and equip gates match metal / wood. */ export const ClothTier = Object.freeze({ cotton: "cotton", wool: "wool", linen: "linen", cashmere: "cashmere", silk: "silk", fairySilk: "fairySilk", dragonweave: "dragonweave" }); /** Ordered low → high (metal smithing / tools). */ export const MATERIAL_TIER_ORDER = Object.freeze([ MaterialTier.bronze, MaterialTier.iron, MaterialTier.steel, MaterialTier.mithril, MaterialTier.adamantium, MaterialTier.orichalcum, MaterialTier.dragon ]); /** Ordered low → high (woodcutting / woodcraft). */ export const WOOD_TIER_ORDER = Object.freeze([ WoodTier.pine, WoodTier.birch, WoodTier.oak, WoodTier.ebony, WoodTier.lignum, WoodTier.heartwood, WoodTier.elder ]); /** Ordered low → high (tailoring). */ export const CLOTH_TIER_ORDER = Object.freeze([ ClothTier.cotton, ClothTier.wool, ClothTier.linen, ClothTier.cashmere, ClothTier.silk, ClothTier.fairySilk, ClothTier.dragonweave ]); /** * Gatherable ores / fuels that are not always 1:1 with a gear tier. * Tin + copper smelt into bronze; coal fuels steel. Gold and silver have ore + * bars but no tools (jewelry / future recipes). Mine/smelt timing uses * {@link associatedBarTier}. */ export const GatherMaterialId = Object.freeze({ ...MaterialTier, tin: "tin", copper: "copper", coal: "coal", silver: "silver", gold: "gold" }); /** Minimum relevant skill level required to equip tools/gear of this tier. */ export const TIER_MIN_SKILL_LEVEL = Object.freeze({ [MaterialTier.bronze]: 1, [MaterialTier.iron]: 10, [MaterialTier.steel]: 20, [MaterialTier.mithril]: 35, [MaterialTier.adamantium]: 50, [MaterialTier.orichalcum]: 70, [MaterialTier.dragon]: 90, [GatherMaterialId.silver]: 10, [GatherMaterialId.gold]: 20, [WoodTier.pine]: 1, [WoodTier.birch]: 10, [WoodTier.oak]: 20, [WoodTier.ebony]: 35, [WoodTier.lignum]: 50, [WoodTier.heartwood]: 70, [WoodTier.elder]: 90, [ClothTier.cotton]: 1, [ClothTier.wool]: 10, [ClothTier.linen]: 20, [ClothTier.cashmere]: 35, [ClothTier.silk]: 50, [ClothTier.fairySilk]: 70, [ClothTier.dragonweave]: 90 }); /** Rank used for mining duration and relative power (1 = bronze/pine … 7 = dragon/elder). */ export const TIER_RANK = Object.freeze({ [MaterialTier.bronze]: 1, [MaterialTier.iron]: 2, [MaterialTier.steel]: 3, [MaterialTier.mithril]: 4, [MaterialTier.adamantium]: 5, [MaterialTier.orichalcum]: 6, [MaterialTier.dragon]: 7, [GatherMaterialId.silver]: 2, [GatherMaterialId.gold]: 3, [WoodTier.pine]: 1, [WoodTier.birch]: 2, [WoodTier.oak]: 3, [WoodTier.ebony]: 4, [WoodTier.lignum]: 5, [WoodTier.heartwood]: 6, [WoodTier.elder]: 7, [ClothTier.cotton]: 1, [ClothTier.wool]: 2, [ClothTier.linen]: 3, [ClothTier.cashmere]: 4, [ClothTier.silk]: 5, [ClothTier.fairySilk]: 6, [ClothTier.dragonweave]: 7 }); /** Stat bonus granted by tier for the equipment's bonus category. */ export const TIER_STAT_BONUS = Object.freeze({ [MaterialTier.bronze]: 1, [MaterialTier.iron]: 2, [MaterialTier.steel]: 4, [MaterialTier.mithril]: 6, [MaterialTier.adamantium]: 8, [MaterialTier.orichalcum]: 10, [MaterialTier.dragon]: 12, [WoodTier.pine]: 1, [WoodTier.birch]: 2, [WoodTier.oak]: 4, [WoodTier.ebony]: 6, [WoodTier.lignum]: 8, [WoodTier.heartwood]: 10, [WoodTier.elder]: 12, [ClothTier.cotton]: 1, [ClothTier.wool]: 2, [ClothTier.linen]: 4, [ClothTier.cashmere]: 6, [ClothTier.silk]: 8, [ClothTier.fairySilk]: 10, [ClothTier.dragonweave]: 12 }); /** Display names for UI / editor. */ export const MATERIAL_DISPLAY_NAME = Object.freeze({ [MaterialTier.bronze]: "Bronze", [MaterialTier.iron]: "Iron", [MaterialTier.steel]: "Steel", [MaterialTier.mithril]: "Mithril", [MaterialTier.adamantium]: "Adamantium", [MaterialTier.orichalcum]: "Orichalcum", [MaterialTier.dragon]: "Dragon", [GatherMaterialId.tin]: "Tin", [GatherMaterialId.copper]: "Copper", [GatherMaterialId.coal]: "Coal", [GatherMaterialId.silver]: "Silver", [GatherMaterialId.gold]: "Gold", [WoodTier.pine]: "Pine", [WoodTier.birch]: "Birch", [WoodTier.oak]: "Oak", [WoodTier.ebony]: "Ebony", [WoodTier.lignum]: "Lignum", [WoodTier.heartwood]: "Heartwood", [WoodTier.elder]: "Elder" }); export const CLOTH_DISPLAY_NAME = Object.freeze({ [ClothTier.cotton]: "Cotton", [ClothTier.wool]: "Wool", [ClothTier.linen]: "Linen", [ClothTier.cashmere]: "Cashmere", [ClothTier.silk]: "Silk", [ClothTier.fairySilk]: "Fairy silk", [ClothTier.dragonweave]: "Dragonweave" }); /** * Author tint swatches via {@link rgb} (0–255) so editors can offer a colour picker. * Also accepts `0xRRGGBB` / `"#RRGGBB"`; all forms become 0–1 RGB at module load. * Steel is slightly darker than iron; silver is bright gray; gold is yellow; * orichalcum is coppery; dragon is red. */ export function rgb (r, g, b) { return Object.freeze({ r: clampByte(r) / 255, g: clampByte(g) / 255, b: clampByte(b) / 255 }); } function clampByte (n) { return Math.min(255, Math.max(0, Math.round(Number(n) || 0))); } export const MATERIAL_TINT_HEX = Object.freeze({ [MaterialTier.bronze]: rgb(184, 122, 71), [MaterialTier.iron]: rgb(158, 163, 173), [MaterialTier.steel]: rgb(75, 76, 80), [MaterialTier.mithril]: rgb(3, 120, 255), [MaterialTier.adamantium]: rgb(108, 202, 132), [MaterialTier.orichalcum]: rgb(230, 140, 31), [MaterialTier.dragon]: rgb(228, 19, 15), [GatherMaterialId.tin]: rgb(221, 221, 221), [GatherMaterialId.copper]: rgb(255, 94, 0), [GatherMaterialId.coal]: rgb(45, 45, 48), [GatherMaterialId.silver]: rgb(214, 220, 230), [GatherMaterialId.gold]: rgb(255, 200, 0), [WoodTier.pine]: rgb(199, 158, 97), [WoodTier.birch]: rgb(224, 209, 173), [WoodTier.oak]: rgb(158, 107, 61), [WoodTier.ebony]: rgb(56, 41, 51), [WoodTier.lignum]: rgb(107, 97, 56), [WoodTier.heartwood]: rgb(184, 71, 56), [WoodTier.elder]: rgb(184, 189, 199), [ClothTier.cotton]: rgb(245, 240, 230), [ClothTier.wool]: rgb(220, 210, 195), [ClothTier.linen]: rgb(200, 185, 140), [ClothTier.cashmere]: rgb(210, 175, 150), [ClothTier.silk]: rgb(230, 220, 240), [ClothTier.fairySilk]: rgb(180, 230, 255), [ClothTier.dragonweave]: rgb(200, 60, 50) }); /** * Optional ore-only tint overrides (boulders + ore items). * Missing entries fall back to {@link MATERIAL_TINT_HEX}. */ export const MATERIAL_ORE_TINT_HEX = Object.freeze({ [MaterialTier.iron]: rgb(210, 118, 48), [GatherMaterialId.copper]: rgb(81, 153, 105) }); /** * Normalize tint authoring forms to frozen 0–1 `{ r, g, b }`: * - number `0xRRGGBB` * - string `"#RGB"` / `"#RRGGBB"` / `"rgb(r,g,b)"` * - object from {@link rgb} */ export function hexToRgb01 (hex) { if (hex && typeof hex === "object" && "r" in hex && "g" in hex && "b" in hex) { return Object.freeze({ r: clamp01Channel(hex.r), g: clamp01Channel(hex.g), b: clamp01Channel(hex.b) }); } if (typeof hex === "number" && Number.isFinite(hex)) { const value = hex >>> 0; return Object.freeze({ r: ((value >> 16) & 255) / 255, g: ((value >> 8) & 255) / 255, b: (value & 255) / 255 }); } const text = String(hex ?? "").trim(); const rgbMatch = /^rgba?\(\s*([0-9.]+)\s*,\s*([0-9.]+)\s*,\s*([0-9.]+)/i.exec(text); if (rgbMatch) { return rgb(rgbMatch[1], rgbMatch[2], rgbMatch[3]); } const raw = text.replace(/^#/, ""); const full = raw.length === 3 ? raw.split("").map((ch) => ch + ch).join("") : raw; if (!/^[0-9a-fA-F]{6}$/.test(full)) { return Object.freeze({ r: 0.7, g: 0.7, b: 0.7 }); } const value = Number.parseInt(full, 16); return Object.freeze({ r: ((value >> 16) & 255) / 255, g: ((value >> 8) & 255) / 255, b: (value & 255) / 255 }); } function clamp01Channel (n) { const value = Number(n); if (!Number.isFinite(value)) { return 0; } if (value > 1) { return clampByte(value) / 255; } return Math.min(1, Math.max(0, value)); } /** 0–1 RGB map derived from {@link MATERIAL_TINT_HEX}. */ export const MATERIAL_TINT_COLOR = Object.freeze( Object.fromEntries( Object.entries(MATERIAL_TINT_HEX).map(([id, hex]) => [id, hexToRgb01(hex)]) ) ); /** 0–1 RGB map derived from {@link MATERIAL_ORE_TINT_HEX}. */ export const MATERIAL_ORE_TINT_COLOR = Object.freeze( Object.fromEntries( Object.entries(MATERIAL_ORE_TINT_HEX).map(([id, hex]) => [id, hexToRgb01(hex)]) ) ); /** Wood tier that matches a metal tier's rank (for tool hafts). */ export const WOOD_TIER_FOR_METAL = Object.freeze({ [MaterialTier.bronze]: WoodTier.pine, [MaterialTier.iron]: WoodTier.birch, [MaterialTier.steel]: WoodTier.oak, [MaterialTier.mithril]: WoodTier.ebony, [MaterialTier.adamantium]: WoodTier.lignum, [MaterialTier.orichalcum]: WoodTier.heartwood, [MaterialTier.dragon]: WoodTier.elder }); export const METAL_TIER_FOR_WOOD = Object.freeze(Object.fromEntries( Object.entries(WOOD_TIER_FOR_METAL).map(([metal, wood]) => [wood, metal]) )); /** * Bar tier that drives mine/smelt duration and gates for a gatherable. * Tin/copper → bronze; coal → steel; gold/silver and gear metals map to themselves. */ export function associatedBarTier (materialId) { if (materialId === GatherMaterialId.tin || materialId === GatherMaterialId.copper) { return MaterialTier.bronze; } if (materialId === GatherMaterialId.coal) { return MaterialTier.steel; } return materialId; } export function materialDisplayName (materialId) { return MATERIAL_DISPLAY_NAME[materialId] ?? materialId; } /** * Tint for a material. When `ore` is true, prefer {@link MATERIAL_ORE_TINT_COLOR} * if defined for that material; otherwise the normal material tint. */ export function materialTintColor (materialId, { ore = false } = {}) { if (ore) { const oreTint = MATERIAL_ORE_TINT_COLOR[materialId]; if (oreTint) { return oreTint; } } return MATERIAL_TINT_COLOR[materialId] ?? MATERIAL_TINT_COLOR[MaterialTier.bronze]; } export function tierStatBonus (tier) { return TIER_STAT_BONUS[tier] ?? TIER_STAT_BONUS[MaterialTier.bronze]; } export function tierMinSkillLevel (tier) { return TIER_MIN_SKILL_LEVEL[tier] ?? TIER_MIN_SKILL_LEVEL[MaterialTier.bronze]; } export function tierRank (tier) { return TIER_RANK[associatedBarTier(tier)] ?? TIER_RANK[tier] ?? 1; } /** Mining / woodcutting skill required (half of equip gate, ceil). */ export function tierMineSkillLevel (tier) { return Math.max(1, Math.ceil(tierMinSkillLevel(associatedBarTier(tier)) / 2)); } /** Smithing / woodcraft skill required to process this material (75% of equip gate, ceil). */ export function tierSmeltSkillLevel (tier) { return Math.max(1, Math.ceil(tierMinSkillLevel(associatedBarTier(tier)) * 0.75)); } /** Alias for woodworking / general craft gates (same curve as smelting). */ export function tierCraftSkillLevel (tier) { return tierSmeltSkillLevel(tier); } export function woodTierForMetal (metalTier) { return WOOD_TIER_FOR_METAL[metalTier] ?? WoodTier.pine; } export function metalTierForWood (woodTier) { return METAL_TIER_FOR_WOOD[woodTier] ?? MaterialTier.bronze; } /** * Mining action duration in ms. * (resourceRank * 8s) − (toolRank * 3s), floored at 0.5s. * Tin/copper/coal use their associated bar's rank. */ export function miningDurationMs (resourceMaterialId, toolTier) { const resourceRank = tierRank(resourceMaterialId); const toolRank = tierRank(toolTier); const seconds = Math.max(0.5, resourceRank * 8 - toolRank * 3); return Math.round(seconds * 1000); } /** After a successful mine, nodes stay exhausted for 10s × associated bar rank. */ export function oreExhaustDurationMs (materialId) { return Math.max(1, tierRank(materialId)) * 10_000; } /** Base craft duration per bar rank (bronze = 2s, iron = 4s, …). */ export const SMELT_DURATION_PER_RANK_MS = 2000; /** * Furnace smelt duration from the output bar's associated tier rank. * Tin/copper/coal map to bronze/steel so ingredient timing matches that bar. */ export function smeltingDurationMs (barOrMaterialId) { return Math.max(1, tierRank(barOrMaterialId)) * SMELT_DURATION_PER_RANK_MS; } /** Visual / interact state while an ore boulder is depleted (plain rock). */ export const EXHAUSTED_ORE_BOULDER_STATE = "boulder"; /** * Materials that have an ore boulder node. * Bronze has no ore (tin + copper); steel has no ore (iron + coal). * Gold and silver are precious only (ore + bars, no tools). */ export const ORE_BEARING_MATERIALS = Object.freeze([ GatherMaterialId.tin, GatherMaterialId.copper, MaterialTier.iron, GatherMaterialId.silver, GatherMaterialId.gold, MaterialTier.mithril, MaterialTier.adamantium, MaterialTier.orichalcum, MaterialTier.dragon, GatherMaterialId.coal ]); /** Boulder visual state for a gatherable ore (editor / world). */ export function oreBoulderState (materialId) { if (materialId === GatherMaterialId.coal) { return "coal"; } return `${materialId}-ore`; } export function materialFromOreBoulderState (state) { if (!state || state === "boulder") { return null; } if (state === "coal") { return GatherMaterialId.coal; } if (state.endsWith("-ore")) { const id = state.slice(0, -"-ore".length); if (ORE_BEARING_MATERIALS.includes(id)) { return id; } } return null; } export function isOreBoulderState (state) { return materialFromOreBoulderState(state) != null; }