BlueGit

timfa questward

Files

questward / shared / definitions / mobs.js

mobs.js

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