import { spriteImageName } from "./tileSprites.js"; import { centralExchangeStaffCount } from "../market/exchange.js"; import { LeatherItemId } from "./leatherItems.js"; import { CraftingItemId } from "./craftingItems.js"; import { RangedItemId } from "./rangedItems.js"; import { ArmourItemId } from "./armourItems.js"; import { WoodItemId } from "./woodItems.js"; import { ItemId } from "./items.js"; import { spellDefinition } from "./spells.js"; import { ClothTier } from "./materialTiers.js"; import { ClothItemId } from "./clothItems.js"; import { EssenceItemId } from "./essenceItems.js"; import { AttackType, MagicElement } from "./attackTypes.js"; import { SkillId } from "./skills.js"; export const MobId = Object.freeze({ deer: "deer", pigeon: "pigeon", rat: "rat", goblin: "goblin", chicken: "chicken", sheep: "sheep", cashmereGoat: "cashmere-goat", humanoid: "humanoid", /** Humanoid guards that respond to bounty kills within wander range. */ townGuard: "town-guard", /** Editor/spawner identity for Central Exchange staff (always humanoid bodies). */ centralExchange: "central-exchange", /** Temporary Shade summon (spell). */ shade: "shade", /** Elemental sprite — random element on spawn, drops essence, emits light. */ sprite: "sprite", /** Fairy — drops fairy silk fibre on death. */ fairy: "fairy" }); /** @typedef {{ itemId: number, chance: number, quantity?: number, quantityMin?: number, quantityMax?: number }} MobDrop */ /** @typedef {{ isPlayer: boolean, text: string }} DialogueLine */ /** @typedef {{ trigger: string, text: string, available?: (ctx: object) => boolean }} DialogueResponse */ /** * Target mob content schema (rendering fields stay alongside gameplay fields for now). * - displayName: shown name * - health / maxHealth: hit points * - attackSkill: one skill level for hit chance and damage * - drops: { itemId, chance } roll on death * - sells: default item IDs for shop stock (overridable per spawner) * - dialogue: branching trees with triggers, lines, responses, and action hooks (later) * - usePlayerBody: draw male/female character body instead of a mob sprite * - canOpenDoors: optional override; default = humanoid/usePlayerBody can open, * other mobs only pass through already-open (held) doors */ export const MOB_DEFINITIONS = Object.freeze({ [MobId.deer]: Object.freeze({ mobTypeId: MobId.deer, key: "deer", assetFolder: "mobs", displayName: "Deer", health: 8, maxHealth: 8, attackSkill: 2, attackCooldownMs: 1000, drops: Object.freeze([ { itemId: LeatherItemId.softLeather, chance: 1 }, { itemId: CraftingItemId.rawMeat, chance: 1 } ]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: false, gait: "walk", sex: "male", frames: 1, framesPerRow: 1, animationSpeed: 0 }), [MobId.pigeon]: Object.freeze({ mobTypeId: MobId.pigeon, key: "pigeon", assetFolder: "pigeons", displayName: "Pigeon", health: 1, maxHealth: 1, canFight: false, drops: Object.freeze([]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: true, freeFlight: true, ambient: false, talkable: false, untargetable: true, aggressive: false, gait: "walk", sex: "male", frames: 2, framesPerRow: 2, animationSpeed: 0.18, defaultState: "pigeon-flying", flightSpeedTilesPerSec: 2.5 }), [MobId.rat]: Object.freeze({ mobTypeId: MobId.rat, key: "rat", assetFolder: "mobs", displayName: "Rat", health: 12, maxHealth: 12, attackSkill: 1, attackCooldownMs: 900, drops: Object.freeze([]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, /** Auto-engage nearby players when in range with line of sight. */ aggressive: true, aggroRangeTiles: 5, elementAffinities: Object.freeze({ fire: "weak" }), gait: "walk", sex: "male", frames: 1, framesPerRow: 1, animationSpeed: 0 }), [MobId.goblin]: Object.freeze({ mobTypeId: MobId.goblin, key: "goblin", assetFolder: "mobs", displayName: "Goblin", health: 16, maxHealth: 16, attackSkill: 5, attackCooldownMs: 850, drops: Object.freeze([]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: true, aggroRangeTiles: 5, meleeAttack: Object.freeze({ mode: "melee", rangeTiles: 1, hitSkillId: SkillId.swordfighting, damageSkillId: SkillId.strength, attackType: AttackType.slashing }), gait: "walk", sex: "male", frames: 1, framesPerRow: 1, animationSpeed: 0 }), [MobId.chicken]: Object.freeze({ mobTypeId: MobId.chicken, key: "chicken", assetFolder: "mobs", displayName: "Chicken", health: 5, maxHealth: 5, attackSkill: 1, attackCooldownMs: 1200, drops: Object.freeze([ { itemId: RangedItemId.feather, chance: 1, quantityMin: 1, quantityMax: 3 }, { itemId: ItemId.egg, chance: 0.2 } ]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: false, gait: "walk", sex: "female", frames: 1, framesPerRow: 1, animationSpeed: 0 }), [MobId.sheep]: Object.freeze({ mobTypeId: MobId.sheep, key: "sheep", assetFolder: "mobs", displayName: "Sheep", health: 8, maxHealth: 8, attackSkill: 1, attackCooldownMs: 1200, drops: Object.freeze([ { itemId: LeatherItemId.softLeather, chance: 0.5 }, { itemId: CraftingItemId.rawMutton, chance: 1 } ]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: false, gait: "walk", sex: "female", frames: 1, framesPerRow: 1, animationSpeed: 0, defaultState: "fleece", shearable: Object.freeze({ clothTier: ClothTier.wool, fleeceState: "fleece", shornState: "shorn" }) }), [MobId.cashmereGoat]: Object.freeze({ mobTypeId: MobId.cashmereGoat, key: "cashmere-goat", assetFolder: "mobs", displayName: "Goat", health: 10, maxHealth: 10, attackSkill: 2, attackCooldownMs: 1100, drops: Object.freeze([ { itemId: LeatherItemId.softLeather, chance: 0.6 }, { itemId: CraftingItemId.rawGoat, chance: 1 } ]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: false, gait: "walk", sex: "female", frames: 1, framesPerRow: 1, animationSpeed: 0, defaultState: "fleece", shearable: Object.freeze({ clothTier: ClothTier.cashmere, fleeceState: "fleece", shornState: "shorn" }) }), [MobId.shade]: Object.freeze({ mobTypeId: MobId.shade, key: "shade", assetFolder: "mobs", displayName: "Shade", health: 10, maxHealth: 10, maxHealthFromLevel: "levelPlus10", attackSkill: 5, attackCooldownMs: 900, drops: Object.freeze([ { itemId: EssenceItemId[MagicElement.dark], chance: 1 } ]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, /** Spawner shades are hostile; summoned shades opt out via Component.summon. */ aggressive: true, aggroRangeTiles: 5, bloomBody: true, gait: "walk", sex: "male", /** Body sheet is static; bloom flickers on its own. */ frames: 1, framesPerRow: 1, animationSpeed: 0, bloomFrames: 2, bloomFramesPerRow: 2, /** Match elemental sprite bloom cadence. */ bloomAnimationSpeed: 0.5, defaultState: "shade" }), [MobId.sprite]: Object.freeze({ mobTypeId: MobId.sprite, key: "sprite", assetFolder: "mobs", displayName: "Sprite", health: 35, maxHealth: 35, maxHealthFromLevel: "levelPlus10", attackSkill: 25, attackCooldownMs: 1100, drops: Object.freeze([]), /** Essence drop is resolved from the creature's chosen element on death. */ essenceDropChance: 1, sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: true, aggroRangeTiles: 6, preferSpellAttack: true, lightRadiusTiles: 2, randomElementOnSpawn: true, bloomBody: true, gait: "walk", sex: "male", frames: 2, framesPerRow: 2, animationSpeed: 0.5 }), [MobId.fairy]: Object.freeze({ mobTypeId: MobId.fairy, key: "fairy", assetFolder: "mobs", displayName: "Fairy", health: 40, maxHealth: 40, maxHealthFromLevel: "levelPlus10", attackSkill: 55, attackCooldownMs: 1000, drops: Object.freeze([ { itemId: ClothItemId.fairySilk, chance: 0.7 } ]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: true, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: true, aggroRangeTiles: 5, /** Prefer sprite-style elemental bolts over melee. */ preferSpellAttack: true, /** Cast a random-element sprite bolt each attack (no fixed spawn element). */ randomElementSpell: true, /** On hit, flee until at least this many tiles from the hit source (then stop until hit again). */ fleeOnHitTiles: 2, /** Dimmer than elemental sprites (radius 2). */ lightRadiusTiles: 1, bloomBody: true, /** Shirt/skirt/hair use dual-channel body tints rolled on spawn. */ dualChannelAppearance: true, gait: "walk", sex: "female", frames: 2, framesPerRow: 2, animationSpeed: 0.45, defaultState: "fairy" }), [MobId.humanoid]: Object.freeze({ mobTypeId: MobId.humanoid, key: "humanoid", assetFolder: "characters", displayName: "Humanoid", health: 10, maxHealth: 10, /** HP = spawner level + 10 (same floor as a starting player's Health). */ maxHealthFromLevel: "levelPlus10", drops: Object.freeze([]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: true, untargetable: false, aggressive: false, usePlayerBody: true, gait: "walk", sex: "male", frames: 1, framesPerRow: 1, animationSpeed: 0 }), [MobId.townGuard]: Object.freeze({ mobTypeId: MobId.townGuard, key: "town-guard", assetFolder: "characters", displayName: "Town Guard", health: 10, maxHealth: 10, maxHealthFromLevel: "levelPlus10", drops: Object.freeze([]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: false, usePlayerBody: true, townGuard: true, gait: "walk", sex: "male", frames: 1, framesPerRow: 1, animationSpeed: 0 }), [MobId.centralExchange]: Object.freeze({ mobTypeId: MobId.centralExchange, key: "central-exchange", assetFolder: "characters", displayName: "Central Exchange staff", health: 10, maxHealth: 10, maxHealthFromLevel: "levelPlus10", drops: Object.freeze([]), sells: Object.freeze([]), dialogue: Object.freeze([]), persistent: false, flying: false, freeFlight: false, ambient: false, talkable: false, untargetable: false, aggressive: false, usePlayerBody: true, centralExchange: true, gait: "walk", sex: "male", frames: 1, framesPerRow: 1, animationSpeed: 0 }) }); export function mobDefinition (mobTypeId) { return MOB_DEFINITIONS[mobTypeId] ?? null; } export function mobSpriteName (mobTypeId, visualState = null) { const def = mobDefinition(mobTypeId); const key = def?.spriteKey ?? def?.key ?? def?.mobTypeId ?? "deer"; if (def?.usePlayerBody) { // Editor palette preview; live entities use appearance.sex → bodySprite(). return spriteImageName("character", "player-body-male", "player-body-male"); } if (def?.sprite) { return def.sprite; } const state = visualState ?? def?.defaultState ?? key; return spriteImageName("mob", key, state); } /** Whether this mob definition can be sheared for cloth fibre. */ export function mobIsShearable (mobTypeId) { return !!mobDefinition(mobTypeId)?.shearable; } export function defaultSpawnerConfig (spawnerId, mobTypeId = MobId.deer) { const humanoid = isHumanoidMob(mobTypeId) || mobTypeId === MobId.humanoid; const townGuard = mobTypeId === MobId.townGuard; const centralExchange = mobTypeId === MobId.centralExchange; const bodyNpc = humanoid || townGuard || centralExchange; const level = townGuard ? 30 : (mobTypeId === MobId.goblin ? 5 : (mobTypeId === MobId.sprite ? 25 : (mobTypeId === MobId.shade ? 28 : (mobTypeId === MobId.fairy ? 70 : 1)))); const bounty = townGuard ? 500 : 0; return { spawnerId, mobTypeId, maxAlive: centralExchange ? centralExchangeStaffCount() : (bodyNpc ? 1 : 3), /** Seconds after death before this spawner may refill that slot (0 = next spawner tick). */ respawnDelaySeconds: 25, spawnRangeTiles: bodyNpc ? 1 : 4, maxWanderRangeTiles: bodyNpc ? 1 : 8, level, bounty, /** Humanoid spawners only: auto-engage players in aggro range. Forces bounty 0. */ aggressive: false, sex: "male", displayName: townGuard ? "Town Guard" : (humanoid ? "Shopkeeper" : ""), equipment: townGuard ? { head: ArmourItemId.ironHelmet, chest: ArmourItemId.ironChestplate, legs: ArmourItemId.bronzeGreaves, boots: ArmourItemId.ironBoots, weapon: WoodItemId.oakQuarterstaff, offhand: null } : emptySpawnerEquipment(), sells: [], drops: [], spells: [], buysItems: false, hiddenDiscount: 0.9, centralExchange, townGuard, dialogueId: null }; } function emptySpawnerEquipment () { return { head: null, chest: null, legs: null, boots: null, weapon: null, offhand: null }; } /** * Spawner equipment entry: legacy itemId number, or `{ itemId, dyeColor? }` for dyed clothing. * Normalized form keeps a plain number when undyed (world-save compatible). */ function normalizeEquipmentEntry (value) { if (value == null || value === "" || value === "0") { return null; } let itemId = 0; let dyeColor = null; if (typeof value === "object") { itemId = Number(value.itemId) | 0; dyeColor = normalizeDyeColor(value.dyeColor); } else { itemId = Number(value) | 0; } if (!Number.isFinite(itemId) || itemId <= 0) { return null; } if (!dyeColor) { return itemId; } return Object.freeze({ itemId, dyeColor }); } function normalizeDyeColor (raw) { if (!raw || typeof raw !== "object") { return null; } const r = Number(raw.r); const g = Number(raw.g); const b = Number(raw.b); if (![r, g, b].every(Number.isFinite)) { return null; } const asByte = r > 1 || g > 1 || b > 1; return Object.freeze({ r: Math.min(1, Math.max(0, asByte ? r / 255 : r)), g: Math.min(1, Math.max(0, asByte ? g / 255 : g)), b: Math.min(1, Math.max(0, asByte ? b / 255 : b)) }); } function normalizeEquipment (raw) { const next = emptySpawnerEquipment(); if (!raw || typeof raw !== "object") { return next; } for (const slot of Object.keys(next)) { next[slot] = normalizeEquipmentEntry(raw[slot]); } return next; } /** Resolve authored spawner equipment into itemId (+ optional dye). */ export function spawnerEquipmentSlot (entry) { if (entry == null) { return { itemId: 0, dyeColor: null }; } if (typeof entry === "object") { return { itemId: Number(entry.itemId) | 0, dyeColor: entry.dyeColor ?? null }; } return { itemId: Number(entry) | 0, dyeColor: null }; } function normalizeSells (raw) { if (!Array.isArray(raw)) { return []; } const lines = []; const seen = new Set(); for (const entry of raw) { let itemId; let quantity = 0; if (entry && typeof entry === "object") { itemId = Number(entry.itemId); quantity = Math.max(0, Number(entry.quantity) || 0) | 0; } else { itemId = Number(entry); } if (!Number.isFinite(itemId) || itemId <= 0 || seen.has(itemId | 0)) { continue; } seen.add(itemId | 0); lines.push({ itemId: itemId | 0, quantity }); } return lines; } /** * Spawner loot lines. Chance is 0–1 (UI edits as 0–100%). * Quantity is rolled inclusively between quantityMin and quantityMax when the drop hits. * @returns {ReadonlyArray<{ itemId: number, chance: number, quantityMin: number, quantityMax: number }>} */ function normalizeDrops (raw) { if (!Array.isArray(raw)) { return []; } const lines = []; const seen = new Set(); for (const entry of raw) { if (!entry || typeof entry !== "object") { continue; } const itemId = Number(entry.itemId) | 0; if (!Number.isFinite(itemId) || itemId <= 0 || seen.has(itemId)) { continue; } seen.add(itemId); let chance = Number(entry.chance); if (!Number.isFinite(chance)) { chance = 1; } // Accept editor percent (0–100) or fraction (0–1). if (chance > 1) { chance = chance / 100; } chance = Math.min(1, Math.max(0, chance)); let quantityMin = Math.max(0, Math.floor(Number( entry.quantityMin ?? entry.quantity ?? 1 ))); let quantityMax = Math.max(0, Math.floor(Number( entry.quantityMax ?? entry.quantityMin ?? entry.quantity ?? quantityMin ))); if (!Number.isFinite(quantityMin)) { quantityMin = 1; } if (!Number.isFinite(quantityMax)) { quantityMax = quantityMin; } if (quantityMax < quantityMin) { quantityMax = quantityMin; } lines.push(Object.freeze({ itemId, chance, quantityMin, quantityMax })); } return lines; } function normalizeSpells (raw) { if (!Array.isArray(raw)) { return []; } const lines = []; const seen = new Set(); for (const entry of raw) { if (!entry || typeof entry !== "object") { continue; } const spellId = String(entry.spellId ?? "").trim(); // Drop unknown / retired ids (e.g. legacy spark) so spawners stay loadable. if (!spellId || seen.has(spellId) || !spellDefinition(spellId)) { continue; } seen.add(spellId); // Cast chance is derived from mob level at spawn time — not stored. lines.push({ spellId }); } return lines; } /** Clamp wander ≥ spawn; coerce numeric fields; keep humanoid shop/appearance options. */ export function normalizeSpawnerConfig (config, spawnerId = "spawner") { const mobTypeId = config?.mobTypeId ?? MobId.deer; const centralExchange = mobTypeId === MobId.centralExchange || !!config?.centralExchange; const townGuard = !centralExchange && (mobTypeId === MobId.townGuard || !!config?.townGuard); const effectiveMob = centralExchange ? MobId.centralExchange : (townGuard ? MobId.townGuard : mobTypeId); const base = defaultSpawnerConfig(spawnerId, effectiveMob); const merged = { ...base, ...(config ?? {}), spawnerId: config?.spawnerId || spawnerId, mobTypeId: effectiveMob }; const spawnRangeTiles = Math.max(1, Math.min(32, Number(merged.spawnRangeTiles) || base.spawnRangeTiles)); const maxWanderRangeTiles = Math.max( spawnRangeTiles, Math.min(64, Number(merged.maxWanderRangeTiles) || spawnRangeTiles) ); const sex = merged.sex === "female" ? "female" : "male"; const hiddenDiscount = Math.min(1, Math.max(0.01, Number(merged.hiddenDiscount) || base.hiddenDiscount)); const displayName = String(merged.displayName ?? "").trim().slice(0, 48); const staffCap = centralExchangeStaffCount(); const level = Math.max(1, Math.min(99, Number(merged.level) || base.level || 1)) | 0; const bodyNpc = isHumanoidMob(effectiveMob) || centralExchange || townGuard; const aggressive = bodyNpc ? !!merged.aggressive : false; const bounty = aggressive ? 0 : (Math.max(0, Number(merged.bounty) || 0) | 0); return { spawnerId: String(merged.spawnerId), mobTypeId: effectiveMob, maxAlive: centralExchange ? staffCap : Math.max(1, Math.min(20, Number(merged.maxAlive) || base.maxAlive)), respawnDelaySeconds: Math.max( 0, Math.min( 86_400, Math.floor( Number( merged.respawnDelaySeconds != null && merged.respawnDelaySeconds !== "" ? merged.respawnDelaySeconds : base.respawnDelaySeconds ) || 0 ) ) ), spawnRangeTiles, maxWanderRangeTiles, level, bounty, aggressive, sex, displayName, equipment: normalizeEquipment(merged.equipment), sells: centralExchange ? [] : normalizeSells(merged.sells), drops: bodyNpc ? normalizeDrops(merged.drops) : [], spells: normalizeSpells(merged.spells), buysItems: centralExchange ? false : !!merged.buysItems, hiddenDiscount, centralExchange, townGuard, dialogueId: bodyNpc ? (String(merged.dialogueId ?? "").trim().slice(0, 64) || null) : null }; } export function listAmbientMobTypes () { return Object.values(MOB_DEFINITIONS).filter((def) => def.ambient); } /** Every mob type that can be authored as a world-editor spawner. */ export function listSpawnableMobTypes () { return Object.values(MOB_DEFINITIONS); } export function isHumanoidMob (mobTypeId) { return mobDefinition(mobTypeId)?.usePlayerBody === true; } export function isTownGuardMob (mobTypeId) { return mobTypeId === MobId.townGuard || !!mobDefinition(mobTypeId)?.townGuard; } export function isCentralExchangeSpawner (configOrMobTypeId) { if (configOrMobTypeId && typeof configOrMobTypeId === "object") { return !!configOrMobTypeId.centralExchange || configOrMobTypeId.mobTypeId === MobId.centralExchange; } return configOrMobTypeId === MobId.centralExchange; } /** Max HP for a mob at the given spawner level. */ export function mobMaxHealthForLevel (def, level) { const lv = Math.max(1, Math.floor(Number(level) || 1)); const formula = def?.maxHealthFromLevel; if (formula === "levelPlus10" || (!formula && def?.usePlayerBody)) { return lv + 10; } const base = Math.max(1, Number(def?.health ?? def?.maxHealth ?? 8) || 8); return Math.max(1, base + (lv - 1)); } /** Display label for hover / UI: `Lv.5 Deer`. */ export function mobLevelDisplayName (level, displayName) { const lv = Math.max(1, Math.floor(Number(level) || 1)); const name = String(displayName ?? "").trim() || "Creature"; return `Lv.${lv} ${name}`; }