BlueGit

timfa questward

Files

questward / shared / definitions / mobs.js

mobs.js

mobs.js 6.7 KiB Download Raw
1import { spriteImageName } from "./tileSprites.js";
2
3export const MobId = Object.freeze({
4 deer: "deer",
5 pigeon: "pigeon",
6 rat: "rat",
7 humanoid: "humanoid"
8});
9
10/** @typedef {{ itemId: number, chance: number }} MobDrop */
11/** @typedef {{ isPlayer: boolean, text: string }} DialogueLine */
12/** @typedef {{ trigger: string, text: string, available?: (ctx: object) => boolean }} DialogueResponse */
13
14/**
15 * Target mob content schema (rendering fields stay alongside gameplay fields for now).
16 * - displayName: shown name
17 * - health / maxHealth: hit points
18 * - attackSkill: one skill level for hit chance and damage
19 * - drops: { itemId, chance } roll on death
20 * - sells: default item IDs for shop stock (overridable per spawner)
21 * - dialogue: branching trees with triggers, lines, responses, and action hooks (later)
22 * - usePlayerBody: draw male/female character body instead of a mob sprite
23 */
24export const MOB_DEFINITIONS = Object.freeze({
25 [MobId.deer]: Object.freeze({
26 mobTypeId: MobId.deer,
27 key: "deer",
28 assetFolder: "mobs",
29 displayName: "Deer",
30 health: 8,
31 maxHealth: 8,
32 attackSkill: 2,
33 attackCooldownMs: 1000,
34 baseDamage: 1,
35 drops: Object.freeze([]),
36 sells: Object.freeze([]),
37 dialogue: Object.freeze([]),
38 persistent: false,
39 flying: false,
40 freeFlight: false,
41 ambient: false,
42 talkable: false,
43 untargetable: false,
44 aggressive: false,
45 gait: "walk",
46 sex: "male",
47 frames: 1,
48 framesPerRow: 1,
49 animationSpeed: 0
50 }),
51 [MobId.pigeon]: Object.freeze({
52 mobTypeId: MobId.pigeon,
53 key: "pigeon",
54 assetFolder: "pigeons",
55 displayName: "Pigeon",
56 health: 1,
57 maxHealth: 1,
58 canFight: false,
59 drops: Object.freeze([]),
60 sells: Object.freeze([]),
61 dialogue: Object.freeze([]),
62 persistent: false,
63 flying: true,
64 freeFlight: true,
65 ambient: false,
66 talkable: false,
67 untargetable: true,
68 aggressive: false,
69 gait: "walk",
70 sex: "male",
71 frames: 2,
72 framesPerRow: 2,
73 animationSpeed: 0.18,
74 defaultState: "pigeon-flying",
75 flightSpeedTilesPerSec: 2.5
76 }),
77 [MobId.rat]: Object.freeze({
78 mobTypeId: MobId.rat,
79 key: "rat",
80 assetFolder: "mobs",
81 displayName: "Rat",
82 health: 12,
83 maxHealth: 12,
84 attackSkill: 3,
85 attackCooldownMs: 900,
86 baseDamage: 2,
87 drops: Object.freeze([]),
88 sells: Object.freeze([]),
89 dialogue: Object.freeze([]),
90 persistent: false,
91 flying: false,
92 freeFlight: false,
93 ambient: false,
94 talkable: false,
95 untargetable: false,
96 /** Auto-engage nearby players when in range with line of sight. */
97 aggressive: true,
98 aggroRangeTiles: 5,
99 gait: "walk",
100 sex: "male",
101 frames: 1,
102 framesPerRow: 1,
103 animationSpeed: 0
104 }),
105 [MobId.humanoid]: Object.freeze({
106 mobTypeId: MobId.humanoid,
107 key: "humanoid",
108 assetFolder: "characters",
109 displayName: "Humanoid",
110 health: 10,
111 maxHealth: 10,
112 canFight: false,
113 drops: Object.freeze([]),
114 sells: Object.freeze([]),
115 dialogue: Object.freeze([]),
116 persistent: false,
117 flying: false,
118 freeFlight: false,
119 ambient: false,
120 talkable: true,
121 untargetable: false,
122 aggressive: false,
123 usePlayerBody: true,
124 gait: "walk",
125 sex: "male",
126 frames: 1,
127 framesPerRow: 1,
128 animationSpeed: 0
129 })
130});
131
132export function mobDefinition (mobTypeId)
133{
134 return MOB_DEFINITIONS[mobTypeId] ?? null;
135}
136
137export function mobSpriteName (mobTypeId)
138{
139 const def = mobDefinition(mobTypeId);
140 const key = def?.key ?? def?.mobTypeId ?? "deer";
141 if (def?.usePlayerBody)
142 {
143 // Editor palette preview; live entities use appearance.sex → bodySprite().
144 return spriteImageName("character", "player-body-male", "player-body-male");
145 }
146 if (def?.sprite)
147 { return def.sprite; }
148 const state = def?.defaultState ?? key;
149 return spriteImageName("mob", key, state);
150}
151
152export function defaultSpawnerConfig (spawnerId, mobTypeId = MobId.deer)
153{
154 const humanoid = mobTypeId === MobId.humanoid;
155 return {
156 spawnerId,
157 mobTypeId,
158 maxAlive: humanoid ? 1 : 3,
159 spawnRangeTiles: humanoid ? 1 : 4,
160 maxWanderRangeTiles: humanoid ? 1 : 8,
161 sex: "male",
162 displayName: humanoid ? "Shopkeeper" : "",
163 equipment: emptySpawnerEquipment(),
164 sells: [],
165 buysItems: false,
166 hiddenDiscount: 0.9
167 };
168}
169
170function emptySpawnerEquipment ()
171{
172 return {
173 head: null,
174 chest: null,
175 legs: null,
176 boots: null,
177 weapon: null,
178 offhand: null
179 };
180}
181
182function normalizeEquipment (raw)
183{
184 const next = emptySpawnerEquipment();
185 if (!raw || typeof raw !== "object")
186 { return next; }
187 for (const slot of Object.keys(next))
188 {
189 const value = raw[slot];
190 if (value == null || value === "" || value === "0")
191 {
192 next[slot] = null;
193 continue;
194 }
195 const itemId = Number(value);
196 next[slot] = Number.isFinite(itemId) && itemId > 0 ? (itemId | 0) : null;
197 }
198 return next;
199}
200
201function normalizeSells (raw)
202{
203 if (!Array.isArray(raw))
204 { return []; }
205 const lines = [];
206 const seen = new Set();
207 for (const entry of raw)
208 {
209 let itemId;
210 let quantity = 0;
211 if (entry && typeof entry === "object")
212 {
213 itemId = Number(entry.itemId);
214 quantity = Math.max(0, Number(entry.quantity) || 0) | 0;
215 }
216 else
217 { itemId = Number(entry); }
218 if (!Number.isFinite(itemId) || itemId <= 0 || seen.has(itemId | 0))
219 { continue; }
220 seen.add(itemId | 0);
221 lines.push({ itemId: itemId | 0, quantity });
222 }
223 return lines;
224}
225
226/** Clamp wander ≥ spawn; coerce numeric fields; keep humanoid shop/appearance options. */
227export function normalizeSpawnerConfig (config, spawnerId = "spawner")
228{
229 const mobTypeId = config?.mobTypeId ?? MobId.deer;
230 const base = defaultSpawnerConfig(spawnerId, mobTypeId);
231 const merged = { ...base, ...(config ?? {}), spawnerId: config?.spawnerId || spawnerId, mobTypeId };
232 const spawnRangeTiles = Math.max(1, Math.min(32, Number(merged.spawnRangeTiles) || base.spawnRangeTiles));
233 const maxWanderRangeTiles = Math.max(
234 spawnRangeTiles,
235 Math.min(64, Number(merged.maxWanderRangeTiles) || spawnRangeTiles)
236 );
237 const sex = merged.sex === "female" ? "female" : "male";
238 const hiddenDiscount = Math.min(1, Math.max(0.01, Number(merged.hiddenDiscount) || base.hiddenDiscount));
239 const displayName = String(merged.displayName ?? "").trim().slice(0, 48);
240 return {
241 spawnerId: String(merged.spawnerId),
242 mobTypeId: merged.mobTypeId ?? MobId.deer,
243 maxAlive: Math.max(1, Math.min(20, Number(merged.maxAlive) || base.maxAlive)),
244 spawnRangeTiles,
245 maxWanderRangeTiles,
246 sex,
247 displayName,
248 equipment: normalizeEquipment(merged.equipment),
249 sells: normalizeSells(merged.sells),
250 buysItems: !!merged.buysItems,
251 hiddenDiscount
252 };
253}
254
255export function listAmbientMobTypes ()
256{
257 return Object.values(MOB_DEFINITIONS).filter((def) => def.ambient);
258}
259
260/** Every mob type that can be authored as a world-editor spawner. */
261export function listSpawnableMobTypes ()
262{
263 return Object.values(MOB_DEFINITIONS);
264}
265
266export function isHumanoidMob (mobTypeId)
267{
268 return mobDefinition(mobTypeId)?.usePlayerBody === true;
269}