| 1 | import { CHUNK_SIZE, REGION_CHUNKS } from "../../../shared/protocol/constants.js"; |
| 2 | import { OVERWORLD_ID, normalizeDimensionId } from "../../../shared/world/dimensions.js"; |
| 3 | |
| 4 | export function floorDiv (value, divisor) |
| 5 | { |
| 6 | return Math.floor(value / divisor); |
| 7 | } |
| 8 | |
| 9 | export function tileToChunk (tile) |
| 10 | { |
| 11 | return floorDiv(tile, CHUNK_SIZE); |
| 12 | } |
| 13 | |
| 14 | export function chunkToRegion (chunk) |
| 15 | { |
| 16 | return floorDiv(chunk, REGION_CHUNKS); |
| 17 | } |
| 18 | |
| 19 | export function chunkOriginTile (chunk) |
| 20 | { |
| 21 | return chunk * CHUNK_SIZE; |
| 22 | } |
| 23 | |
| 24 | export function tileToLocal (tile) |
| 25 | { |
| 26 | return ((tile % CHUNK_SIZE) + CHUNK_SIZE) % CHUNK_SIZE; |
| 27 | } |
| 28 | |
| 29 | export function localToTile (chunk, local) |
| 30 | { |
| 31 | return chunkOriginTile(chunk) + local; |
| 32 | } |
| 33 | |
| 34 | export function tileIndex (localX, localY) |
| 35 | { |
| 36 | return localY * CHUNK_SIZE + localX; |
| 37 | } |
| 38 | |
| 39 | export 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] */ |
| 48 | export function regionKey (regionX, regionY, dimensionId = OVERWORLD_ID) |
| 49 | { |
| 50 | const dim = normalizeDimensionId(dimensionId); |
| 51 | return `${dim}|${regionX},${regionY}`; |
| 52 | } |
| 53 | |
| 54 | export 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 | |
| 68 | export function tileToRegion (tile) |
| 69 | { |
| 70 | return chunkToRegion(tileToChunk(tile)); |
| 71 | } |
| 72 | |
| 73 | export function regionOriginChunk (region) |
| 74 | { |
| 75 | return region * REGION_CHUNKS; |
| 76 | } |
| 77 | |
| 78 | export 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 | |
| 91 | export 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 | |
| 103 | export 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] */ |
| 115 | export function chunkKey (chunkX, chunkY, dimensionId = OVERWORLD_ID) |
| 116 | { |
| 117 | const dim = normalizeDimensionId(dimensionId); |
| 118 | return `${dim}|${chunkX},${chunkY}`; |
| 119 | } |
| 120 | |
| 121 | export 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 | |
| 135 | export function tileKey (tileX, tileY, dimensionId = OVERWORLD_ID) |
| 136 | { |
| 137 | const dim = normalizeDimensionId(dimensionId); |
| 138 | return `${dim}|${tileX},${tileY}`; |
| 139 | } |
| 140 | |
| 141 | export 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 | |
| 154 | export function chebyshevChunks (chunkX, chunkY, chunkRadius) |
| 155 | { |
| 156 | return visibleChunkCoords(chunkX, chunkY, chunkRadius); |
| 157 | } |
| 158 | |
| 159 | export function maxLightChunkRadius (lightRangeTiles) |
| 160 | { |
| 161 | return Math.ceil(Math.max(0, lightRangeTiles) / CHUNK_SIZE); |
| 162 | } |