BlueGit

timfa questward

Files

questward / server / src / world / coordinates.js

coordinates.js

coordinates.js 3.8 KiB Download Raw
1import { CHUNK_SIZE, REGION_CHUNKS } from "../../../shared/protocol/constants.js";
2import { OVERWORLD_ID, normalizeDimensionId } from "../../../shared/world/dimensions.js";
3
4export function floorDiv (value, divisor)
5{
6 return Math.floor(value / divisor);
7}
8
9export function tileToChunk (tile)
10{
11 return floorDiv(tile, CHUNK_SIZE);
12}
13
14export function chunkToRegion (chunk)
15{
16 return floorDiv(chunk, REGION_CHUNKS);
17}
18
19export function chunkOriginTile (chunk)
20{
21 return chunk * CHUNK_SIZE;
22}
23
24export function tileToLocal (tile)
25{
26 return ((tile % CHUNK_SIZE) + CHUNK_SIZE) % CHUNK_SIZE;
27}
28
29export function localToTile (chunk, local)
30{
31 return chunkOriginTile(chunk) + local;
32}
33
34export function tileIndex (localX, localY)
35{
36 return localY * CHUNK_SIZE + localX;
37}
38
39export function indexToLocal (index)
40{
41 return {
42 localX: index % CHUNK_SIZE,
43 localY: Math.floor(index / CHUNK_SIZE)
44 };
45}
46
47/** @param {string} [dimensionId] */
48export function regionKey (regionX, regionY, dimensionId = OVERWORLD_ID)
49{
50 const dim = normalizeDimensionId(dimensionId);
51 return `${dim}|${regionX},${regionY}`;
52}
53
54export function parseRegionKey (key)
55{
56 const raw = String(key ?? "");
57 const pipe = raw.indexOf("|");
58 if (pipe < 0)
59 {
60 const [regionX, regionY] = raw.split(",").map(Number);
61 return { dimensionId: OVERWORLD_ID, regionX, regionY };
62 }
63 const dimensionId = normalizeDimensionId(raw.slice(0, pipe));
64 const [regionX, regionY] = raw.slice(pipe + 1).split(",").map(Number);
65 return { dimensionId, regionX, regionY };
66}
67
68export function tileToRegion (tile)
69{
70 return chunkToRegion(tileToChunk(tile));
71}
72
73export function regionOriginChunk (region)
74{
75 return region * REGION_CHUNKS;
76}
77
78export function chunksInRegion (regionX, regionY)
79{
80 const originX = regionOriginChunk(regionX);
81 const originY = regionOriginChunk(regionY);
82 const coords = [];
83 for (let localY = 0; localY < REGION_CHUNKS; localY++)
84 {
85 for (let localX = 0; localX < REGION_CHUNKS; localX++)
86 { coords.push({ chunkX: originX + localX, chunkY: originY + localY }); }
87 }
88 return coords;
89}
90
91export function regionTileBounds (regionX, regionY)
92{
93 const minChunkX = regionOriginChunk(regionX);
94 const minChunkY = regionOriginChunk(regionY);
95 return {
96 minX: minChunkX * CHUNK_SIZE,
97 minY: minChunkY * CHUNK_SIZE,
98 maxX: (minChunkX + REGION_CHUNKS) * CHUNK_SIZE - 1,
99 maxY: (minChunkY + REGION_CHUNKS) * CHUNK_SIZE - 1
100 };
101}
102
103export function visibleRegionCoords (regionX, regionY, radius = 1)
104{
105 const coords = [];
106 for (let dy = -radius; dy <= radius; dy++)
107 {
108 for (let dx = -radius; dx <= radius; dx++)
109 { coords.push({ regionX: regionX + dx, regionY: regionY + dy }); }
110 }
111 return coords;
112}
113
114/** @param {string} [dimensionId] */
115export function chunkKey (chunkX, chunkY, dimensionId = OVERWORLD_ID)
116{
117 const dim = normalizeDimensionId(dimensionId);
118 return `${dim}|${chunkX},${chunkY}`;
119}
120
121export function parseChunkKey (key)
122{
123 const raw = String(key ?? "");
124 const pipe = raw.indexOf("|");
125 if (pipe < 0)
126 {
127 const [chunkX, chunkY] = raw.split(",").map(Number);
128 return { dimensionId: OVERWORLD_ID, chunkX, chunkY };
129 }
130 const dimensionId = normalizeDimensionId(raw.slice(0, pipe));
131 const [chunkX, chunkY] = raw.slice(pipe + 1).split(",").map(Number);
132 return { dimensionId, chunkX, chunkY };
133}
134
135export function tileKey (tileX, tileY, dimensionId = OVERWORLD_ID)
136{
137 const dim = normalizeDimensionId(dimensionId);
138 return `${dim}|${tileX},${tileY}`;
139}
140
141export function visibleChunkCoords (chunkX, chunkY, radius = 1)
142{
143 const coords = [];
144 for (let dy = -radius; dy <= radius; dy++)
145 {
146 for (let dx = -radius; dx <= radius; dx++)
147 {
148 coords.push({ chunkX: chunkX + dx, chunkY: chunkY + dy });
149 }
150 }
151 return coords;
152}
153
154export function chebyshevChunks (chunkX, chunkY, chunkRadius)
155{
156 return visibleChunkCoords(chunkX, chunkY, chunkRadius);
157}
158
159export function maxLightChunkRadius (lightRangeTiles)
160{
161 return Math.ceil(Math.max(0, lightRangeTiles) / CHUNK_SIZE);
162}