specprotocol 1.0.0

package/dist/utils/logger.js

@@ -0,0 +1,47 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = exports.LogLevel = void 0;
+var LogLevel;
+(function (LogLevel) {
+    LogLevel[LogLevel["DEBUG"] = 0] = "DEBUG";
+    LogLevel[LogLevel["INFO"] = 1] = "INFO";
+    LogLevel[LogLevel["WARN"] = 2] = "WARN";
+    LogLevel[LogLevel["ERROR"] = 3] = "ERROR";
+    LogLevel[LogLevel["NONE"] = 4] = "NONE";
+})(LogLevel || (exports.LogLevel = LogLevel = {}));
+class Logger {
+    level;
+    prefix;
+    constructor(prefix, level = LogLevel.INFO) {
+        this.prefix = prefix;
+        this.level = level;
+    }
+    setLevel(level) {
+        this.level = level;
+    }
+    debug(message, ...args) {
+        if (this.level <= LogLevel.DEBUG) {
+            console.debug(`[${this.timestamp()}] [DEBUG] [${this.prefix}]`, message, ...args);
+        }
+    }
+    info(message, ...args) {
+        if (this.level <= LogLevel.INFO) {
+            console.info(`[${this.timestamp()}] [INFO] [${this.prefix}]`, message, ...args);
+        }
+    }
+    warn(message, ...args) {
+        if (this.level <= LogLevel.WARN) {
+            console.warn(`[${this.timestamp()}] [WARN] [${this.prefix}]`, message, ...args);
+        }
+    }
+    error(message, ...args) {
+        if (this.level <= LogLevel.ERROR) {
+            console.error(`[${this.timestamp()}] [ERROR] [${this.prefix}]`, message, ...args);
+        }
+    }
+    timestamp() {
+        return new Date().toISOString();
+    }
+}
+exports.Logger = Logger;
+//# sourceMappingURL=logger.js.map

package/dist/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":";;;AAAA,IAAY,QAMX;AAND,WAAY,QAAQ;IAChB,yCAAS,CAAA;IACT,uCAAQ,CAAA;IACR,uCAAQ,CAAA;IACR,yCAAS,CAAA;IACT,uCAAQ,CAAA;AACZ,CAAC,EANW,QAAQ,wBAAR,QAAQ,QAMnB;AAED,MAAa,MAAM;IACP,KAAK,CAAW;IAChB,MAAM,CAAS;IAEvB,YAAY,MAAc,EAAE,QAAkB,QAAQ,CAAC,IAAI;QACvD,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,QAAQ,CAAC,KAAe;QACpB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACrC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,cAAc,IAAI,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACtF,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,aAAa,IAAI,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACpF,CAAC;IACL,CAAC;IAED,IAAI,CAAC,OAAe,EAAE,GAAG,IAAe;QACpC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,IAAI,EAAE,CAAC;YAC9B,OAAO,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,aAAa,IAAI,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACpF,CAAC;IACL,CAAC;IAED,KAAK,CAAC,OAAe,EAAE,GAAG,IAAe;QACrC,IAAI,IAAI,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;YAC/B,OAAO,CAAC,KAAK,CAAC,IAAI,IAAI,CAAC,SAAS,EAAE,cAAc,IAAI,CAAC,MAAM,GAAG,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,CAAC;QACtF,CAAC;IACL,CAAC;IAEO,SAAS;QACb,OAAO,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IACpC,CAAC;CACJ;AAxCD,wBAwCC"}

package/dist/utils/vec3.d.ts

@@ -0,0 +1,25 @@
+/**
+ * 3D Vector class for Minecraft coordinates.
+ */
+export declare class Vec3 {
+    x: number;
+    y: number;
+    z: number;
+    constructor(x: number, y: number, z: number);
+    add(other: Vec3): Vec3;
+    subtract(other: Vec3): Vec3;
+    scale(scalar: number): Vec3;
+    length(): number;
+    distanceTo(other: Vec3): number;
+    normalize(): Vec3;
+    dot(other: Vec3): number;
+    cross(other: Vec3): Vec3;
+    floor(): Vec3;
+    equals(other: Vec3): boolean;
+    clone(): Vec3;
+    toString(): string;
+    toArray(): [number, number, number];
+    static from(arr: [number, number, number]): Vec3;
+    static zero(): Vec3;
+}
+//# sourceMappingURL=vec3.d.ts.map

package/dist/utils/vec3.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vec3.d.ts","sourceRoot":"","sources":["../../src/utils/vec3.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,IAAI;IAEF,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;gBAFT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM;IAGpB,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAItB,QAAQ,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAI3B,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI;IAI3B,MAAM,IAAI,MAAM;IAIhB,UAAU,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAI/B,SAAS,IAAI,IAAI;IAMjB,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,MAAM;IAIxB,KAAK,CAAC,KAAK,EAAE,IAAI,GAAG,IAAI;IAQxB,KAAK,IAAI,IAAI;IAIb,MAAM,CAAC,KAAK,EAAE,IAAI,GAAG,OAAO;IAI5B,KAAK,IAAI,IAAI;IAIb,QAAQ,IAAI,MAAM;IAIlB,OAAO,IAAI,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC;IAInC,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI;IAIhD,MAAM,CAAC,IAAI,IAAI,IAAI;CAGtB"}

package/dist/utils/vec3.js

@@ -0,0 +1,66 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Vec3 = void 0;
+/**
+ * 3D Vector class for Minecraft coordinates.
+ */
+class Vec3 {
+    x;
+    y;
+    z;
+    constructor(x, y, z) {
+        this.x = x;
+        this.y = y;
+        this.z = z;
+    }
+    add(other) {
+        return new Vec3(this.x + other.x, this.y + other.y, this.z + other.z);
+    }
+    subtract(other) {
+        return new Vec3(this.x - other.x, this.y - other.y, this.z - other.z);
+    }
+    scale(scalar) {
+        return new Vec3(this.x * scalar, this.y * scalar, this.z * scalar);
+    }
+    length() {
+        return Math.sqrt(this.x * this.x + this.y * this.y + this.z * this.z);
+    }
+    distanceTo(other) {
+        return this.subtract(other).length();
+    }
+    normalize() {
+        const len = this.length();
+        if (len === 0)
+            return new Vec3(0, 0, 0);
+        return this.scale(1 / len);
+    }
+    dot(other) {
+        return this.x * other.x + this.y * other.y + this.z * other.z;
+    }
+    cross(other) {
+        return new Vec3(this.y * other.z - this.z * other.y, this.z * other.x - this.x * other.z, this.x * other.y - this.y * other.x);
+    }
+    floor() {
+        return new Vec3(Math.floor(this.x), Math.floor(this.y), Math.floor(this.z));
+    }
+    equals(other) {
+        return this.x === other.x && this.y === other.y && this.z === other.z;
+    }
+    clone() {
+        return new Vec3(this.x, this.y, this.z);
+    }
+    toString() {
+        return `Vec3(${this.x}, ${this.y}, ${this.z})`;
+    }
+    toArray() {
+        return [this.x, this.y, this.z];
+    }
+    static from(arr) {
+        return new Vec3(arr[0], arr[1], arr[2]);
+    }
+    static zero() {
+        return new Vec3(0, 0, 0);
+    }
+}
+exports.Vec3 = Vec3;
+//# sourceMappingURL=vec3.js.map

package/dist/utils/vec3.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vec3.js","sourceRoot":"","sources":["../../src/utils/vec3.ts"],"names":[],"mappings":"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"}

package/dist/world/block.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Block representation.
+ */
+export interface Block {
+    stateId: number;
+    x: number;
+    y: number;
+    z: number;
+}
+/**
+ * Section of a chunk (16x16x16 blocks).
+ * Uses a palette-based system matching Minecraft's format.
+ */
+export declare class ChunkSection {
+    private blockStates;
+    private blockCount;
+    constructor();
+    private index;
+    getBlock(x: number, y: number, z: number): number;
+    setBlock(x: number, y: number, z: number, stateId: number): void;
+    isEmpty(): boolean;
+}
+/**
+ * A Chunk Column — 16x384x16 blocks (24 sections for -64 to 319 Y range).
+ */
+export declare class ChunkColumn {
+    readonly x: number;
+    readonly z: number;
+    private sections;
+    private minY;
+    private sectionCount;
+    constructor(x: number, z: number, minY?: number, worldHeight?: number);
+    private sectionIndex;
+    getBlock(x: number, y: number, z: number): number;
+    setBlock(x: number, y: number, z: number, stateId: number): void;
+    getSection(index: number): ChunkSection | null;
+    setSection(index: number, section: ChunkSection): void;
+}
+//# sourceMappingURL=block.d.ts.map

package/dist/world/block.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.d.ts","sourceRoot":"","sources":["../../src/world/block.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,WAAW,KAAK;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,qBAAa,YAAY;IACrB,OAAO,CAAC,WAAW,CAAc;IACjC,OAAO,CAAC,UAAU,CAAa;;IAM/B,OAAO,CAAC,KAAK;IAIb,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAUhE,OAAO,IAAI,OAAO;CAGrB;AAED;;GAEG;AACH,qBAAa,WAAW;IACpB,SAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,OAAO,CAAC,QAAQ,CAA0B;IAC1C,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,YAAY,CAAS;gBAEjB,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,GAAE,MAAY,EAAE,WAAW,GAAE,MAAY;IAQ/E,OAAO,CAAC,YAAY;IAIpB,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAUjD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAYhE,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,YAAY,GAAG,IAAI;IAI9C,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,GAAG,IAAI;CAGzD"}

package/dist/world/block.js

@@ -0,0 +1,84 @@
+"use strict";
+/**
+ * Block representation.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ChunkColumn = exports.ChunkSection = void 0;
+/**
+ * Section of a chunk (16x16x16 blocks).
+ * Uses a palette-based system matching Minecraft's format.
+ */
+class ChunkSection {
+    blockStates;
+    blockCount = 0;
+    constructor() {
+        this.blockStates = new Uint16Array(16 * 16 * 16);
+    }
+    index(x, y, z) {
+        return (y << 8) | (z << 4) | x;
+    }
+    getBlock(x, y, z) {
+        return this.blockStates[this.index(x & 0xF, y & 0xF, z & 0xF)];
+    }
+    setBlock(x, y, z, stateId) {
+        const idx = this.index(x & 0xF, y & 0xF, z & 0xF);
+        const old = this.blockStates[idx];
+        if (old === 0 && stateId !== 0)
+            this.blockCount++;
+        else if (old !== 0 && stateId === 0)
+            this.blockCount--;
+        this.blockStates[idx] = stateId;
+    }
+    isEmpty() {
+        return this.blockCount === 0;
+    }
+}
+exports.ChunkSection = ChunkSection;
+/**
+ * A Chunk Column — 16x384x16 blocks (24 sections for -64 to 319 Y range).
+ */
+class ChunkColumn {
+    x;
+    z;
+    sections;
+    minY;
+    sectionCount;
+    constructor(x, z, minY = -64, worldHeight = 384) {
+        this.x = x;
+        this.z = z;
+        this.minY = minY;
+        this.sectionCount = worldHeight / 16;
+        this.sections = new Array(this.sectionCount).fill(null);
+    }
+    sectionIndex(y) {
+        return Math.floor((y - this.minY) / 16);
+    }
+    getBlock(x, y, z) {
+        const secIdx = this.sectionIndex(y);
+        if (secIdx < 0 || secIdx >= this.sectionCount)
+            return 0;
+        const section = this.sections[secIdx];
+        if (!section)
+            return 0;
+        return section.getBlock(x, y, z);
+    }
+    setBlock(x, y, z, stateId) {
+        const secIdx = this.sectionIndex(y);
+        if (secIdx < 0 || secIdx >= this.sectionCount)
+            return;
+        if (!this.sections[secIdx]) {
+            if (stateId === 0)
+                return; // No need to create section for air
+            this.sections[secIdx] = new ChunkSection();
+        }
+        this.sections[secIdx].setBlock(x, y, z, stateId);
+    }
+    getSection(index) {
+        return this.sections[index] ?? null;
+    }
+    setSection(index, section) {
+        this.sections[index] = section;
+    }
+}
+exports.ChunkColumn = ChunkColumn;
+//# sourceMappingURL=block.js.map

package/dist/world/block.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"block.js","sourceRoot":"","sources":["../../src/world/block.ts"],"names":[],"mappings":"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"}

package/dist/world/world.d.ts

@@ -0,0 +1,55 @@
+/**
+ * World Manager — tracks the entire world state.
+ *
+ * Manages chunk columns and provides block access.
+ */
+import { ChunkColumn } from './block.js';
+import { Vec3 } from '../utils/vec3.js';
+export declare class World {
+    private chunks;
+    dimension: string;
+    difficulty: number;
+    worldAge: bigint;
+    timeOfDay: bigint;
+    minY: number;
+    worldHeight: number;
+    seaLevel: number;
+    private chunkKey;
+    /**
+     * Get or create a chunk column.
+     */
+    getChunk(chunkX: number, chunkZ: number): ChunkColumn | undefined;
+    /**
+     * Set a chunk column.
+     */
+    setChunk(chunkX: number, chunkZ: number, column: ChunkColumn): void;
+    /**
+     * Remove a chunk column (when unloaded).
+     */
+    removeChunk(chunkX: number, chunkZ: number): void;
+    /**
+     * Get a block state ID at a world position.
+     */
+    getBlock(x: number, y: number, z: number): number;
+    /**
+     * Set a block state at a world position.
+     */
+    setBlock(x: number, y: number, z: number, stateId: number): void;
+    /**
+     * Get block at Vec3 position (floors coordinates).
+     */
+    getBlockAt(pos: Vec3): number;
+    /**
+     * Check if a chunk is loaded.
+     */
+    isChunkLoaded(chunkX: number, chunkZ: number): boolean;
+    /**
+     * Get number of loaded chunks.
+     */
+    get loadedChunkCount(): number;
+    /**
+     * Clear all chunks (for dimension change).
+     */
+    clear(): void;
+}
+//# sourceMappingURL=world.d.ts.map

package/dist/world/world.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/world/world.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AACzC,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AAExC,qBAAa,KAAK;IACd,OAAO,CAAC,MAAM,CAAkC;IACzC,SAAS,EAAE,MAAM,CAAyB;IAC1C,UAAU,EAAE,MAAM,CAAK;IACvB,QAAQ,EAAE,MAAM,CAAM;IACtB,SAAS,EAAE,MAAM,CAAM;IACvB,IAAI,EAAE,MAAM,CAAO;IACnB,WAAW,EAAE,MAAM,CAAO;IAC1B,QAAQ,EAAE,MAAM,CAAM;IAE7B,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS;IAIjE;;OAEG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,WAAW,GAAG,IAAI;IAInE;;OAEG;IACH,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;IAIjD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAYjD;;OAEG;IACH,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI;IAehE;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,IAAI,GAAG,MAAM;IAI7B;;OAEG;IACH,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;IAItD;;OAEG;IACH,IAAI,gBAAgB,IAAI,MAAM,CAE7B;IAED;;OAEG;IACH,KAAK,IAAI,IAAI;CAGhB"}

package/dist/world/world.js

@@ -0,0 +1,95 @@
+"use strict";
+/**
+ * World Manager — tracks the entire world state.
+ *
+ * Manages chunk columns and provides block access.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.World = void 0;
+const block_js_1 = require("./block.js");
+class World {
+    chunks = new Map();
+    dimension = 'minecraft:overworld';
+    difficulty = 0;
+    worldAge = 0n;
+    timeOfDay = 0n;
+    minY = -64;
+    worldHeight = 384;
+    seaLevel = 63;
+    chunkKey(x, z) {
+        return `${x},${z}`;
+    }
+    /**
+     * Get or create a chunk column.
+     */
+    getChunk(chunkX, chunkZ) {
+        return this.chunks.get(this.chunkKey(chunkX, chunkZ));
+    }
+    /**
+     * Set a chunk column.
+     */
+    setChunk(chunkX, chunkZ, column) {
+        this.chunks.set(this.chunkKey(chunkX, chunkZ), column);
+    }
+    /**
+     * Remove a chunk column (when unloaded).
+     */
+    removeChunk(chunkX, chunkZ) {
+        this.chunks.delete(this.chunkKey(chunkX, chunkZ));
+    }
+    /**
+     * Get a block state ID at a world position.
+     */
+    getBlock(x, y, z) {
+        const chunkX = Math.floor(x / 16);
+        const chunkZ = Math.floor(z / 16);
+        const chunk = this.chunks.get(this.chunkKey(chunkX, chunkZ));
+        if (!chunk)
+            return 0;
+        // Use local coordinates within the chunk
+        const localX = ((x % 16) + 16) % 16;
+        const localZ = ((z % 16) + 16) % 16;
+        return chunk.getBlock(localX, y, localZ);
+    }
+    /**
+     * Set a block state at a world position.
+     */
+    setBlock(x, y, z, stateId) {
+        const chunkX = Math.floor(x / 16);
+        const chunkZ = Math.floor(z / 16);
+        let chunk = this.chunks.get(this.chunkKey(chunkX, chunkZ));
+        if (!chunk) {
+            chunk = new block_js_1.ChunkColumn(chunkX, chunkZ, this.minY, this.worldHeight);
+            this.setChunk(chunkX, chunkZ, chunk);
+        }
+        const localX = ((x % 16) + 16) % 16;
+        const localZ = ((z % 16) + 16) % 16;
+        chunk.setBlock(localX, y, localZ, stateId);
+    }
+    /**
+     * Get block at Vec3 position (floors coordinates).
+     */
+    getBlockAt(pos) {
+        return this.getBlock(Math.floor(pos.x), Math.floor(pos.y), Math.floor(pos.z));
+    }
+    /**
+     * Check if a chunk is loaded.
+     */
+    isChunkLoaded(chunkX, chunkZ) {
+        return this.chunks.has(this.chunkKey(chunkX, chunkZ));
+    }
+    /**
+     * Get number of loaded chunks.
+     */
+    get loadedChunkCount() {
+        return this.chunks.size;
+    }
+    /**
+     * Clear all chunks (for dimension change).
+     */
+    clear() {
+        this.chunks.clear();
+    }
+}
+exports.World = World;
+//# sourceMappingURL=world.js.map

package/dist/world/world.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"world.js","sourceRoot":"","sources":["../../src/world/world.ts"],"names":[],"mappings":"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"}

package/docs/README.md

@@ -0,0 +1,29 @@
+# 📚 SpecProtocol Dokümantasyonu
+
+SpecProtocol, Minecraft Java Edition 1.21.4 için sıfırdan yazılmış bir bot framework'üdür.
+
+## İçindekiler
+
+### Başlangıç
+- [Kurulum & Hızlı Başlangıç](./getting-started.md)
+- [İlk Botunuzu Yazın](./first-bot.md)
+
+### Temel Kavramlar
+- [Bot API Referansı](./api/bot.md)
+- [Event (Olay) Sistemi](./api/events.md)
+- [Plugin Sistemi](./api/plugins.md)
+
+### Alt Sistemler
+- [Protokol Katmanı](./api/protocol.md)
+- [World (Dünya) Yönetimi](./api/world.md)
+- [Entity (Varlık) Yönetimi](./api/entities.md)
+- [Authentication (Kimlik Doğrulama)](./api/auth.md)
+
+### Yardımcılar
+- [Vec3 — 3D Vektör](./api/vec3.md)
+- [BufferReader & BufferWriter](./api/buffer.md)
+
+### Gelişmiş
+- [Kendi Plugin'inizi Yazın](./guides/custom-plugins.md)
+- [Raw Packet Erişimi](./guides/raw-packets.md)
+- [Mimari & Tasarım Kararları](./guides/architecture.md)