BlueGit

timfa questward

Files

questward / shared / definitions / mobs.js

mobs.js

mobs.js 6.3 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 gait: "walk",
45 sex: "male",
46 frames: 1,
47 framesPerRow: 1,
48 animationSpeed: 0
49 }),
50 [MobId.pigeon]: Object.freeze({
51 mobTypeId: MobId.pigeon,
52 key: "pigeon",
53 assetFolder: "pigeons",
54 displayName: "Pigeon",
55 health: 1,
56 maxHealth: 1,
57 canFight: false,
58 drops: Object.freeze([]),
59 sells: Object.freeze([]),
60 dialogue: Object.freeze([]),
61 persistent: false,
62 flying: true,
63 freeFlight: true,
64 ambient: false,
65 talkable: false,
66 untargetable: true,
67 gait: "walk",
68 sex: "male",
69 frames: 2,
70 framesPerRow: 2,
71 animationSpeed: 0.18,
72 defaultState: "pigeon-flying",
73 flightSpeedTilesPerSec: 2.5
74 }),
75 [MobId.rat]: Object.freeze({
76 mobTypeId: MobId.rat,
77 key: "rat",
78 assetFolder: "mobs",
79 displayName: "Rat",
80 health: 12,
81 maxHealth: 12,
82 attackSkill: 3,
83 attackCooldownMs: 900,
84 baseDamage: 2,
85 drops: Object.freeze([]),
86 sells: Object.freeze([]),
87 dialogue: Object.freeze([]),
88 persistent: false,
89 flying: false,
90 freeFlight: false,
91 ambient: false,
92 talkable: false,
93 untargetable: false,
94 gait: "walk",
95 sex: "male",
96 frames: 1,
97 framesPerRow: 1,
98 animationSpeed: 0
99 }),
100 [MobId.humanoid]: Object.freeze({
101 mobTypeId: MobId.humanoid,
102 key: "humanoid",
103 assetFolder: "characters",
104 displayName: "Humanoid",
105 health: 10,
106 maxHealth: 10,
107 canFight: false,
108 drops: Object.freeze([]),
109 sells: Object.freeze([]),
110 dialogue: Object.freeze([]),
111 persistent: false,
112 flying: false,
113 freeFlight: false,
114 ambient: false,
115 talkable: true,
116 untargetable: false,
117 usePlayerBody: true,
118 gait: "walk",
119 sex: "male",
120 frames: 1,
121 framesPerRow: 1,
122 animationSpeed: 0
123 })
124});
125
126export function mobDefinition (mobTypeId)
127{
128 return MOB_DEFINITIONS[mobTypeId] ?? null;
129}
130
131export function mobSpriteName (mobTypeId)
132{
133 const def = mobDefinition(mobTypeId);
134 const key = def?.key ?? def?.mobTypeId ?? "deer";
135 if (def?.usePlayerBody)
136 {
137 // Editor palette preview; live entities use appearance.sex → bodySprite().
138 return spriteImageName("character", "player-body-male", "player-body-male");
139 }
140 if (def?.sprite)
141 { return def.sprite; }
142 const state = def?.defaultState ?? key;
143 return spriteImageName("mob", key, state);
144}
145
146export function defaultSpawnerConfig (spawnerId, mobTypeId = MobId.deer)
147{
148 const humanoid = mobTypeId === MobId.humanoid;
149 return {
150 spawnerId,
151 mobTypeId,
152 maxAlive: humanoid ? 1 : 3,
153 spawnRangeTiles: humanoid ? 1 : 4,
154 maxWanderRangeTiles: humanoid ? 1 : 8,
155 sex: "male",
156 displayName: humanoid ? "Shopkeeper" : "",
157 equipment: emptySpawnerEquipment(),
158 sells: [],
159 hiddenDiscount: 0.9
160 };
161}
162
163function emptySpawnerEquipment ()
164{
165 return {
166 head: null,
167 chest: null,
168 legs: null,
169 boots: null,
170 weapon: null,
171 offhand: null
172 };
173}
174
175function normalizeEquipment (raw)
176{
177 const next = emptySpawnerEquipment();
178 if (!raw || typeof raw !== "object")
179 { return next; }
180 for (const slot of Object.keys(next))
181 {
182 const value = raw[slot];
183 if (value == null || value === "" || value === "0")
184 {
185 next[slot] = null;
186 continue;
187 }
188 const itemId = Number(value);
189 next[slot] = Number.isFinite(itemId) && itemId > 0 ? (itemId | 0) : null;
190 }
191 return next;
192}
193
194function normalizeSells (raw)
195{
196 if (!Array.isArray(raw))
197 { return []; }
198 const ids = [];
199 const seen = new Set();
200 for (const entry of raw)
201 {
202 const itemId = Number(entry);
203 if (!Number.isFinite(itemId) || itemId <= 0 || seen.has(itemId | 0))
204 { continue; }
205 seen.add(itemId | 0);
206 ids.push(itemId | 0);
207 }
208 return ids;
209}
210
211/** Clamp wander ≥ spawn; coerce numeric fields; keep humanoid shop/appearance options. */
212export function normalizeSpawnerConfig (config, spawnerId = "spawner")
213{
214 const mobTypeId = config?.mobTypeId ?? MobId.deer;
215 const base = defaultSpawnerConfig(spawnerId, mobTypeId);
216 const merged = { ...base, ...(config ?? {}), spawnerId: config?.spawnerId || spawnerId, mobTypeId };
217 const spawnRangeTiles = Math.max(1, Math.min(32, Number(merged.spawnRangeTiles) || base.spawnRangeTiles));
218 const maxWanderRangeTiles = Math.max(
219 spawnRangeTiles,
220 Math.min(64, Number(merged.maxWanderRangeTiles) || spawnRangeTiles)
221 );
222 const sex = merged.sex === "female" ? "female" : "male";
223 const hiddenDiscount = Math.min(1, Math.max(0.01, Number(merged.hiddenDiscount) || base.hiddenDiscount));
224 const displayName = String(merged.displayName ?? "").trim().slice(0, 48);
225 return {
226 spawnerId: String(merged.spawnerId),
227 mobTypeId: merged.mobTypeId ?? MobId.deer,
228 maxAlive: Math.max(1, Math.min(20, Number(merged.maxAlive) || base.maxAlive)),
229 spawnRangeTiles,
230 maxWanderRangeTiles,
231 sex,
232 displayName,
233 equipment: normalizeEquipment(merged.equipment),
234 sells: normalizeSells(merged.sells),
235 hiddenDiscount
236 };
237}
238
239export function listAmbientMobTypes ()
240{
241 return Object.values(MOB_DEFINITIONS).filter((def) => def.ambient);
242}
243
244/** Every mob type that can be authored as a world-editor spawner. */
245export function listSpawnableMobTypes ()
246{
247 return Object.values(MOB_DEFINITIONS);
248}
249
250export function isHumanoidMob (mobTypeId)
251{
252 return mobDefinition(mobTypeId)?.usePlayerBody === true;
253}