BlueGit

timfa questward

Files

questward / server / src / assets / spriteCatalog.js

spriteCatalog.js

spriteCatalog.js 6.1 KiB Download Raw
1import { readdirSync } from "node:fs";
2import { extname, join } from "node:path";
3import { BLOCK_DEFINITIONS, GROUND_DEFINITIONS } from "../../../shared/definitions/tiles.js";
4import { ITEM_DEFINITIONS } from "../../../shared/definitions/items.js";
5import { MOB_DEFINITIONS } from "../../../shared/definitions/mobs.js";
6import {
7 bloomImageName,
8 equipBloomImageName,
9 equipImageName,
10 isCompanionSpriteStem,
11 parseSpriteStem,
12 spriteImageName
13} from "../../../shared/definitions/tileSprites.js";
14
15const CHARACTER_DEFINITIONS = Object.freeze({
16 "player-body-male": Object.freeze({ key: "player-body-male", id: "player-body-male" }),
17 "player-body-female": Object.freeze({ key: "player-body-female", id: "player-body-female" })
18});
19
20export function buildSpriteCatalog (assetRoot)
21{
22 const grounds = scanLayer(join(assetRoot, "grounds"), GROUND_DEFINITIONS, "ground", "grounds");
23 const blocks = scanLayer(join(assetRoot, "blocks"), BLOCK_DEFINITIONS, "block", "blocks");
24 const items = scanLayer(join(assetRoot, "items"), itemScanDefs(), "item", "items");
25 const mobs = scanMobLayers(assetRoot);
26 const characters = scanLayer(join(assetRoot, "characters"), CHARACTER_DEFINITIONS, "character", "characters");
27 const fx = scanFx(join(assetRoot, "fx"));
28 return {
29 grounds: grounds.types,
30 blocks: blocks.types,
31 items: items.types,
32 mobs: mobs.types,
33 characters: characters.types,
34 fx: fx.types,
35 images: [
36 ...grounds.images,
37 ...blocks.images,
38 ...items.images,
39 ...mobs.images,
40 ...characters.images,
41 ...fx.images
42 ]
43 };
44}
45
46function itemScanDefs ()
47{
48 const defs = {};
49 for (const def of Object.values(ITEM_DEFINITIONS))
50 {
51 defs[def.key] = {
52 key: def.key,
53 id: def.itemId,
54 frames: def.frames ?? 1,
55 framesPerRow: def.framesPerRow ?? 1,
56 animationSpeed: def.animationSpeed ?? 0
57 };
58 }
59 return defs;
60}
61
62function mobScanDefs ()
63{
64 const defs = {};
65 for (const def of Object.values(MOB_DEFINITIONS))
66 {
67 const key = def.key ?? def.mobTypeId;
68 defs[key] = {
69 key,
70 id: def.mobTypeId,
71 frames: def.frames ?? 1,
72 framesPerRow: def.framesPerRow ?? 1,
73 animationSpeed: def.animationSpeed ?? 0,
74 assetFolder: def.assetFolder ?? "mobs"
75 };
76 }
77 return defs;
78}
79
80function scanMobLayers (assetRoot)
81{
82 const byFolder = new Map();
83 for (const def of Object.values(mobScanDefs()))
84 {
85 const folder = def.assetFolder ?? "mobs";
86 if (!byFolder.has(folder))
87 { byFolder.set(folder, {}); }
88 byFolder.get(folder)[def.key] = def;
89 }
90 const types = {};
91 const images = [];
92 for (const [folder, defs] of byFolder)
93 {
94 const scanned = scanLayer(join(assetRoot, folder), defs, "mob", folder);
95 Object.assign(types, scanned.types);
96 images.push(...scanned.images);
97 }
98 return { types, images };
99}
100
101function scanFx (fxRoot)
102{
103 const types = {};
104 const images = [];
105 let folders;
106 try
107 { folders = readdirSync(fxRoot, { withFileTypes: true }).filter((entry) => entry.isDirectory()); }
108 catch (error)
109 {
110 if (error.code === "ENOENT")
111 { return { types, images }; }
112 throw error;
113 }
114 for (const entry of folders)
115 {
116 const key = entry.name;
117 const defs = {
118 [key]: { key, id: key, frames: 1, framesPerRow: 1, animationSpeed: 0 }
119 };
120 const scanned = scanLayer(fxRoot, defs, "fx", "fx");
121 Object.assign(types, scanned.types);
122 images.push(...scanned.images);
123 }
124 return { types, images };
125}
126
127function scanLayer (layerDir, definitions, layer, urlFolder)
128{
129 const types = {};
130 const images = [];
131 for (const def of Object.values(definitions))
132 {
133 const folder = join(layerDir, def.key);
134 const { states, blooms, equips, equipBlooms } = listVisualStates(folder);
135 if (states.length === 0)
136 { throw new Error(`No PNG states in ${folder}`); }
137
138 const frames = Math.max(1, def.frames ?? 1);
139 const framesPerRow = Math.max(1, def.framesPerRow ?? 1);
140 const animationSpeed = Math.max(0, def.animationSpeed ?? 0);
141 types[def.key] = {
142 key: def.key,
143 typeId: def.id,
144 states,
145 defaultState: states[0],
146 blooms,
147 equips,
148 equipBlooms,
149 frames,
150 framesPerRow,
151 animationSpeed
152 };
153 for (const state of states)
154 {
155 const sheet = {
156 subImgTotal: frames,
157 perRow: framesPerRow,
158 loop: animationSpeed > 0,
159 animationSpeed
160 };
161 images.push({
162 name: spriteImageName(layer, def.key, state),
163 url: `/assets/${urlFolder}/${def.key}/${state}.png`,
164 ...sheet
165 });
166 if (blooms[state])
167 {
168 images.push({
169 name: bloomImageName(layer, def.key, state),
170 url: `/assets/${urlFolder}/${def.key}/${state}-bloom.png`,
171 ...sheet
172 });
173 }
174 if (equips[state])
175 {
176 images.push({
177 name: equipImageName(layer, def.key, state),
178 url: `/assets/${urlFolder}/${def.key}/${state}-equip.png`,
179 ...sheet
180 });
181 }
182 if (equipBlooms[state])
183 {
184 images.push({
185 name: equipBloomImageName(layer, def.key, state),
186 url: `/assets/${urlFolder}/${def.key}/${state}-equip-bloom.png`,
187 ...sheet
188 });
189 }
190 }
191 }
192 return { types, images };
193}
194
195function listVisualStates (folder)
196{
197 const stems = listPngStems(folder);
198 const blooms = {};
199 const equips = {};
200 const equipBlooms = {};
201 const states = [];
202 for (const stem of stems)
203 {
204 const parsed = parseSpriteStem(stem);
205 if (parsed.companion)
206 {
207 if (!parsed.base)
208 { continue; }
209 if (parsed.equip && parsed.bloom)
210 { equipBlooms[parsed.base] = true; }
211 else if (parsed.equip)
212 { equips[parsed.base] = true; }
213 else if (parsed.bloom)
214 { blooms[parsed.base] = true; }
215 continue;
216 }
217 if (isCompanionSpriteStem(stem))
218 { continue; }
219 states.push(stem);
220 }
221 const filterMap = (map) =>
222 {
223 const next = {};
224 for (const state of states)
225 {
226 if (map[state])
227 { next[state] = true; }
228 }
229 return next;
230 };
231 return {
232 states,
233 blooms: filterMap(blooms),
234 equips: filterMap(equips),
235 equipBlooms: filterMap(equipBlooms)
236 };
237}
238
239function listPngStems (folder)
240{
241 let entries;
242 try
243 { entries = readdirSync(folder, { withFileTypes: true }); }
244 catch (error)
245 {
246 if (error.code === "ENOENT")
247 { return []; }
248 throw error;
249 }
250
251 return entries
252 .filter((entry) => entry.isFile() && extname(entry.name).toLowerCase() === ".png")
253 .map((entry) => entry.name.slice(0, -extname(entry.name).length))
254 .sort((a, b) => a.localeCompare(b, "en", { numeric: true, sensitivity: "base" }));
255}