@starktma/minecraft-utils 1.5.44 → 1.5.46
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/dist/entity-system/EntityManager.d.ts +5 -0
- package/dist/entity-system/EntityManager.d.ts.map +1 -1
- package/dist/entity-system/EntityManager.js +15 -0
- package/dist/entity-system/EntityManager.js.map +1 -1
- package/dist/entity-system/SpatialTracker.d.ts +31 -0
- package/dist/entity-system/SpatialTracker.d.ts.map +1 -0
- package/dist/entity-system/SpatialTracker.js +149 -0
- package/dist/entity-system/SpatialTracker.js.map +1 -0
- package/dist/entity-system/index.d.ts +1 -0
- package/dist/entity-system/index.d.ts.map +1 -1
- package/dist/entity-system/index.js +1 -0
- package/dist/entity-system/index.js.map +1 -1
- package/dist/math/index.d.ts +0 -1
- package/dist/math/index.d.ts.map +1 -1
- package/dist/math/index.js +2 -4
- package/dist/math/index.js.map +1 -1
- package/dist/spatial/BFSScanner.d.ts +40 -0
- package/dist/spatial/BFSScanner.d.ts.map +1 -0
- package/dist/spatial/BFSScanner.js +204 -0
- package/dist/spatial/BFSScanner.js.map +1 -0
- package/dist/spatial/Pathfinder.d.ts +36 -0
- package/dist/spatial/Pathfinder.d.ts.map +1 -0
- package/dist/spatial/Pathfinder.js +211 -0
- package/dist/spatial/Pathfinder.js.map +1 -0
- package/dist/spatial/VolumeScanResult.d.ts +64 -0
- package/dist/spatial/VolumeScanResult.d.ts.map +1 -0
- package/dist/spatial/VolumeScanResult.js +204 -0
- package/dist/spatial/VolumeScanResult.js.map +1 -0
- package/dist/spatial/index.d.ts +4 -0
- package/dist/spatial/index.d.ts.map +1 -0
- package/dist/spatial/index.js +4 -0
- package/dist/spatial/index.js.map +1 -0
- package/package.json +5 -1
- package/dist/math/BFSScanner.d.ts +0 -50
- package/dist/math/BFSScanner.d.ts.map +0 -1
- package/dist/math/BFSScanner.js +0 -386
- package/dist/math/BFSScanner.js.map +0 -1
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"BFSScanner.js","sourceRoot":"","sources":["../../src/spatial/BFSScanner.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,36 @@
|
|
|
1
|
+
import { Vector3 } from "@minecraft/server";
|
|
2
|
+
export interface PathfindingGrid {
|
|
3
|
+
has(worldX: number, worldY: number, worldZ: number): boolean;
|
|
4
|
+
resolution: number;
|
|
5
|
+
}
|
|
6
|
+
/**
|
|
7
|
+
* High-performance 3D A* pathfinder and path simplifier.
|
|
8
|
+
*/
|
|
9
|
+
export declare class AStarPathfinder {
|
|
10
|
+
/**
|
|
11
|
+
* 6 orthogonal 3D search directions.
|
|
12
|
+
*/
|
|
13
|
+
private static readonly DIRECTION_DELTAS;
|
|
14
|
+
/**
|
|
15
|
+
* Packs 3D grid coordinates into a 64-bit BigInt key to avoid string allocations.
|
|
16
|
+
* Coordinates between -1,000,000 and +1,000,000 are supported (21 bits per axis).
|
|
17
|
+
*/
|
|
18
|
+
private static toGridKey;
|
|
19
|
+
/**
|
|
20
|
+
* Unpacks a 64-bit BigInt key back into 3D grid coordinates.
|
|
21
|
+
*/
|
|
22
|
+
private static fromGridKey;
|
|
23
|
+
/**
|
|
24
|
+
* Manhattan distance heuristic on 3D grid coordinates.
|
|
25
|
+
*/
|
|
26
|
+
private static getManhattanDistance;
|
|
27
|
+
/**
|
|
28
|
+
* Simplifies a 3D path by removing collinear intermediate waypoints.
|
|
29
|
+
*/
|
|
30
|
+
static simplifyPath(path: Vector3[]): Vector3[];
|
|
31
|
+
/**
|
|
32
|
+
* Finds a 3D path between two points within a grid-compatible space using A*.
|
|
33
|
+
*/
|
|
34
|
+
static findPath(grid: PathfindingGrid, start: Vector3, goal: Vector3, maxNodes?: number, simplify?: boolean): Vector3[] | undefined;
|
|
35
|
+
}
|
|
36
|
+
//# sourceMappingURL=Pathfinder.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Pathfinder.d.ts","sourceRoot":"","sources":["../../src/spatial/Pathfinder.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC/B,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC7D,UAAU,EAAE,MAAM,CAAC;CACnB;AA6ED;;GAEG;AACH,qBAAa,eAAe;IAC3B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,gBAAgB,CAOtC;IAEF;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,SAAS;IAOxB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,WAAW;IAW1B;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,oBAAoB;IAWnC;;OAEG;IACH,OAAc,YAAY,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,OAAO,EAAE,CAmBrD;IAED;;OAEG;IACH,OAAc,QAAQ,CACrB,IAAI,EAAE,eAAe,EACrB,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAa,EACvB,QAAQ,GAAE,OAAc,GACtB,OAAO,EAAE,GAAG,SAAS,CAoIvB;CACD"}
|
|
@@ -0,0 +1,211 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* Fast binary min-heap priority queue for A* search nodes.
|
|
3
|
+
* O(log N) push and pop, avoiding linear array scans and splice overhead.
|
|
4
|
+
*/
|
|
5
|
+
class MinBinaryHeap {
|
|
6
|
+
keys = [];
|
|
7
|
+
fScores = [];
|
|
8
|
+
size = 0;
|
|
9
|
+
push(key, fScore) {
|
|
10
|
+
let index = this.size++;
|
|
11
|
+
this.keys[index] = key;
|
|
12
|
+
this.fScores[index] = fScore;
|
|
13
|
+
// Bubble up
|
|
14
|
+
while (index > 0) {
|
|
15
|
+
const parentIndex = (index - 1) >> 1;
|
|
16
|
+
if (this.fScores[index] < this.fScores[parentIndex]) {
|
|
17
|
+
this.swap(index, parentIndex);
|
|
18
|
+
index = parentIndex;
|
|
19
|
+
}
|
|
20
|
+
else {
|
|
21
|
+
break;
|
|
22
|
+
}
|
|
23
|
+
}
|
|
24
|
+
}
|
|
25
|
+
pop() {
|
|
26
|
+
if (this.size === 0)
|
|
27
|
+
return undefined;
|
|
28
|
+
const minKey = this.keys[0];
|
|
29
|
+
const lastIndex = --this.size;
|
|
30
|
+
this.keys[0] = this.keys[lastIndex];
|
|
31
|
+
this.fScores[0] = this.fScores[lastIndex];
|
|
32
|
+
// Sink down
|
|
33
|
+
let index = 0;
|
|
34
|
+
const half = this.size >> 1;
|
|
35
|
+
while (index < half) {
|
|
36
|
+
const leftChild = (index << 1) + 1;
|
|
37
|
+
const rightChild = leftChild + 1;
|
|
38
|
+
let bestChild = leftChild;
|
|
39
|
+
if (rightChild < this.size &&
|
|
40
|
+
this.fScores[rightChild] < this.fScores[leftChild]) {
|
|
41
|
+
bestChild = rightChild;
|
|
42
|
+
}
|
|
43
|
+
if (this.fScores[bestChild] < this.fScores[index]) {
|
|
44
|
+
this.swap(index, bestChild);
|
|
45
|
+
index = bestChild;
|
|
46
|
+
}
|
|
47
|
+
else {
|
|
48
|
+
break;
|
|
49
|
+
}
|
|
50
|
+
}
|
|
51
|
+
return minKey;
|
|
52
|
+
}
|
|
53
|
+
get length() {
|
|
54
|
+
return this.size;
|
|
55
|
+
}
|
|
56
|
+
swap(i, j) {
|
|
57
|
+
const tempKey = this.keys[i];
|
|
58
|
+
this.keys[i] = this.keys[j];
|
|
59
|
+
this.keys[j] = tempKey;
|
|
60
|
+
const tempScore = this.fScores[i];
|
|
61
|
+
this.fScores[i] = this.fScores[j];
|
|
62
|
+
this.fScores[j] = tempScore;
|
|
63
|
+
}
|
|
64
|
+
}
|
|
65
|
+
/**
|
|
66
|
+
* High-performance 3D A* pathfinder and path simplifier.
|
|
67
|
+
*/
|
|
68
|
+
export class AStarPathfinder {
|
|
69
|
+
/**
|
|
70
|
+
* 6 orthogonal 3D search directions.
|
|
71
|
+
*/
|
|
72
|
+
static DIRECTION_DELTAS = [
|
|
73
|
+
{ dx: 1, dy: 0, dz: 0 },
|
|
74
|
+
{ dx: -1, dy: 0, dz: 0 },
|
|
75
|
+
{ dx: 0, dy: 1, dz: 0 },
|
|
76
|
+
{ dx: 0, dy: -1, dz: 0 },
|
|
77
|
+
{ dx: 0, dy: 0, dz: 1 },
|
|
78
|
+
{ dx: 0, dy: 0, dz: -1 },
|
|
79
|
+
];
|
|
80
|
+
/**
|
|
81
|
+
* Packs 3D grid coordinates into a 64-bit BigInt key to avoid string allocations.
|
|
82
|
+
* Coordinates between -1,000,000 and +1,000,000 are supported (21 bits per axis).
|
|
83
|
+
*/
|
|
84
|
+
static toGridKey(gridX, gridY, gridZ) {
|
|
85
|
+
const uX = BigInt((gridX + 1000000) & 0x1fffff);
|
|
86
|
+
const uY = BigInt((gridY + 1000000) & 0x1fffff);
|
|
87
|
+
const uZ = BigInt((gridZ + 1000000) & 0x1fffff);
|
|
88
|
+
return (uX << 42n) | (uY << 21n) | uZ;
|
|
89
|
+
}
|
|
90
|
+
/**
|
|
91
|
+
* Unpacks a 64-bit BigInt key back into 3D grid coordinates.
|
|
92
|
+
*/
|
|
93
|
+
static fromGridKey(key) {
|
|
94
|
+
const gridZ = Number(key & 0x1fffffn) - 1000000;
|
|
95
|
+
const gridY = Number((key >> 21n) & 0x1fffffn) - 1000000;
|
|
96
|
+
const gridX = Number((key >> 42n) & 0x1fffffn) - 1000000;
|
|
97
|
+
return { gridX, gridY, gridZ };
|
|
98
|
+
}
|
|
99
|
+
/**
|
|
100
|
+
* Manhattan distance heuristic on 3D grid coordinates.
|
|
101
|
+
*/
|
|
102
|
+
static getManhattanDistance(fromX, fromY, fromZ, toX, toY, toZ) {
|
|
103
|
+
return Math.abs(fromX - toX) + Math.abs(fromY - toY) + Math.abs(fromZ - toZ);
|
|
104
|
+
}
|
|
105
|
+
/**
|
|
106
|
+
* Simplifies a 3D path by removing collinear intermediate waypoints.
|
|
107
|
+
*/
|
|
108
|
+
static simplifyPath(path) {
|
|
109
|
+
if (path.length <= 2)
|
|
110
|
+
return path;
|
|
111
|
+
const simplified = [path[0]];
|
|
112
|
+
for (let i = 1; i < path.length - 1; i++) {
|
|
113
|
+
const prev = simplified[simplified.length - 1];
|
|
114
|
+
const curr = path[i];
|
|
115
|
+
const next = path[i + 1];
|
|
116
|
+
if (Math.sign(curr.x - prev.x) !== Math.sign(next.x - curr.x) ||
|
|
117
|
+
Math.sign(curr.y - prev.y) !== Math.sign(next.y - curr.y) ||
|
|
118
|
+
Math.sign(curr.z - prev.z) !== Math.sign(next.z - curr.z)) {
|
|
119
|
+
simplified.push(curr);
|
|
120
|
+
}
|
|
121
|
+
}
|
|
122
|
+
simplified.push(path[path.length - 1]);
|
|
123
|
+
return simplified;
|
|
124
|
+
}
|
|
125
|
+
/**
|
|
126
|
+
* Finds a 3D path between two points within a grid-compatible space using A*.
|
|
127
|
+
*/
|
|
128
|
+
static findPath(grid, start, goal, maxNodes = 1500, simplify = true) {
|
|
129
|
+
const resolution = grid.resolution;
|
|
130
|
+
const startGridX = Math.floor(start.x / resolution);
|
|
131
|
+
const startGridY = Math.floor(start.y / resolution);
|
|
132
|
+
const startGridZ = Math.floor(start.z / resolution);
|
|
133
|
+
const goalGridX = Math.floor(goal.x / resolution);
|
|
134
|
+
const goalGridY = Math.floor(goal.y / resolution);
|
|
135
|
+
const goalGridZ = Math.floor(goal.z / resolution);
|
|
136
|
+
// Early out: goal must exist in the grid
|
|
137
|
+
if (!grid.has(goalGridX * resolution, goalGridY * resolution, goalGridZ * resolution)) {
|
|
138
|
+
return undefined;
|
|
139
|
+
}
|
|
140
|
+
// Trivial case: start is already at the goal
|
|
141
|
+
if (startGridX === goalGridX &&
|
|
142
|
+
startGridY === goalGridY &&
|
|
143
|
+
startGridZ === goalGridZ) {
|
|
144
|
+
return [{ x: goal.x, y: goal.y, z: goal.z }];
|
|
145
|
+
}
|
|
146
|
+
const startKey = this.toGridKey(startGridX, startGridY, startGridZ);
|
|
147
|
+
const goalKey = this.toGridKey(goalGridX, goalGridY, goalGridZ);
|
|
148
|
+
const openHeap = new MinBinaryHeap();
|
|
149
|
+
const gScores = new Map();
|
|
150
|
+
const cameFrom = new Map();
|
|
151
|
+
const closedSet = new Set();
|
|
152
|
+
gScores.set(startKey, 0);
|
|
153
|
+
const initialH = this.getManhattanDistance(startGridX, startGridY, startGridZ, goalGridX, goalGridY, goalGridZ);
|
|
154
|
+
openHeap.push(startKey, initialH);
|
|
155
|
+
let expandedCount = 0;
|
|
156
|
+
const halfResolutionOffset = Math.floor(resolution / 2);
|
|
157
|
+
while (openHeap.length > 0) {
|
|
158
|
+
if (expandedCount++ > maxNodes) {
|
|
159
|
+
return undefined;
|
|
160
|
+
}
|
|
161
|
+
const currentKey = openHeap.pop();
|
|
162
|
+
if (closedSet.has(currentKey)) {
|
|
163
|
+
continue;
|
|
164
|
+
}
|
|
165
|
+
closedSet.add(currentKey);
|
|
166
|
+
// Goal reached: reconstruct path
|
|
167
|
+
if (currentKey === goalKey) {
|
|
168
|
+
const path = [];
|
|
169
|
+
let traceKey = goalKey;
|
|
170
|
+
while (traceKey !== undefined) {
|
|
171
|
+
const { gridX, gridY, gridZ } = this.fromGridKey(traceKey);
|
|
172
|
+
path.push({
|
|
173
|
+
x: gridX * resolution + halfResolutionOffset,
|
|
174
|
+
y: gridY * resolution,
|
|
175
|
+
z: gridZ * resolution + halfResolutionOffset,
|
|
176
|
+
});
|
|
177
|
+
traceKey = cameFrom.get(traceKey);
|
|
178
|
+
}
|
|
179
|
+
path.reverse();
|
|
180
|
+
return simplify ? this.simplifyPath(path) : path;
|
|
181
|
+
}
|
|
182
|
+
const { gridX: currentX, gridY: currentY, gridZ: currentZ, } = this.fromGridKey(currentKey);
|
|
183
|
+
const currentG = gScores.get(currentKey);
|
|
184
|
+
// Expand 6 adjacent neighbors
|
|
185
|
+
for (let i = 0; i < 6; i++) {
|
|
186
|
+
const dir = this.DIRECTION_DELTAS[i];
|
|
187
|
+
const nextX = currentX + dir.dx;
|
|
188
|
+
const nextY = currentY + dir.dy;
|
|
189
|
+
const nextZ = currentZ + dir.dz;
|
|
190
|
+
const neighborKey = this.toGridKey(nextX, nextY, nextZ);
|
|
191
|
+
if (closedSet.has(neighborKey))
|
|
192
|
+
continue;
|
|
193
|
+
// Check grid occupancy
|
|
194
|
+
if (!grid.has(nextX * resolution, nextY * resolution, nextZ * resolution)) {
|
|
195
|
+
continue;
|
|
196
|
+
}
|
|
197
|
+
const tentativeG = currentG + 1;
|
|
198
|
+
const existingG = gScores.get(neighborKey);
|
|
199
|
+
if (existingG !== undefined && existingG <= tentativeG) {
|
|
200
|
+
continue;
|
|
201
|
+
}
|
|
202
|
+
gScores.set(neighborKey, tentativeG);
|
|
203
|
+
cameFrom.set(neighborKey, currentKey);
|
|
204
|
+
const h = this.getManhattanDistance(nextX, nextY, nextZ, goalGridX, goalGridY, goalGridZ);
|
|
205
|
+
openHeap.push(neighborKey, tentativeG + h);
|
|
206
|
+
}
|
|
207
|
+
}
|
|
208
|
+
return undefined;
|
|
209
|
+
}
|
|
210
|
+
}
|
|
211
|
+
//# sourceMappingURL=Pathfinder.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"Pathfinder.js","sourceRoot":"","sources":["../../src/spatial/Pathfinder.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1,64 @@
|
|
|
1
|
+
import { Vector3 } from "@minecraft/server";
|
|
2
|
+
import { PathfindingGrid } from "./Pathfinder";
|
|
3
|
+
/**
|
|
4
|
+
* Sparse 3D occupancy grid grouped into 16x16x16 chunks.
|
|
5
|
+
* Uses 1-bit-per-voxel bitmasks: each chunk takes only 512 bytes (64x less RAM than Float64Array).
|
|
6
|
+
*/
|
|
7
|
+
export declare class VolumeScanResult implements PathfindingGrid {
|
|
8
|
+
readonly resolution: number;
|
|
9
|
+
private static readonly CHUNK_SIZE;
|
|
10
|
+
private static readonly CHUNK_MASK;
|
|
11
|
+
private static readonly CHUNK_SHIFT;
|
|
12
|
+
private static readonly BITMASK_WORDS;
|
|
13
|
+
private readonly chunkMap;
|
|
14
|
+
private readonly chunkList;
|
|
15
|
+
private lastKey;
|
|
16
|
+
private lastChunk;
|
|
17
|
+
constructor(resolution?: number);
|
|
18
|
+
/**
|
|
19
|
+
* Converts world coordinate to discrete grid coordinate.
|
|
20
|
+
*/
|
|
21
|
+
private toGridCoordinate;
|
|
22
|
+
/**
|
|
23
|
+
* Packs 3D chunk coordinates into a unique 64-bit integer key.
|
|
24
|
+
* Supports coordinates between -1,000,000 and +1,000,000.
|
|
25
|
+
*/
|
|
26
|
+
private static toChunkKey;
|
|
27
|
+
/**
|
|
28
|
+
* Computes the 1D voxel index inside a 16x16x16 chunk: (localZ * 256) + (localY * 16) + localX.
|
|
29
|
+
*/
|
|
30
|
+
private static toVoxelIndex;
|
|
31
|
+
/**
|
|
32
|
+
* Retrieves an existing chunk or creates a new one lazily.
|
|
33
|
+
*/
|
|
34
|
+
private getOrCreateChunk;
|
|
35
|
+
/**
|
|
36
|
+
* Retrieves a chunk if it exists (returns undefined without allocating).
|
|
37
|
+
*/
|
|
38
|
+
private getChunk;
|
|
39
|
+
/**
|
|
40
|
+
* Marks the voxel at the given world coordinate as occupied.
|
|
41
|
+
*/
|
|
42
|
+
set(worldX: number, worldY: number, worldZ: number, metadata?: number): void;
|
|
43
|
+
/**
|
|
44
|
+
* Reads voxel occupancy: returns 1 if occupied, undefined otherwise.
|
|
45
|
+
*/
|
|
46
|
+
get(worldX: number, worldY: number, worldZ: number): number | undefined;
|
|
47
|
+
/**
|
|
48
|
+
* Fast presence check: returns true if the coordinate is occupied.
|
|
49
|
+
*/
|
|
50
|
+
has(worldX: number, worldY: number, worldZ: number): boolean;
|
|
51
|
+
/**
|
|
52
|
+
* Clears all stored chunk data.
|
|
53
|
+
*/
|
|
54
|
+
clear(): void;
|
|
55
|
+
/**
|
|
56
|
+
* Picks a random occupied position with optional radius and predicate filter.
|
|
57
|
+
*/
|
|
58
|
+
getRandomPosition(center?: Vector3, minRadius?: number, maxRadius?: number, filter?: (pos: Vector3, meta: number) => boolean): Vector3 | undefined;
|
|
59
|
+
/**
|
|
60
|
+
* Finds a 3D path through the scanned volume using A*.
|
|
61
|
+
*/
|
|
62
|
+
findPath(start: Vector3, goal: Vector3, maxNodes?: number, simplify?: boolean): Vector3[] | undefined;
|
|
63
|
+
}
|
|
64
|
+
//# sourceMappingURL=VolumeScanResult.d.ts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"VolumeScanResult.d.ts","sourceRoot":"","sources":["../../src/spatial/VolumeScanResult.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,EAAmB,eAAe,EAAE,MAAM,cAAc,CAAC;AAahE;;;GAGG;AACH,qBAAa,gBAAiB,YAAW,eAAe;aAgB3B,UAAU,EAAE,MAAM;IAf9C,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAM;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAO;IACzC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAK;IACxC,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAO;IAG5C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAiC;IAG1D,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAoB;IAG9C,OAAO,CAAC,OAAO,CAAe;IAC9B,OAAO,CAAC,SAAS,CAAqC;IAEtD,YAA4B,UAAU,GAAE,MAAU,EAAI;IAEtD;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAIxB;;;OAGG;IACH,OAAO,CAAC,MAAM,CAAC,UAAU;IAOzB;;OAEG;IACH,OAAO,CAAC,MAAM,CAAC,YAAY;IAQ3B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAwBxB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAmBhB;;OAEG;IACI,GAAG,CACT,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,QAAQ,GAAE,MAAU,GAClB,IAAI,CAkBN;IAED;;OAEG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAqB7E;IAED;;OAEG;IACI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAkBlE;IAED;;OAEG;IACI,KAAK,IAAI,IAAI,CAKnB;IAED;;OAEG;IACI,iBAAiB,CACvB,MAAM,CAAC,EAAE,OAAO,EAChB,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,KAAK,OAAO,GAC9C,OAAO,GAAG,SAAS,CA+DrB;IAED;;OAEG;IACI,QAAQ,CACd,KAAK,EAAE,OAAO,EACd,IAAI,EAAE,OAAO,EACb,QAAQ,GAAE,MAAa,EACvB,QAAQ,GAAE,OAAc,GACtB,OAAO,EAAE,GAAG,SAAS,CAEvB;CACD"}
|
|
@@ -0,0 +1,204 @@
|
|
|
1
|
+
import { AStarPathfinder } from "./Pathfinder";
|
|
2
|
+
/**
|
|
3
|
+
* Sparse 3D occupancy grid grouped into 16x16x16 chunks.
|
|
4
|
+
* Uses 1-bit-per-voxel bitmasks: each chunk takes only 512 bytes (64x less RAM than Float64Array).
|
|
5
|
+
*/
|
|
6
|
+
export class VolumeScanResult {
|
|
7
|
+
resolution;
|
|
8
|
+
static CHUNK_SIZE = 16;
|
|
9
|
+
static CHUNK_MASK = 0xf;
|
|
10
|
+
static CHUNK_SHIFT = 4;
|
|
11
|
+
static BITMASK_WORDS = 128; // 4096 / 32
|
|
12
|
+
// Fast 64-bit integer hash map to avoid string key allocations
|
|
13
|
+
chunkMap = new Map();
|
|
14
|
+
// Direct array of active chunks for O(1) random selection
|
|
15
|
+
chunkList = [];
|
|
16
|
+
// 1-element MRU spatial locality cache
|
|
17
|
+
lastKey = -1n;
|
|
18
|
+
lastChunk = undefined;
|
|
19
|
+
constructor(resolution = 1) {
|
|
20
|
+
this.resolution = resolution;
|
|
21
|
+
}
|
|
22
|
+
/**
|
|
23
|
+
* Converts world coordinate to discrete grid coordinate.
|
|
24
|
+
*/
|
|
25
|
+
toGridCoordinate(worldCoord) {
|
|
26
|
+
return Math.floor(worldCoord / this.resolution);
|
|
27
|
+
}
|
|
28
|
+
/**
|
|
29
|
+
* Packs 3D chunk coordinates into a unique 64-bit integer key.
|
|
30
|
+
* Supports coordinates between -1,000,000 and +1,000,000.
|
|
31
|
+
*/
|
|
32
|
+
static toChunkKey(chunkX, chunkY, chunkZ) {
|
|
33
|
+
const uX = BigInt((chunkX + 1000000) & 0x1fffff);
|
|
34
|
+
const uY = BigInt((chunkY + 1000000) & 0x1fffff);
|
|
35
|
+
const uZ = BigInt((chunkZ + 1000000) & 0x1fffff);
|
|
36
|
+
return (uX << 42n) | (uY << 21n) | uZ;
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* Computes the 1D voxel index inside a 16x16x16 chunk: (localZ * 256) + (localY * 16) + localX.
|
|
40
|
+
*/
|
|
41
|
+
static toVoxelIndex(localX, localY, localZ) {
|
|
42
|
+
return (localZ << 8) | (localY << 4) | localX;
|
|
43
|
+
}
|
|
44
|
+
/**
|
|
45
|
+
* Retrieves an existing chunk or creates a new one lazily.
|
|
46
|
+
*/
|
|
47
|
+
getOrCreateChunk(chunkX, chunkY, chunkZ) {
|
|
48
|
+
const key = VolumeScanResult.toChunkKey(chunkX, chunkY, chunkZ);
|
|
49
|
+
if (this.lastKey === key && this.lastChunk !== undefined) {
|
|
50
|
+
return this.lastChunk;
|
|
51
|
+
}
|
|
52
|
+
let entry = this.chunkMap.get(key);
|
|
53
|
+
if (!entry) {
|
|
54
|
+
const bits = new Uint32Array(VolumeScanResult.BITMASK_WORDS);
|
|
55
|
+
entry = { chunkX, chunkY, chunkZ, bits };
|
|
56
|
+
this.chunkMap.set(key, entry);
|
|
57
|
+
this.chunkList.push(entry);
|
|
58
|
+
}
|
|
59
|
+
this.lastKey = key;
|
|
60
|
+
this.lastChunk = entry;
|
|
61
|
+
return entry;
|
|
62
|
+
}
|
|
63
|
+
/**
|
|
64
|
+
* Retrieves a chunk if it exists (returns undefined without allocating).
|
|
65
|
+
*/
|
|
66
|
+
getChunk(chunkX, chunkY, chunkZ) {
|
|
67
|
+
const key = VolumeScanResult.toChunkKey(chunkX, chunkY, chunkZ);
|
|
68
|
+
if (this.lastKey === key && this.lastChunk !== undefined) {
|
|
69
|
+
return this.lastChunk;
|
|
70
|
+
}
|
|
71
|
+
const entry = this.chunkMap.get(key);
|
|
72
|
+
if (entry) {
|
|
73
|
+
this.lastKey = key;
|
|
74
|
+
this.lastChunk = entry;
|
|
75
|
+
}
|
|
76
|
+
return entry;
|
|
77
|
+
}
|
|
78
|
+
/**
|
|
79
|
+
* Marks the voxel at the given world coordinate as occupied.
|
|
80
|
+
*/
|
|
81
|
+
set(worldX, worldY, worldZ, metadata = 1) {
|
|
82
|
+
const gridX = this.toGridCoordinate(worldX);
|
|
83
|
+
const gridY = this.toGridCoordinate(worldY);
|
|
84
|
+
const gridZ = this.toGridCoordinate(worldZ);
|
|
85
|
+
const chunkX = gridX >> VolumeScanResult.CHUNK_SHIFT;
|
|
86
|
+
const chunkY = gridY >> VolumeScanResult.CHUNK_SHIFT;
|
|
87
|
+
const chunkZ = gridZ >> VolumeScanResult.CHUNK_SHIFT;
|
|
88
|
+
const chunk = this.getOrCreateChunk(chunkX, chunkY, chunkZ);
|
|
89
|
+
const localX = gridX & VolumeScanResult.CHUNK_MASK;
|
|
90
|
+
const localY = gridY & VolumeScanResult.CHUNK_MASK;
|
|
91
|
+
const localZ = gridZ & VolumeScanResult.CHUNK_MASK;
|
|
92
|
+
const voxelIndex = VolumeScanResult.toVoxelIndex(localX, localY, localZ);
|
|
93
|
+
// Bitmask set: word = voxelIndex / 32 (>> 5), bit = voxelIndex % 32 (& 31)
|
|
94
|
+
chunk.bits[voxelIndex >> 5] |= 1 << (voxelIndex & 31);
|
|
95
|
+
}
|
|
96
|
+
/**
|
|
97
|
+
* Reads voxel occupancy: returns 1 if occupied, undefined otherwise.
|
|
98
|
+
*/
|
|
99
|
+
get(worldX, worldY, worldZ) {
|
|
100
|
+
const gridX = this.toGridCoordinate(worldX);
|
|
101
|
+
const gridY = this.toGridCoordinate(worldY);
|
|
102
|
+
const gridZ = this.toGridCoordinate(worldZ);
|
|
103
|
+
const chunkX = gridX >> VolumeScanResult.CHUNK_SHIFT;
|
|
104
|
+
const chunkY = gridY >> VolumeScanResult.CHUNK_SHIFT;
|
|
105
|
+
const chunkZ = gridZ >> VolumeScanResult.CHUNK_SHIFT;
|
|
106
|
+
const chunk = this.getChunk(chunkX, chunkY, chunkZ);
|
|
107
|
+
if (!chunk)
|
|
108
|
+
return undefined;
|
|
109
|
+
const localX = gridX & VolumeScanResult.CHUNK_MASK;
|
|
110
|
+
const localY = gridY & VolumeScanResult.CHUNK_MASK;
|
|
111
|
+
const localZ = gridZ & VolumeScanResult.CHUNK_MASK;
|
|
112
|
+
const voxelIndex = VolumeScanResult.toVoxelIndex(localX, localY, localZ);
|
|
113
|
+
// Bitmask test: check if the bit is 1
|
|
114
|
+
const isOccupied = (chunk.bits[voxelIndex >> 5] & (1 << (voxelIndex & 31))) !== 0;
|
|
115
|
+
return isOccupied ? 1 : undefined;
|
|
116
|
+
}
|
|
117
|
+
/**
|
|
118
|
+
* Fast presence check: returns true if the coordinate is occupied.
|
|
119
|
+
*/
|
|
120
|
+
has(worldX, worldY, worldZ) {
|
|
121
|
+
const gridX = this.toGridCoordinate(worldX);
|
|
122
|
+
const gridY = this.toGridCoordinate(worldY);
|
|
123
|
+
const gridZ = this.toGridCoordinate(worldZ);
|
|
124
|
+
const chunkX = gridX >> VolumeScanResult.CHUNK_SHIFT;
|
|
125
|
+
const chunkY = gridY >> VolumeScanResult.CHUNK_SHIFT;
|
|
126
|
+
const chunkZ = gridZ >> VolumeScanResult.CHUNK_SHIFT;
|
|
127
|
+
const chunk = this.getChunk(chunkX, chunkY, chunkZ);
|
|
128
|
+
if (!chunk)
|
|
129
|
+
return false;
|
|
130
|
+
const localX = gridX & VolumeScanResult.CHUNK_MASK;
|
|
131
|
+
const localY = gridY & VolumeScanResult.CHUNK_MASK;
|
|
132
|
+
const localZ = gridZ & VolumeScanResult.CHUNK_MASK;
|
|
133
|
+
const voxelIndex = VolumeScanResult.toVoxelIndex(localX, localY, localZ);
|
|
134
|
+
return (chunk.bits[voxelIndex >> 5] & (1 << (voxelIndex & 31))) !== 0;
|
|
135
|
+
}
|
|
136
|
+
/**
|
|
137
|
+
* Clears all stored chunk data.
|
|
138
|
+
*/
|
|
139
|
+
clear() {
|
|
140
|
+
this.chunkMap.clear();
|
|
141
|
+
this.chunkList.length = 0;
|
|
142
|
+
this.lastKey = -1n;
|
|
143
|
+
this.lastChunk = undefined;
|
|
144
|
+
}
|
|
145
|
+
/**
|
|
146
|
+
* Picks a random occupied position with optional radius and predicate filter.
|
|
147
|
+
*/
|
|
148
|
+
getRandomPosition(center, minRadius, maxRadius, filter) {
|
|
149
|
+
const totalChunks = this.chunkList.length;
|
|
150
|
+
if (totalChunks === 0)
|
|
151
|
+
return undefined;
|
|
152
|
+
const maxRadiusSq = maxRadius ? maxRadius * maxRadius : Infinity;
|
|
153
|
+
const minRadiusSq = minRadius ? minRadius * minRadius : 0;
|
|
154
|
+
const halfResolutionOffset = Math.floor(this.resolution / 2);
|
|
155
|
+
for (let attempt = 0; attempt < 50; attempt++) {
|
|
156
|
+
const randomChunkIndex = (Math.random() * totalChunks) | 0;
|
|
157
|
+
const chunk = this.chunkList[randomChunkIndex];
|
|
158
|
+
const baseWorldX = chunk.chunkX << VolumeScanResult.CHUNK_SHIFT;
|
|
159
|
+
const baseWorldY = chunk.chunkY << VolumeScanResult.CHUNK_SHIFT;
|
|
160
|
+
const baseWorldZ = chunk.chunkZ << VolumeScanResult.CHUNK_SHIFT;
|
|
161
|
+
for (let sample = 0; sample < 10; sample++) {
|
|
162
|
+
const localX = (Math.random() * VolumeScanResult.CHUNK_SIZE) | 0;
|
|
163
|
+
const localY = (Math.random() * VolumeScanResult.CHUNK_SIZE) | 0;
|
|
164
|
+
const localZ = (Math.random() * VolumeScanResult.CHUNK_SIZE) | 0;
|
|
165
|
+
const voxelIndex = VolumeScanResult.toVoxelIndex(localX, localY, localZ);
|
|
166
|
+
const isOccupied = (chunk.bits[voxelIndex >> 5] & (1 << (voxelIndex & 31))) !== 0;
|
|
167
|
+
if (isOccupied) {
|
|
168
|
+
const voxelGridX = baseWorldX + localX;
|
|
169
|
+
const voxelGridY = baseWorldY + localY;
|
|
170
|
+
const voxelGridZ = baseWorldZ + localZ;
|
|
171
|
+
const worldX = voxelGridX * this.resolution + halfResolutionOffset;
|
|
172
|
+
const worldY = voxelGridY * this.resolution;
|
|
173
|
+
const worldZ = voxelGridZ * this.resolution + halfResolutionOffset;
|
|
174
|
+
if (center) {
|
|
175
|
+
const deltaX = worldX - center.x;
|
|
176
|
+
const deltaY = worldY - center.y;
|
|
177
|
+
const deltaZ = worldZ - center.z;
|
|
178
|
+
const distanceSq = deltaX * deltaX + deltaY * deltaY + deltaZ * deltaZ;
|
|
179
|
+
if (distanceSq > maxRadiusSq || distanceSq < minRadiusSq) {
|
|
180
|
+
continue;
|
|
181
|
+
}
|
|
182
|
+
}
|
|
183
|
+
const sampledPosition = {
|
|
184
|
+
x: worldX,
|
|
185
|
+
y: worldY,
|
|
186
|
+
z: worldZ,
|
|
187
|
+
};
|
|
188
|
+
if (filter && !filter(sampledPosition, 1)) {
|
|
189
|
+
continue;
|
|
190
|
+
}
|
|
191
|
+
return sampledPosition;
|
|
192
|
+
}
|
|
193
|
+
}
|
|
194
|
+
}
|
|
195
|
+
return undefined;
|
|
196
|
+
}
|
|
197
|
+
/**
|
|
198
|
+
* Finds a 3D path through the scanned volume using A*.
|
|
199
|
+
*/
|
|
200
|
+
findPath(start, goal, maxNodes = 1500, simplify = true) {
|
|
201
|
+
return AStarPathfinder.findPath(this, start, goal, maxNodes, simplify);
|
|
202
|
+
}
|
|
203
|
+
}
|
|
204
|
+
//# sourceMappingURL=VolumeScanResult.js.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"VolumeScanResult.js","sourceRoot":"","sources":["../../src/spatial/VolumeScanResult.ts"],"names":[],"mappings":"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"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/spatial/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/spatial/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,cAAc,CAAC"}
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@starktma/minecraft-utils",
|
|
3
|
-
"version": "1.5.
|
|
3
|
+
"version": "1.5.46",
|
|
4
4
|
"description": "",
|
|
5
5
|
"main": "dist/index.js",
|
|
6
6
|
"types": "dist/index.d.ts",
|
|
@@ -40,6 +40,10 @@
|
|
|
40
40
|
"./game-state-machine": {
|
|
41
41
|
"import": "./dist/game-state-machine/index.js",
|
|
42
42
|
"types": "./dist/game-state-machine/index.d.ts"
|
|
43
|
+
},
|
|
44
|
+
"./spatial": {
|
|
45
|
+
"import": "./dist/spatial/index.js",
|
|
46
|
+
"types": "./dist/spatial/index.d.ts"
|
|
43
47
|
}
|
|
44
48
|
},
|
|
45
49
|
"publishConfig": {
|