BlueGit

timfa questward

Files

questward / shared / definitions / mobs.js

mobs.js

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