BlueGit

timfa questward

Files

questward / shared / definitions / mobs.js

mobs.js

jewelerty, skulls
timfa Tim Falken · pushed by timfa · 2 months ago
2b6e44d0 History
mobs.js 16.2 KiB Download Raw
1import { spriteImageName } from "./tileSprites.js";
2import { centralExchangeStaffCount } from "../market/exchange.js";
3import { LeatherItemId } from "./leatherItems.js";
4import { CraftingItemId } from "./craftingItems.js";
5import { RangedItemId } from "./rangedItems.js";
6import { ArmourItemId } from "./armourItems.js";
7import { WoodItemId } from "./woodItems.js";
8import { ItemId } from "./items.js";
9
10export const MobId = Object.freeze({
11 deer: "deer",
12 pigeon: "pigeon",
13 rat: "rat",
14 chicken: "chicken",
15 humanoid: "humanoid",
16 /** Humanoid guards that respond to bounty kills within wander range. */
17 townGuard: "town-guard",
18 /** Editor/spawner identity for Central Exchange staff (always humanoid bodies). */
19 centralExchange: "central-exchange",
20 /** Temporary Shade summon (spell). */
21 shade: "shade"
22});
23
24/** @typedef {{ itemId: number, chance: number, quantity?: number, quantityMin?: number, quantityMax?: number }} MobDrop */
25/** @typedef {{ isPlayer: boolean, text: string }} DialogueLine */
26/** @typedef {{ trigger: string, text: string, available?: (ctx: object) => boolean }} DialogueResponse */
27
28/**
29 * Target mob content schema (rendering fields stay alongside gameplay fields for now).
30 * - displayName: shown name
31 * - health / maxHealth: hit points
32 * - attackSkill: one skill level for hit chance and damage
33 * - drops: { itemId, chance } roll on death
34 * - sells: default item IDs for shop stock (overridable per spawner)
35 * - dialogue: branching trees with triggers, lines, responses, and action hooks (later)
36 * - usePlayerBody: draw male/female character body instead of a mob sprite
37 */
38export const MOB_DEFINITIONS = Object.freeze({
39 [MobId.deer]: Object.freeze({
40 mobTypeId: MobId.deer,
41 key: "deer",
42 assetFolder: "mobs",
43 displayName: "Deer",
44 health: 8,
45 maxHealth: 8,
46 attackSkill: 2,
47 attackCooldownMs: 1000,
48 drops: Object.freeze([
49 { itemId: LeatherItemId.softLeather, chance: 1 },
50 { itemId: CraftingItemId.rawMeat, chance: 1 }
51 ]),
52 sells: Object.freeze([]),
53 dialogue: Object.freeze([]),
54 persistent: false,
55 flying: false,
56 freeFlight: false,
57 ambient: false,
58 talkable: false,
59 untargetable: false,
60 aggressive: false,
61 gait: "walk",
62 sex: "male",
63 frames: 1,
64 framesPerRow: 1,
65 animationSpeed: 0
66 }),
67 [MobId.pigeon]: Object.freeze({
68 mobTypeId: MobId.pigeon,
69 key: "pigeon",
70 assetFolder: "pigeons",
71 displayName: "Pigeon",
72 health: 1,
73 maxHealth: 1,
74 canFight: false,
75 drops: Object.freeze([]),
76 sells: Object.freeze([]),
77 dialogue: Object.freeze([]),
78 persistent: false,
79 flying: true,
80 freeFlight: true,
81 ambient: false,
82 talkable: false,
83 untargetable: true,
84 aggressive: false,
85 gait: "walk",
86 sex: "male",
87 frames: 2,
88 framesPerRow: 2,
89 animationSpeed: 0.18,
90 defaultState: "pigeon-flying",
91 flightSpeedTilesPerSec: 2.5
92 }),
93 [MobId.rat]: Object.freeze({
94 mobTypeId: MobId.rat,
95 key: "rat",
96 assetFolder: "mobs",
97 displayName: "Rat",
98 health: 12,
99 maxHealth: 12,
100 attackSkill: 3,
101 attackCooldownMs: 900,
102 drops: Object.freeze([]),
103 sells: Object.freeze([]),
104 dialogue: Object.freeze([]),
105 persistent: false,
106 flying: false,
107 freeFlight: false,
108 ambient: false,
109 talkable: false,
110 untargetable: false,
111 /** Auto-engage nearby players when in range with line of sight. */
112 aggressive: true,
113 aggroRangeTiles: 5,
114 elementAffinities: Object.freeze({ fire: "weak" }),
115 gait: "walk",
116 sex: "male",
117 frames: 1,
118 framesPerRow: 1,
119 animationSpeed: 0
120 }),
121 [MobId.chicken]: Object.freeze({
122 mobTypeId: MobId.chicken,
123 key: "chicken",
124 assetFolder: "mobs",
125 displayName: "Chicken",
126 health: 5,
127 maxHealth: 5,
128 attackSkill: 1,
129 attackCooldownMs: 1200,
130 drops: Object.freeze([
131 { itemId: RangedItemId.feather, chance: 1, quantityMin: 1, quantityMax: 3 },
132 { itemId: ItemId.egg, chance: 0.2 }
133 ]),
134 sells: Object.freeze([]),
135 dialogue: Object.freeze([]),
136 persistent: false,
137 flying: false,
138 freeFlight: false,
139 ambient: false,
140 talkable: false,
141 untargetable: false,
142 aggressive: false,
143 gait: "walk",
144 sex: "female",
145 frames: 1,
146 framesPerRow: 1,
147 animationSpeed: 0
148 }),
149 [MobId.shade]: Object.freeze({
150 mobTypeId: MobId.shade,
151 key: "shade",
152 assetFolder: "mobs",
153 displayName: "Shade",
154 health: 10,
155 maxHealth: 10,
156 maxHealthFromLevel: "levelPlus10",
157 attackSkill: 5,
158 attackCooldownMs: 900,
159 drops: Object.freeze([]),
160 sells: Object.freeze([]),
161 dialogue: Object.freeze([]),
162 persistent: false,
163 flying: false,
164 freeFlight: false,
165 ambient: false,
166 talkable: false,
167 untargetable: false,
168 aggressive: false,
169 /** Reuse rat art until a dedicated shade sprite exists. */
170 spriteKey: "rat",
171 gait: "walk",
172 sex: "male",
173 frames: 1,
174 framesPerRow: 1,
175 animationSpeed: 0
176 }),
177 [MobId.humanoid]: Object.freeze({
178 mobTypeId: MobId.humanoid,
179 key: "humanoid",
180 assetFolder: "characters",
181 displayName: "Humanoid",
182 health: 10,
183 maxHealth: 10,
184 /** HP = spawner level + 10 (same floor as a starting player's Health). */
185 maxHealthFromLevel: "levelPlus10",
186 drops: Object.freeze([]),
187 sells: Object.freeze([]),
188 dialogue: Object.freeze([]),
189 persistent: false,
190 flying: false,
191 freeFlight: false,
192 ambient: false,
193 talkable: true,
194 untargetable: false,
195 aggressive: false,
196 usePlayerBody: true,
197 gait: "walk",
198 sex: "male",
199 frames: 1,
200 framesPerRow: 1,
201 animationSpeed: 0
202 }),
203 [MobId.townGuard]: Object.freeze({
204 mobTypeId: MobId.townGuard,
205 key: "town-guard",
206 assetFolder: "characters",
207 displayName: "Town Guard",
208 health: 10,
209 maxHealth: 10,
210 maxHealthFromLevel: "levelPlus10",
211 drops: Object.freeze([]),
212 sells: Object.freeze([]),
213 dialogue: Object.freeze([]),
214 persistent: false,
215 flying: false,
216 freeFlight: false,
217 ambient: false,
218 talkable: false,
219 untargetable: false,
220 aggressive: false,
221 usePlayerBody: true,
222 townGuard: true,
223 gait: "walk",
224 sex: "male",
225 frames: 1,
226 framesPerRow: 1,
227 animationSpeed: 0
228 }),
229 [MobId.centralExchange]: Object.freeze({
230 mobTypeId: MobId.centralExchange,
231 key: "central-exchange",
232 assetFolder: "characters",
233 displayName: "Central Exchange staff",
234 health: 10,
235 maxHealth: 10,
236 maxHealthFromLevel: "levelPlus10",
237 drops: Object.freeze([]),
238 sells: Object.freeze([]),
239 dialogue: Object.freeze([]),
240 persistent: false,
241 flying: false,
242 freeFlight: false,
243 ambient: false,
244 talkable: false,
245 untargetable: false,
246 aggressive: false,
247 usePlayerBody: true,
248 centralExchange: true,
249 gait: "walk",
250 sex: "male",
251 frames: 1,
252 framesPerRow: 1,
253 animationSpeed: 0
254 })
255});
256
257export function mobDefinition (mobTypeId)
258{
259 return MOB_DEFINITIONS[mobTypeId] ?? null;
260}
261
262export function mobSpriteName (mobTypeId)
263{
264 const def = mobDefinition(mobTypeId);
265 const key = def?.spriteKey ?? def?.key ?? def?.mobTypeId ?? "deer";
266 if (def?.usePlayerBody)
267 {
268 // Editor palette preview; live entities use appearance.sex → bodySprite().
269 return spriteImageName("character", "player-body-male", "player-body-male");
270 }
271 if (def?.sprite)
272 { return def.sprite; }
273 const state = def?.defaultState ?? key;
274 return spriteImageName("mob", key, state);
275}
276
277export function defaultSpawnerConfig (spawnerId, mobTypeId = MobId.deer)
278{
279 const humanoid = isHumanoidMob(mobTypeId) || mobTypeId === MobId.humanoid;
280 const townGuard = mobTypeId === MobId.townGuard;
281 const centralExchange = mobTypeId === MobId.centralExchange;
282 const bodyNpc = humanoid || townGuard || centralExchange;
283 return {
284 spawnerId,
285 mobTypeId,
286 maxAlive: centralExchange
287 ? centralExchangeStaffCount()
288 : (bodyNpc ? 1 : 3),
289 /** Seconds after death before this spawner may refill that slot (0 = next spawner tick). */
290 respawnDelaySeconds: 25,
291 spawnRangeTiles: bodyNpc ? 1 : 4,
292 maxWanderRangeTiles: bodyNpc ? 1 : 8,
293 level: townGuard ? 30 : 1,
294 bounty: townGuard ? 500 : 0,
295 /** Humanoid spawners only: auto-engage players in aggro range. Forces bounty 0. */
296 aggressive: false,
297 sex: "male",
298 displayName: townGuard ? "Town Guard" : (humanoid ? "Shopkeeper" : ""),
299 equipment: townGuard
300 ? {
301 head: ArmourItemId.ironHelmet,
302 chest: ArmourItemId.ironChestplate,
303 legs: ArmourItemId.bronzeGreaves,
304 boots: ArmourItemId.ironBoots,
305 weapon: WoodItemId.oakQuarterstaff,
306 offhand: null
307 }
308 : emptySpawnerEquipment(),
309 sells: [],
310 drops: [],
311 spells: [],
312 buysItems: false,
313 hiddenDiscount: 0.9,
314 centralExchange,
315 townGuard,
316 dialogueId: null
317 };
318}
319
320function emptySpawnerEquipment ()
321{
322 return {
323 head: null,
324 chest: null,
325 legs: null,
326 boots: null,
327 weapon: null,
328 offhand: null
329 };
330}
331
332/**
333 * Spawner equipment entry: legacy itemId number, or `{ itemId, dyeColor? }` for dyed clothing.
334 * Normalized form keeps a plain number when undyed (world-save compatible).
335 */
336function normalizeEquipmentEntry (value)
337{
338 if (value == null || value === "" || value === "0")
339 { return null; }
340 let itemId = 0;
341 let dyeColor = null;
342 if (typeof value === "object")
343 {
344 itemId = Number(value.itemId) | 0;
345 dyeColor = normalizeDyeColor(value.dyeColor);
346 }
347 else
348 { itemId = Number(value) | 0; }
349 if (!Number.isFinite(itemId) || itemId <= 0)
350 { return null; }
351 if (!dyeColor)
352 { return itemId; }
353 return Object.freeze({ itemId, dyeColor });
354}
355
356function normalizeDyeColor (raw)
357{
358 if (!raw || typeof raw !== "object")
359 { return null; }
360 const r = Number(raw.r);
361 const g = Number(raw.g);
362 const b = Number(raw.b);
363 if (![r, g, b].every(Number.isFinite))
364 { return null; }
365 const asByte = r > 1 || g > 1 || b > 1;
366 return Object.freeze({
367 r: Math.min(1, Math.max(0, asByte ? r / 255 : r)),
368 g: Math.min(1, Math.max(0, asByte ? g / 255 : g)),
369 b: Math.min(1, Math.max(0, asByte ? b / 255 : b))
370 });
371}
372
373function normalizeEquipment (raw)
374{
375 const next = emptySpawnerEquipment();
376 if (!raw || typeof raw !== "object")
377 { return next; }
378 for (const slot of Object.keys(next))
379 { next[slot] = normalizeEquipmentEntry(raw[slot]); }
380 return next;
381}
382
383/** Resolve authored spawner equipment into itemId (+ optional dye). */
384export function spawnerEquipmentSlot (entry)
385{
386 if (entry == null)
387 { return { itemId: 0, dyeColor: null }; }
388 if (typeof entry === "object")
389 {
390 return {
391 itemId: Number(entry.itemId) | 0,
392 dyeColor: entry.dyeColor ?? null
393 };
394 }
395 return { itemId: Number(entry) | 0, dyeColor: null };
396}
397
398function normalizeSells (raw)
399{
400 if (!Array.isArray(raw))
401 { return []; }
402 const lines = [];
403 const seen = new Set();
404 for (const entry of raw)
405 {
406 let itemId;
407 let quantity = 0;
408 if (entry && typeof entry === "object")
409 {
410 itemId = Number(entry.itemId);
411 quantity = Math.max(0, Number(entry.quantity) || 0) | 0;
412 }
413 else
414 { itemId = Number(entry); }
415 if (!Number.isFinite(itemId) || itemId <= 0 || seen.has(itemId | 0))
416 { continue; }
417 seen.add(itemId | 0);
418 lines.push({ itemId: itemId | 0, quantity });
419 }
420 return lines;
421}
422
423/**
424 * Spawner loot lines. Chance is 0–1 (UI edits as 0–100%).
425 * Quantity is rolled inclusively between quantityMin and quantityMax when the drop hits.
426 * @returns {ReadonlyArray<{ itemId: number, chance: number, quantityMin: number, quantityMax: number }>}
427 */
428function normalizeDrops (raw)
429{
430 if (!Array.isArray(raw))
431 { return []; }
432 const lines = [];
433 const seen = new Set();
434 for (const entry of raw)
435 {
436 if (!entry || typeof entry !== "object")
437 { continue; }
438 const itemId = Number(entry.itemId) | 0;
439 if (!Number.isFinite(itemId) || itemId <= 0 || seen.has(itemId))
440 { continue; }
441 seen.add(itemId);
442 let chance = Number(entry.chance);
443 if (!Number.isFinite(chance))
444 { chance = 1; }
445 // Accept editor percent (0–100) or fraction (0–1).
446 if (chance > 1)
447 { chance = chance / 100; }
448 chance = Math.min(1, Math.max(0, chance));
449 let quantityMin = Math.max(0, Math.floor(Number(
450 entry.quantityMin ?? entry.quantity ?? 1
451 )));
452 let quantityMax = Math.max(0, Math.floor(Number(
453 entry.quantityMax ?? entry.quantityMin ?? entry.quantity ?? quantityMin
454 )));
455 if (!Number.isFinite(quantityMin))
456 { quantityMin = 1; }
457 if (!Number.isFinite(quantityMax))
458 { quantityMax = quantityMin; }
459 if (quantityMax < quantityMin)
460 { quantityMax = quantityMin; }
461 lines.push(Object.freeze({ itemId, chance, quantityMin, quantityMax }));
462 }
463 return lines;
464}
465
466function normalizeSpells (raw)
467{
468 if (!Array.isArray(raw))
469 { return []; }
470 const lines = [];
471 const seen = new Set();
472 for (const entry of raw)
473 {
474 if (!entry || typeof entry !== "object")
475 { continue; }
476 const spellId = String(entry.spellId ?? "").trim();
477 if (!spellId || seen.has(spellId))
478 { continue; }
479 seen.add(spellId);
480 // Cast chance is derived from mob level at spawn time — not stored.
481 lines.push({ spellId });
482 }
483 return lines;
484}
485
486/** Clamp wander ≥ spawn; coerce numeric fields; keep humanoid shop/appearance options. */
487export function normalizeSpawnerConfig (config, spawnerId = "spawner")
488{
489 const mobTypeId = config?.mobTypeId ?? MobId.deer;
490 const centralExchange = mobTypeId === MobId.centralExchange || !!config?.centralExchange;
491 const townGuard = !centralExchange && (mobTypeId === MobId.townGuard || !!config?.townGuard);
492 const effectiveMob = centralExchange
493 ? MobId.centralExchange
494 : (townGuard ? MobId.townGuard : mobTypeId);
495 const base = defaultSpawnerConfig(spawnerId, effectiveMob);
496 const merged = { ...base, ...(config ?? {}), spawnerId: config?.spawnerId || spawnerId, mobTypeId: effectiveMob };
497 const spawnRangeTiles = Math.max(1, Math.min(32, Number(merged.spawnRangeTiles) || base.spawnRangeTiles));
498 const maxWanderRangeTiles = Math.max(
499 spawnRangeTiles,
500 Math.min(64, Number(merged.maxWanderRangeTiles) || spawnRangeTiles)
501 );
502 const sex = merged.sex === "female" ? "female" : "male";
503 const hiddenDiscount = Math.min(1, Math.max(0.01, Number(merged.hiddenDiscount) || base.hiddenDiscount));
504 const displayName = String(merged.displayName ?? "").trim().slice(0, 48);
505 const staffCap = centralExchangeStaffCount();
506 const level = Math.max(1, Math.min(99, Number(merged.level) || base.level || 1)) | 0;
507 const bodyNpc = isHumanoidMob(effectiveMob) || centralExchange || townGuard;
508 const aggressive = bodyNpc ? !!merged.aggressive : false;
509 const bounty = aggressive ? 0 : (Math.max(0, Number(merged.bounty) || 0) | 0);
510 return {
511 spawnerId: String(merged.spawnerId),
512 mobTypeId: effectiveMob,
513 maxAlive: centralExchange
514 ? staffCap
515 : Math.max(1, Math.min(20, Number(merged.maxAlive) || base.maxAlive)),
516 respawnDelaySeconds: Math.max(
517 0,
518 Math.min(
519 86_400,
520 Math.floor(
521 Number(
522 merged.respawnDelaySeconds != null && merged.respawnDelaySeconds !== ""
523 ? merged.respawnDelaySeconds
524 : base.respawnDelaySeconds
525 ) || 0
526 )
527 )
528 ),
529 spawnRangeTiles,
530 maxWanderRangeTiles,
531 level,
532 bounty,
533 aggressive,
534 sex,
535 displayName,
536 equipment: normalizeEquipment(merged.equipment),
537 sells: centralExchange ? [] : normalizeSells(merged.sells),
538 drops: bodyNpc ? normalizeDrops(merged.drops) : [],
539 spells: normalizeSpells(merged.spells),
540 buysItems: centralExchange ? false : !!merged.buysItems,
541 hiddenDiscount,
542 centralExchange,
543 townGuard,
544 dialogueId: bodyNpc
545 ? (String(merged.dialogueId ?? "").trim().slice(0, 64) || null)
546 : null
547 };
548}
549
550export function listAmbientMobTypes ()
551{
552 return Object.values(MOB_DEFINITIONS).filter((def) => def.ambient);
553}
554
555/** Every mob type that can be authored as a world-editor spawner. */
556export function listSpawnableMobTypes ()
557{
558 return Object.values(MOB_DEFINITIONS);
559}
560
561export function isHumanoidMob (mobTypeId)
562{
563 return mobDefinition(mobTypeId)?.usePlayerBody === true;
564}
565
566export function isTownGuardMob (mobTypeId)
567{
568 return mobTypeId === MobId.townGuard || !!mobDefinition(mobTypeId)?.townGuard;
569}
570
571export function isCentralExchangeSpawner (configOrMobTypeId)
572{
573 if (configOrMobTypeId && typeof configOrMobTypeId === "object")
574 { return !!configOrMobTypeId.centralExchange || configOrMobTypeId.mobTypeId === MobId.centralExchange; }
575 return configOrMobTypeId === MobId.centralExchange;
576}
577
578/** Max HP for a mob at the given spawner level. */
579export function mobMaxHealthForLevel (def, level)
580{
581 const lv = Math.max(1, Math.floor(Number(level) || 1));
582 const formula = def?.maxHealthFromLevel;
583 if (formula === "levelPlus10" || (!formula && def?.usePlayerBody))
584 { return lv + 10; }
585 const base = Math.max(1, Number(def?.health ?? def?.maxHealth ?? 8) || 8);
586 return Math.max(1, base + (lv - 1));
587}
588
589/** Display label for hover / UI: `Lv.5 Deer`. */
590export function mobLevelDisplayName (level, displayName)
591{
592 const lv = Math.max(1, Math.floor(Number(level) || 1));
593 const name = String(displayName ?? "").trim() || "Creature";
594 return `Lv.${lv} ${name}`;
595}