BlueGit

timfa questward

Files

questward / shared / definitions / materialTiers.js

materialTiers.js

materialTiers.js 9.3 KiB Download Raw
1/**
2 * Metal materials (and coal) — name, tint, rank, and skill gates.
3 * Equip min level is the tier gate; mining = half (ceil), smelting = 75% (ceil).
4 */
5export const MaterialTier = Object.freeze({
6 bronze: "bronze",
7 iron: "iron",
8 steel: "steel",
9 mithril: "mithril",
10 adamantium: "adamantium",
11 orichalcum: "orichalcum",
12 dragon: "dragon"
13});
14
15/**
16 * Wood materials — same ranks / skill gates as metals (gather with axe later).
17 * Matching metal: pine↔bronze … elder↔dragon.
18 */
19export const WoodTier = Object.freeze({
20 pine: "pine",
21 birch: "birch",
22 oak: "oak",
23 ebony: "ebony",
24 lignum: "lignum",
25 heartwood: "heartwood",
26 elder: "elder"
27});
28
29/** Ordered low → high (metal smithing / tools). */
30export const MATERIAL_TIER_ORDER = Object.freeze([
31 MaterialTier.bronze,
32 MaterialTier.iron,
33 MaterialTier.steel,
34 MaterialTier.mithril,
35 MaterialTier.adamantium,
36 MaterialTier.orichalcum,
37 MaterialTier.dragon
38]);
39
40/** Ordered low → high (woodcutting / woodcraft). */
41export const WOOD_TIER_ORDER = Object.freeze([
42 WoodTier.pine,
43 WoodTier.birch,
44 WoodTier.oak,
45 WoodTier.ebony,
46 WoodTier.lignum,
47 WoodTier.heartwood,
48 WoodTier.elder
49]);
50
51/**
52 * Gatherable ores / fuels that are not always 1:1 with a gear tier.
53 * Tin + copper smelt into bronze; coal fuels steel. Their mine/smelt timing
54 * uses {@link associatedBarTier}.
55 */
56export const GatherMaterialId = Object.freeze({
57 ...MaterialTier,
58 tin: "tin",
59 copper: "copper",
60 coal: "coal"
61});
62
63/** Minimum relevant skill level required to equip tools/gear of this tier. */
64export const TIER_MIN_SKILL_LEVEL = Object.freeze({
65 [MaterialTier.bronze]: 1,
66 [MaterialTier.iron]: 10,
67 [MaterialTier.steel]: 20,
68 [MaterialTier.mithril]: 35,
69 [MaterialTier.adamantium]: 50,
70 [MaterialTier.orichalcum]: 70,
71 [MaterialTier.dragon]: 90,
72 [WoodTier.pine]: 1,
73 [WoodTier.birch]: 10,
74 [WoodTier.oak]: 20,
75 [WoodTier.ebony]: 35,
76 [WoodTier.lignum]: 50,
77 [WoodTier.heartwood]: 70,
78 [WoodTier.elder]: 90
79});
80
81/** Rank used for mining duration and relative power (1 = bronze/pine … 7 = dragon/elder). */
82export const TIER_RANK = Object.freeze({
83 [MaterialTier.bronze]: 1,
84 [MaterialTier.iron]: 2,
85 [MaterialTier.steel]: 3,
86 [MaterialTier.mithril]: 4,
87 [MaterialTier.adamantium]: 5,
88 [MaterialTier.orichalcum]: 6,
89 [MaterialTier.dragon]: 7,
90 [WoodTier.pine]: 1,
91 [WoodTier.birch]: 2,
92 [WoodTier.oak]: 3,
93 [WoodTier.ebony]: 4,
94 [WoodTier.lignum]: 5,
95 [WoodTier.heartwood]: 6,
96 [WoodTier.elder]: 7
97});
98
99/** Stat bonus granted by tier for the equipment's bonus category. */
100export const TIER_STAT_BONUS = Object.freeze({
101 [MaterialTier.bronze]: 1,
102 [MaterialTier.iron]: 2,
103 [MaterialTier.steel]: 4,
104 [MaterialTier.mithril]: 6,
105 [MaterialTier.adamantium]: 8,
106 [MaterialTier.orichalcum]: 10,
107 [MaterialTier.dragon]: 12,
108 [WoodTier.pine]: 1,
109 [WoodTier.birch]: 2,
110 [WoodTier.oak]: 4,
111 [WoodTier.ebony]: 6,
112 [WoodTier.lignum]: 8,
113 [WoodTier.heartwood]: 10,
114 [WoodTier.elder]: 12
115});
116
117/** Display names for UI / editor. */
118export const MATERIAL_DISPLAY_NAME = Object.freeze({
119 [MaterialTier.bronze]: "Bronze",
120 [MaterialTier.iron]: "Iron",
121 [MaterialTier.steel]: "Steel",
122 [MaterialTier.mithril]: "Mithril",
123 [MaterialTier.adamantium]: "Adamantium",
124 [MaterialTier.orichalcum]: "Orichalcum",
125 [MaterialTier.dragon]: "Dragon",
126 [GatherMaterialId.tin]: "Tin",
127 [GatherMaterialId.copper]: "Copper",
128 [GatherMaterialId.coal]: "Coal",
129 [WoodTier.pine]: "Pine",
130 [WoodTier.birch]: "Birch",
131 [WoodTier.oak]: "Oak",
132 [WoodTier.ebony]: "Ebony",
133 [WoodTier.lignum]: "Lignum",
134 [WoodTier.heartwood]: "Heartwood",
135 [WoodTier.elder]: "Elder"
136});
137
138/**
139 * Display tint colors (0–1 RGB) for magenta-tinted sprites.
140 * Steel is slightly darker than iron; orichalcum is coppery-gold; dragon is red.
141 */
142export const MATERIAL_TINT_COLOR = Object.freeze({
143 [MaterialTier.bronze]: Object.freeze({ r: 0.72, g: 0.48, b: 0.28 }),
144 [MaterialTier.iron]: Object.freeze({ r: 0.62, g: 0.64, b: 0.68 }),
145 [MaterialTier.steel]: Object.freeze({ r: 0.48, g: 0.50, b: 0.54 }),
146 [MaterialTier.mithril]: Object.freeze({ r: 0.40, g: 0.55, b: 0.88 }),
147 [MaterialTier.adamantium]: Object.freeze({ r: 0.35, g: 0.75, b: 0.45 }),
148 [MaterialTier.orichalcum]: Object.freeze({ r: 0.90, g: 0.55, b: 0.22 }),
149 [MaterialTier.dragon]: Object.freeze({ r: 0.88, g: 0.18, b: 0.16 }),
150 [GatherMaterialId.tin]: Object.freeze({ r: 0.78, g: 0.80, b: 0.82 }),
151 [GatherMaterialId.copper]: Object.freeze({ r: 0.85, g: 0.45, b: 0.22 }),
152 [GatherMaterialId.coal]: Object.freeze({ r: 0.22, g: 0.22, b: 0.25 }),
153 [WoodTier.pine]: Object.freeze({ r: 0.78, g: 0.62, b: 0.38 }),
154 [WoodTier.birch]: Object.freeze({ r: 0.88, g: 0.82, b: 0.68 }),
155 [WoodTier.oak]: Object.freeze({ r: 0.62, g: 0.42, b: 0.24 }),
156 [WoodTier.ebony]: Object.freeze({ r: 0.22, g: 0.16, b: 0.20 }),
157 [WoodTier.lignum]: Object.freeze({ r: 0.42, g: 0.38, b: 0.22 }),
158 [WoodTier.heartwood]: Object.freeze({ r: 0.72, g: 0.28, b: 0.22 }),
159 [WoodTier.elder]: Object.freeze({ r: 0.72, g: 0.74, b: 0.78 })
160});
161
162/** Wood tier that matches a metal tier's rank (for tool hafts). */
163export const WOOD_TIER_FOR_METAL = Object.freeze({
164 [MaterialTier.bronze]: WoodTier.pine,
165 [MaterialTier.iron]: WoodTier.birch,
166 [MaterialTier.steel]: WoodTier.oak,
167 [MaterialTier.mithril]: WoodTier.ebony,
168 [MaterialTier.adamantium]: WoodTier.lignum,
169 [MaterialTier.orichalcum]: WoodTier.heartwood,
170 [MaterialTier.dragon]: WoodTier.elder
171});
172
173export const METAL_TIER_FOR_WOOD = Object.freeze(Object.fromEntries(
174 Object.entries(WOOD_TIER_FOR_METAL).map(([metal, wood]) => [wood, metal])
175));
176
177/**
178 * Bar tier that drives mine/smelt duration and gates for a gatherable.
179 * Tin/copper → bronze; coal → steel; other metals map to themselves.
180 */
181export function associatedBarTier (materialId)
182{
183 if (materialId === GatherMaterialId.tin || materialId === GatherMaterialId.copper)
184 { return MaterialTier.bronze; }
185 if (materialId === GatherMaterialId.coal)
186 { return MaterialTier.steel; }
187 return materialId;
188}
189
190export function materialDisplayName (materialId)
191{
192 return MATERIAL_DISPLAY_NAME[materialId] ?? materialId;
193}
194
195export function materialTintColor (materialId)
196{
197 return MATERIAL_TINT_COLOR[materialId] ?? MATERIAL_TINT_COLOR[MaterialTier.bronze];
198}
199
200export function tierStatBonus (tier)
201{
202 return TIER_STAT_BONUS[tier] ?? TIER_STAT_BONUS[MaterialTier.bronze];
203}
204
205export function tierMinSkillLevel (tier)
206{
207 return TIER_MIN_SKILL_LEVEL[tier] ?? TIER_MIN_SKILL_LEVEL[MaterialTier.bronze];
208}
209
210export function tierRank (tier)
211{
212 return TIER_RANK[associatedBarTier(tier)] ?? TIER_RANK[tier] ?? 1;
213}
214
215/** Mining / woodcutting skill required (half of equip gate, ceil). */
216export function tierMineSkillLevel (tier)
217{
218 return Math.max(1, Math.ceil(tierMinSkillLevel(associatedBarTier(tier)) / 2));
219}
220
221/** Smithing / woodcraft skill required to process this material (75% of equip gate, ceil). */
222export function tierSmeltSkillLevel (tier)
223{
224 return Math.max(1, Math.ceil(tierMinSkillLevel(associatedBarTier(tier)) * 0.75));
225}
226
227/** Alias for woodworking / general craft gates (same curve as smelting). */
228export function tierCraftSkillLevel (tier)
229{
230 return tierSmeltSkillLevel(tier);
231}
232
233export function woodTierForMetal (metalTier)
234{
235 return WOOD_TIER_FOR_METAL[metalTier] ?? WoodTier.pine;
236}
237
238export function metalTierForWood (woodTier)
239{
240 return METAL_TIER_FOR_WOOD[woodTier] ?? MaterialTier.bronze;
241}
242
243/**
244 * Mining action duration in ms.
245 * (resourceRank * 8s) − (toolRank * 3s), floored at 0.5s.
246 * Tin/copper/coal use their associated bar's rank.
247 */
248export function miningDurationMs (resourceMaterialId, toolTier)
249{
250 const resourceRank = tierRank(resourceMaterialId);
251 const toolRank = tierRank(toolTier);
252 const seconds = Math.max(0.5, resourceRank * 8 - toolRank * 3);
253 return Math.round(seconds * 1000);
254}
255
256/** After a successful mine, nodes stay exhausted for 10s × associated bar rank. */
257export function oreExhaustDurationMs (materialId)
258{
259 return Math.max(1, tierRank(materialId)) * 10_000;
260}
261
262/** Base craft duration per bar rank (bronze = 2s, iron = 4s, …). */
263export const SMELT_DURATION_PER_RANK_MS = 2000;
264
265/**
266 * Furnace smelt duration from the output bar's associated tier rank.
267 * Tin/copper/coal map to bronze/steel so ingredient timing matches that bar.
268 */
269export function smeltingDurationMs (barOrMaterialId)
270{
271 return Math.max(1, tierRank(barOrMaterialId)) * SMELT_DURATION_PER_RANK_MS;
272}
273
274/** Visual / interact state while an ore boulder is depleted (plain rock). */
275export const EXHAUSTED_ORE_BOULDER_STATE = "boulder";
276
277/**
278 * Materials that have an ore boulder node.
279 * Bronze has no ore (tin + copper); steel has no ore (iron + coal).
280 */
281export const ORE_BEARING_MATERIALS = Object.freeze([
282 GatherMaterialId.tin,
283 GatherMaterialId.copper,
284 MaterialTier.iron,
285 MaterialTier.mithril,
286 MaterialTier.adamantium,
287 MaterialTier.orichalcum,
288 MaterialTier.dragon,
289 GatherMaterialId.coal
290]);
291
292/** Boulder visual state for a gatherable ore (editor / world). */
293export function oreBoulderState (materialId)
294{
295 if (materialId === GatherMaterialId.coal)
296 { return "coal"; }
297 return `${materialId}-ore`;
298}
299
300export function materialFromOreBoulderState (state)
301{
302 if (!state || state === "boulder")
303 { return null; }
304 if (state === "coal")
305 { return GatherMaterialId.coal; }
306 if (state.endsWith("-ore"))
307 {
308 const id = state.slice(0, -"-ore".length);
309 if (ORE_BEARING_MATERIALS.includes(id))
310 { return id; }
311 }
312 return null;
313}
314
315export function isOreBoulderState (state)
316{
317 return materialFromOreBoulderState(state) != null;
318}