BlueGit

timfa questward

Files

questward / server / src / assets / spriteCatalog.js

spriteCatalog.js

spriteCatalog.js 4.9 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 = scanLayer(join(assetRoot, "mobs"), mobScanDefs(), "mob", "mobs");
26 const characters = scanLayer(join(assetRoot, "characters"), CHARACTER_DEFINITIONS, "character", "characters");
27 return {
28 grounds: grounds.types,
29 blocks: blocks.types,
30 items: items.types,
31 mobs: mobs.types,
32 characters: characters.types,
33 images: [
34 ...grounds.images,
35 ...blocks.images,
36 ...items.images,
37 ...mobs.images,
38 ...characters.images
39 ]
40 };
41}
42
43function itemScanDefs ()
44{
45 const defs = {};
46 for (const def of Object.values(ITEM_DEFINITIONS))
47 {
48 defs[def.key] = {
49 key: def.key,
50 id: def.itemId,
51 frames: def.frames ?? 1,
52 framesPerRow: def.framesPerRow ?? 1,
53 animationSpeed: def.animationSpeed ?? 0
54 };
55 }
56 return defs;
57}
58
59function mobScanDefs ()
60{
61 const defs = {};
62 for (const def of Object.values(MOB_DEFINITIONS))
63 {
64 const key = def.key ?? def.mobTypeId;
65 defs[key] = {
66 key,
67 id: def.mobTypeId,
68 frames: def.frames ?? 1,
69 framesPerRow: def.framesPerRow ?? 1,
70 animationSpeed: def.animationSpeed ?? 0
71 };
72 }
73 return defs;
74}
75
76function scanLayer (layerDir, definitions, layer, urlFolder)
77{
78 const types = {};
79 const images = [];
80 for (const def of Object.values(definitions))
81 {
82 const folder = join(layerDir, def.key);
83 const { states, blooms, equips, equipBlooms } = listVisualStates(folder);
84 if (states.length === 0)
85 { throw new Error(`No PNG states in ${folder}`); }
86
87 const frames = Math.max(1, def.frames ?? 1);
88 const framesPerRow = Math.max(1, def.framesPerRow ?? 1);
89 const animationSpeed = Math.max(0, def.animationSpeed ?? 0);
90 types[def.key] = {
91 key: def.key,
92 typeId: def.id,
93 states,
94 defaultState: states[0],
95 blooms,
96 equips,
97 equipBlooms,
98 frames,
99 framesPerRow,
100 animationSpeed
101 };
102 for (const state of states)
103 {
104 const sheet = {
105 subImgTotal: frames,
106 perRow: framesPerRow,
107 loop: animationSpeed > 0,
108 animationSpeed
109 };
110 images.push({
111 name: spriteImageName(layer, def.key, state),
112 url: `/assets/${urlFolder}/${def.key}/${state}.png`,
113 ...sheet
114 });
115 if (blooms[state])
116 {
117 images.push({
118 name: bloomImageName(layer, def.key, state),
119 url: `/assets/${urlFolder}/${def.key}/${state}-bloom.png`,
120 ...sheet
121 });
122 }
123 if (equips[state])
124 {
125 images.push({
126 name: equipImageName(layer, def.key, state),
127 url: `/assets/${urlFolder}/${def.key}/${state}-equip.png`,
128 ...sheet
129 });
130 }
131 if (equipBlooms[state])
132 {
133 images.push({
134 name: equipBloomImageName(layer, def.key, state),
135 url: `/assets/${urlFolder}/${def.key}/${state}-equip-bloom.png`,
136 ...sheet
137 });
138 }
139 }
140 }
141 return { types, images };
142}
143
144function listVisualStates (folder)
145{
146 const stems = listPngStems(folder);
147 const blooms = {};
148 const equips = {};
149 const equipBlooms = {};
150 const states = [];
151 for (const stem of stems)
152 {
153 const parsed = parseSpriteStem(stem);
154 if (parsed.companion)
155 {
156 if (!parsed.base)
157 { continue; }
158 if (parsed.equip && parsed.bloom)
159 { equipBlooms[parsed.base] = true; }
160 else if (parsed.equip)
161 { equips[parsed.base] = true; }
162 else if (parsed.bloom)
163 { blooms[parsed.base] = true; }
164 continue;
165 }
166 if (isCompanionSpriteStem(stem))
167 { continue; }
168 states.push(stem);
169 }
170 const filterMap = (map) =>
171 {
172 const next = {};
173 for (const state of states)
174 {
175 if (map[state])
176 { next[state] = true; }
177 }
178 return next;
179 };
180 return {
181 states,
182 blooms: filterMap(blooms),
183 equips: filterMap(equips),
184 equipBlooms: filterMap(equipBlooms)
185 };
186}
187
188function listPngStems (folder)
189{
190 let entries;
191 try
192 { entries = readdirSync(folder, { withFileTypes: true }); }
193 catch (error)
194 {
195 if (error.code === "ENOENT")
196 { return []; }
197 throw error;
198 }
199
200 return entries
201 .filter((entry) => entry.isFile() && extname(entry.name).toLowerCase() === ".png")
202 .map((entry) => entry.name.slice(0, -extname(entry.name).length))
203 .sort((a, b) => a.localeCompare(b, "en", { numeric: true, sensitivity: "base" }));
204}