import { readdirSync } from "node:fs"; import { extname, join } from "node:path"; import { BLOCK_DEFINITIONS, GROUND_DEFINITIONS } from "../../../shared/definitions/tiles.js"; import { ITEM_DEFINITIONS } from "../../../shared/definitions/items.js"; import { MOB_DEFINITIONS } from "../../../shared/definitions/mobs.js"; import { bloomImageName, equipBloomImageName, equipImageName, isCompanionSpriteStem, parseSpriteStem, spriteImageName } from "../../../shared/definitions/tileSprites.js"; const CHARACTER_DEFINITIONS = Object.freeze({ "player-body-male": Object.freeze({ key: "player-body-male", id: "player-body-male" }), "player-body-female": Object.freeze({ key: "player-body-female", id: "player-body-female" }) }); export function buildSpriteCatalog (assetRoot) { const grounds = scanLayer(join(assetRoot, "grounds"), GROUND_DEFINITIONS, "ground", "grounds"); const blocks = scanLayer(join(assetRoot, "blocks"), BLOCK_DEFINITIONS, "block", "blocks"); const items = scanLayer(join(assetRoot, "items"), itemScanDefs(), "item", "items"); const mobs = scanMobLayers(assetRoot); const characters = scanLayer(join(assetRoot, "characters"), CHARACTER_DEFINITIONS, "character", "characters"); const fx = scanFx(join(assetRoot, "fx")); return { grounds: grounds.types, blocks: blocks.types, items: items.types, mobs: mobs.types, characters: characters.types, fx: fx.types, images: [ ...grounds.images, ...blocks.images, ...items.images, ...mobs.images, ...characters.images, ...fx.images ] }; } function itemScanDefs () { const defs = {}; for (const def of Object.values(ITEM_DEFINITIONS)) { defs[def.key] = { key: def.key, id: def.itemId, frames: def.frames ?? 1, framesPerRow: def.framesPerRow ?? 1, animationSpeed: def.animationSpeed ?? 0 }; } return defs; } function mobScanDefs () { const defs = {}; for (const def of Object.values(MOB_DEFINITIONS)) { const key = def.key ?? def.mobTypeId; defs[key] = { key, id: def.mobTypeId, frames: def.frames ?? 1, framesPerRow: def.framesPerRow ?? 1, animationSpeed: def.animationSpeed ?? 0, assetFolder: def.assetFolder ?? "mobs" }; } return defs; } function scanMobLayers (assetRoot) { const byFolder = new Map(); for (const def of Object.values(mobScanDefs())) { const folder = def.assetFolder ?? "mobs"; if (!byFolder.has(folder)) { byFolder.set(folder, {}); } byFolder.get(folder)[def.key] = def; } const types = {}; const images = []; for (const [folder, defs] of byFolder) { const scanned = scanLayer(join(assetRoot, folder), defs, "mob", folder); Object.assign(types, scanned.types); images.push(...scanned.images); } return { types, images }; } function scanFx (fxRoot) { const types = {}; const images = []; let folders; try { folders = readdirSync(fxRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()); } catch (error) { if (error.code === "ENOENT") { return { types, images }; } throw error; } for (const entry of folders) { const key = entry.name; const defs = { [key]: { key, id: key, frames: 1, framesPerRow: 1, animationSpeed: 0 } }; const scanned = scanLayer(fxRoot, defs, "fx", "fx"); Object.assign(types, scanned.types); images.push(...scanned.images); } return { types, images }; } function scanLayer (layerDir, definitions, layer, urlFolder) { const types = {}; const images = []; for (const def of Object.values(definitions)) { const folder = join(layerDir, def.key); const { states, blooms, equips, equipBlooms } = listVisualStates(folder); if (states.length === 0) { throw new Error(`No PNG states in ${folder}`); } const frames = Math.max(1, def.frames ?? 1); const framesPerRow = Math.max(1, def.framesPerRow ?? 1); const animationSpeed = Math.max(0, def.animationSpeed ?? 0); types[def.key] = { key: def.key, typeId: def.id, states, defaultState: states[0], blooms, equips, equipBlooms, frames, framesPerRow, animationSpeed }; for (const state of states) { const sheet = { subImgTotal: frames, perRow: framesPerRow, loop: animationSpeed > 0, animationSpeed }; images.push({ name: spriteImageName(layer, def.key, state), url: `/assets/${urlFolder}/${def.key}/${state}.png`, ...sheet }); if (blooms[state]) { images.push({ name: bloomImageName(layer, def.key, state), url: `/assets/${urlFolder}/${def.key}/${state}-bloom.png`, ...sheet }); } if (equips[state]) { images.push({ name: equipImageName(layer, def.key, state), url: `/assets/${urlFolder}/${def.key}/${state}-equip.png`, ...sheet }); } if (equipBlooms[state]) { images.push({ name: equipBloomImageName(layer, def.key, state), url: `/assets/${urlFolder}/${def.key}/${state}-equip-bloom.png`, ...sheet }); } } } return { types, images }; } function listVisualStates (folder) { const stems = listPngStems(folder); const blooms = {}; const equips = {}; const equipBlooms = {}; const states = []; for (const stem of stems) { const parsed = parseSpriteStem(stem); if (parsed.companion) { if (!parsed.base) { continue; } if (parsed.equip && parsed.bloom) { equipBlooms[parsed.base] = true; } else if (parsed.equip) { equips[parsed.base] = true; } else if (parsed.bloom) { blooms[parsed.base] = true; } continue; } if (isCompanionSpriteStem(stem)) { continue; } states.push(stem); } const filterMap = (map) => { const next = {}; for (const state of states) { if (map[state]) { next[state] = true; } } return next; }; return { states, blooms: filterMap(blooms), equips: filterMap(equips), equipBlooms: filterMap(equipBlooms) }; } function listPngStems (folder) { let entries; try { entries = readdirSync(folder, { withFileTypes: true }); } catch (error) { if (error.code === "ENOENT") { return []; } throw error; } return entries .filter((entry) => entry.isFile() && extname(entry.name).toLowerCase() === ".png") .map((entry) => entry.name.slice(0, -extname(entry.name).length)) .sort((a, b) => a.localeCompare(b, "en", { numeric: true, sensitivity: "base" })); }