@lzimul/minecraft-mcp 1.0.2 → 1.0.4

package/build/world/world.js

@@ -1,5 +1,6 @@
 import { DIMENSIONS } from '../config/dimensions.js';
 import { toErrorMessage } from '../utils/error-message.js';
+import { logger } from '../utils/logger.js';
 import { SimulatedDimension } from './simulated-dimension.js';
 export class World {
     dimensions;
@@ -17,7 +18,16 @@ export class World {
             }
             return [dimension.type, simulated];
         }));
-        return new World(new Map(entries));
+        const dimensions = new Map(entries);
+        const claimedPlayerNames = new Set();
+        let duplicatePlayers = 0;
+        for (const dimension of dimensions.values()) {
+            duplicatePlayers += dimension.removeDuplicatePlayers(claimedPlayerNames);
+        }
+        if (duplicatePlayers > 0) {
+            logger.warn(`Removed ${duplicatePlayers} duplicate player name(s) while loading the world`);
+        }
+        return new World(dimensions);
     }
     static listDimensions() {
         return DIMENSIONS;
@@ -29,6 +39,28 @@ export class World {
         }
         return dimension;
     }
+    findEntity(id) {
+        for (const dimension of this.dimensions.values()) {
+            const entity = dimension.getEntity(id);
+            if (entity) {
+                return entity;
+            }
+        }
+        return;
+    }
+    findPlayer(name) {
+        const normalized = name.trim().toLowerCase();
+        if (normalized.length === 0) {
+            return;
+        }
+        for (const dimension of this.dimensions.values()) {
+            const player = dimension.findPlayer(normalized);
+            if (player) {
+                return player;
+            }
+        }
+        return;
+    }
     async flush() {
         const results = await Promise.allSettled([...this.dimensions.values()].map(dimension => dimension.flush()));
         const failures = results.filter((result) => result.status === 'rejected');

package/lib/config/server-info.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-info.d.ts","sourceRoot":"","sources":["../../src/config/server-info.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,eAAO,MAAM,WAAW;;;;;;;;;;;;CAoBvB,CAAC"}
+{"version":3,"file":"server-info.d.ts","sourceRoot":"","sources":["../../src/config/server-info.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC;AAEzD,eAAO,MAAM,WAAW;;;;;;;;;;;;CAoBvB,CAAC"}

package/lib/config/world-limits.d.ts

@@ -4,5 +4,8 @@ export declare const WORLD_LIMITS: {
     readonly minVertical: -64;
     readonly maxVertical: 320;
     readonly maxModifiedBlocks: 250000;
+    readonly maxEntitiesPerDimension: 10000;
+    readonly maxEntityNameLength: 64;
+    readonly maxPlayerNameLength: 32;
 };
 //# sourceMappingURL=world-limits.d.ts.map

package/lib/config/world-limits.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-limits.d.ts","sourceRoot":"","sources":["../../src/config/world-limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;CAOf,CAAC"}
+{"version":3,"file":"world-limits.d.ts","sourceRoot":"","sources":["../../src/config/world-limits.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,YAAY;;;;;;;;;CAWf,CAAC"}

package/lib/data/entities.d.ts

@@ -0,0 +1,5 @@
+import type { IEntityType } from '../interfaces/entity-type.interface.js';
+export declare const MINECRAFT_ENTITY_TYPES: readonly IEntityType[];
+export declare const MINECRAFT_ENTITY_COUNT: number;
+export declare function getEntityTypeByName(name: string): IEntityType | undefined;
+//# sourceMappingURL=entities.d.ts.map

package/lib/data/entities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entities.d.ts","sourceRoot":"","sources":["../../src/data/entities.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAE1E,eAAO,MAAM,sBAAsB,EAAE,SAAS,WAAW,EAmiDxD,CAAC;AAEF,eAAO,MAAM,sBAAsB,QAAgC,CAAC;AAQpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEzE"}

package/lib/enums/entity-kind.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum EEntityKind {
+    Entity = "entity",
+    Player = "player"
+}
+//# sourceMappingURL=entity-kind.enum.d.ts.map

package/lib/enums/entity-kind.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-kind.enum.d.ts","sourceRoot":"","sources":["../../src/enums/entity-kind.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/lib/enums/inventory-section.enum.d.ts

@@ -0,0 +1,5 @@
+export declare enum EInventorySection {
+    Hotbar = "hotbar",
+    Inventory = "inventory"
+}
+//# sourceMappingURL=inventory-section.enum.d.ts.map

package/lib/enums/inventory-section.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inventory-section.enum.d.ts","sourceRoot":"","sources":["../../src/enums/inventory-section.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB"}

package/lib/interfaces/entity-inventory.interface.d.ts

@@ -0,0 +1,9 @@
+export interface IItemStack {
+    readonly item: string;
+    readonly count: number;
+}
+export interface IEntityInventory {
+    readonly hotbar: readonly (IItemStack | null)[];
+    readonly inventory: readonly (IItemStack | null)[];
+}
+//# sourceMappingURL=entity-inventory.interface.d.ts.map

package/lib/interfaces/entity-inventory.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-inventory.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/entity-inventory.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,UAAU;IAEzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAMD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC;IAChD,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC,UAAU,GAAG,IAAI,CAAC,EAAE,CAAC;CACpD"}

package/lib/interfaces/entity-type.interface.d.ts

@@ -0,0 +1,8 @@
+import type { IDataEntry } from './data-entry.interface.js';
+export interface IEntityType extends IDataEntry {
+    readonly type: string;
+    readonly category: string;
+    readonly width: number;
+    readonly height: number;
+}
+//# sourceMappingURL=entity-type.interface.d.ts.map

package/lib/interfaces/entity-type.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-type.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/entity-type.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,WAAY,SAAQ,UAAU;IAE7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAEtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/lib/interfaces/entity.interface.d.ts

@@ -0,0 +1,17 @@
+import type { EEntityKind } from '../enums/entity-kind.enum.js';
+import type { EDimensionType } from '../enums/dimension-type.enum.js';
+import type { IEntityInventory } from './entity-inventory.interface.js';
+import type { IEntityType } from './entity-type.interface.js';
+export interface IEntity {
+    readonly id: string;
+    readonly kind: EEntityKind;
+    readonly type: IEntityType;
+    readonly name: string;
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly dimension: EDimensionType;
+    readonly inventory: IEntityInventory;
+    readonly createdAt: string;
+}
+//# sourceMappingURL=entity.interface.d.ts.map

package/lib/interfaces/entity.interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/entity.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AACxE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,MAAM,WAAW,OAAO;IACtB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAE3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,gBAAgB,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B"}

package/lib/interfaces/world-store.interface.d.ts

@@ -1,7 +1,12 @@
 import type { EDimensionType } from '../enums/dimension-type.enum.js';
+import type { IEntity } from './entity.interface.js';
 import type { IPlacedBlock } from './placed-block.interface.js';
+export interface IWorldSnapshot {
+    readonly blocks: readonly IPlacedBlock[];
+    readonly entities: readonly IEntity[];
+}
 export interface IWorldStore {
-    load(type: EDimensionType): Promise<readonly IPlacedBlock[]>;
-    save(type: EDimensionType, blocks: readonly IPlacedBlock[]): Promise<void>;
+    load(type: EDimensionType): Promise<IWorldSnapshot>;
+    save(type: EDimensionType, snapshot: IWorldSnapshot): Promise<void>;
 }
 //# sourceMappingURL=world-store.interface.d.ts.map

package/lib/interfaces/world-store.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"world-store.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/world-store.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAEhE,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC,CAAC;IAC7D,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,SAAS,YAAY,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CAC5E"}
+{"version":3,"file":"world-store.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/world-store.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAMhE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC,CAAC;IACpD,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;CACrE"}

package/lib/resources/dimension-resources.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimension-resources.d.ts","sourceRoot":"","sources":["../../src/resources/dimension-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAM9D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA2B1C,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,KAAK,GACX,IAAI,CA+BN;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,KAAK,GACX,IAAI,CA2BN"}
+{"version":3,"file":"dimension-resources.d.ts","sourceRoot":"","sources":["../../src/resources/dimension-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA+C1C,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,KAAK,GACX,IAAI,CAgCN;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,KAAK,GACX,IAAI,CA2BN"}

package/lib/resources/entity-resources.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+export declare function registerEntityResources(server: McpServer): void;
+//# sourceMappingURL=entity-resources.d.ts.map

package/lib/resources/entity-resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-resources.d.ts","sourceRoot":"","sources":["../../src/resources/entity-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAY9D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAa/D"}

package/lib/resources/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAKvE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/resources/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAU9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAMvE"}

package/lib/schemas/coordinate-schema.d.ts

@@ -1,4 +1,9 @@
 import * as z from 'zod/v4';
 export declare const horizontalCoordinate: z.ZodNumber;
 export declare const verticalCoordinate: z.ZodNumber;
+export declare const blockPositionShape: {
+    readonly x: z.ZodNumber;
+    readonly y: z.ZodNumber;
+    readonly z: z.ZodNumber;
+};
 //# sourceMappingURL=coordinate-schema.d.ts.map

package/lib/schemas/coordinate-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"coordinate-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/coordinate-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,oBAAoB,aAIC,CAAC;AAEnC,eAAO,MAAM,kBAAkB,aAIC,CAAC"}
+{"version":3,"file":"coordinate-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/coordinate-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAI5B,eAAO,MAAM,oBAAoB,aAIC,CAAC;AAEnC,eAAO,MAAM,kBAAkB,aAIC,CAAC;AAMjC,eAAO,MAAM,kBAAkB;;;;CAMrB,CAAC"}

package/lib/schemas/dimension-schema.d.ts

@@ -2,4 +2,5 @@ import * as z from 'zod/v4';
 import { EDimensionType } from '../enums/dimension-type.enum.js';
 export declare const dimensionSchema: z.ZodDefault<z.ZodEnum<typeof EDimensionType>>;
 export declare const dimensionTypeSchema: z.ZodEnum<typeof EDimensionType>;
+export declare const dimensionField: z.ZodDefault<z.ZodEnum<typeof EDimensionType>>;
 //# sourceMappingURL=dimension-schema.d.ts.map

package/lib/schemas/dimension-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimension-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/dimension-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,eAAO,MAAM,eAAe,gDAEQ,CAAC;AAErC,eAAO,MAAM,mBAAmB,kCAAyB,CAAC"}
+{"version":3,"file":"dimension-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/dimension-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,eAAO,MAAM,eAAe,gDAEQ,CAAC;AAErC,eAAO,MAAM,mBAAmB,kCAAyB,CAAC;AAE1D,eAAO,MAAM,cAAc,gDAE1B,CAAC"}

package/lib/schemas/entity-schema.d.ts

@@ -0,0 +1,134 @@
+import * as z from 'zod/v4';
+import { EEntityKind } from '../enums/entity-kind.enum.js';
+import { EInventorySection } from '../enums/inventory-section.enum.js';
+import type { IEntity } from '../interfaces/entity.interface.js';
+import type { IItemStack } from '../interfaces/entity-inventory.interface.js';
+export declare const itemStackSchema: z.ZodObject<{
+    item: z.ZodString;
+    count: z.ZodNumber;
+}, z.core.$strip>;
+export type ItemStackInfo = z.infer<typeof itemStackSchema>;
+export declare const entityInventorySchema: z.ZodObject<{
+    hotbar: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    inventory: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+}, z.core.$strip>;
+export type EntityInventoryInfo = z.infer<typeof entityInventorySchema>;
+export declare const entitySummarySchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<typeof EEntityKind>;
+    type: z.ZodString;
+    typeDisplayName: z.ZodString;
+    category: z.ZodString;
+    name: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    z: z.ZodNumber;
+    dimension: z.ZodString;
+}, z.core.$strip>;
+export type EntitySummary = z.infer<typeof entitySummarySchema>;
+export declare const entityInfoSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<typeof EEntityKind>;
+    type: z.ZodString;
+    typeDisplayName: z.ZodString;
+    category: z.ZodString;
+    name: z.ZodString;
+    x: z.ZodNumber;
+    y: z.ZodNumber;
+    z: z.ZodNumber;
+    dimension: z.ZodString;
+    createdAt: z.ZodString;
+    usedSlots: z.ZodNumber;
+    totalSlots: z.ZodNumber;
+    inventory: z.ZodObject<{
+        hotbar: z.ZodArray<z.ZodNullable<z.ZodObject<{
+            item: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>>;
+        inventory: z.ZodArray<z.ZodNullable<z.ZodObject<{
+            item: z.ZodString;
+            count: z.ZodNumber;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+export type EntityInfo = z.infer<typeof entityInfoSchema>;
+export declare const inventoryViewSchema: z.ZodObject<{
+    entity: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<typeof EEntityKind>;
+        type: z.ZodString;
+        typeDisplayName: z.ZodString;
+        category: z.ZodString;
+        name: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+        dimension: z.ZodString;
+    }, z.core.$strip>;
+    hotbar: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    inventory: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    hotbarUsed: z.ZodNumber;
+    inventoryUsed: z.ZodNumber;
+    usedSlots: z.ZodNumber;
+    totalSlots: z.ZodNumber;
+}, z.core.$strip>;
+export type InventoryView = z.infer<typeof inventoryViewSchema>;
+export declare const inventoryChangeSchema: z.ZodObject<{
+    entity: z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<typeof EEntityKind>;
+        type: z.ZodString;
+        typeDisplayName: z.ZodString;
+        category: z.ZodString;
+        name: z.ZodString;
+        x: z.ZodNumber;
+        y: z.ZodNumber;
+        z: z.ZodNumber;
+        dimension: z.ZodString;
+    }, z.core.$strip>;
+    hotbar: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    inventory: z.ZodArray<z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>>;
+    hotbarUsed: z.ZodNumber;
+    inventoryUsed: z.ZodNumber;
+    usedSlots: z.ZodNumber;
+    totalSlots: z.ZodNumber;
+    section: z.ZodEnum<typeof EInventorySection>;
+    slot: z.ZodNumber;
+    previous: z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+    item: z.ZodNullable<z.ZodObject<{
+        item: z.ZodString;
+        count: z.ZodNumber;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InventoryChange = z.infer<typeof inventoryChangeSchema>;
+export declare function toItemStackInfo(stack: IItemStack): ItemStackInfo;
+export declare function toEntityInventoryInfo(entity: IEntity): EntityInventoryInfo;
+export declare function toEntitySummary(entity: IEntity): EntitySummary;
+export declare function toEntityInfo(entity: IEntity): EntityInfo;
+export declare function toInventoryView(entity: IEntity): InventoryView;
+export declare const INVENTORY_LIMITS: {
+    readonly hotbar: 9;
+    readonly inventory: 27;
+};
+//# sourceMappingURL=entity-schema.d.ts.map

package/lib/schemas/entity-schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/entity-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,WAAW,EAAE,MAAM,8BAA8B,CAAC;AAC3D,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AASvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,6CAA6C,CAAC;AAE9E,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAE5D,eAAO,MAAM,qBAAqB;;;;;;;;;iBAGhC,CAAC;AAEH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAExE,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAW9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;iBAK3B,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ9B,CAAC;AAEH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhC,CAAC;AAEH,MAAM,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAEpE,wBAAgB,eAAe,CAAC,KAAK,EAAE,UAAU,GAAG,aAAa,CAEhE;AAQD,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,mBAAmB,CAK1E;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAa9D;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,OAAO,GAAG,UAAU,CAQxD;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,aAAa,CAa9D;AAED,eAAO,MAAM,gBAAgB;;;CAGnB,CAAC"}

package/lib/tools/block-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-tools.d.ts","sourceRoot":"","sources":["../../src/tools/block-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAgB9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAe/C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAuKxE"}
+{"version":3,"file":"block-tools.d.ts","sourceRoot":"","sources":["../../src/tools/block-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAY9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAiJxE"}

package/lib/tools/entity-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import type { World } from '../world/world.js';
+export declare function registerEntityTools(server: McpServer, world: World): void;
+//# sourceMappingURL=entity-tools.d.ts.map

package/lib/tools/entity-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-tools.d.ts","sourceRoot":"","sources":["../../src/tools/entity-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AA4B9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA6D/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAyWzE"}

package/lib/tools/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAK9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAGnE"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAKnE"}

package/lib/tools/result.d.ts

@@ -1,9 +1,4 @@
-export declare function toolText(text: string): {
-    content: [{
-        type: 'text';
-        text: string;
-    }];
-};
+import type { IDimension } from '../interfaces/dimension.interface.js';
 export declare function toolError(message: string): {
     isError: true;
     content: [{
@@ -11,4 +6,5 @@ export declare function toolError(message: string): {
         text: string;
     }];
 };
+export declare function coordinateRangeError(dimension: IDimension, x: number, y: number, z: number): ReturnType<typeof toolError>;
 //# sourceMappingURL=result.d.ts.map

package/lib/tools/result.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG;IACtC,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C,CAIA;AAED,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C,CAKA"}
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAMvE,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG;IAC1C,OAAO,EAAE,IAAI,CAAC;IACd,OAAO,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3C,CAKA;AAED,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,UAAU,EACrB,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,GACR,UAAU,CAAC,OAAO,SAAS,CAAC,CAI9B"}

package/lib/tools/world-tools.d.ts

@@ -0,0 +1,4 @@
+import type { McpServer } from '@modelcontextprotocol/server';
+import type { World } from '../world/world.js';
+export declare function registerWorldTools(server: McpServer, world: World): void;
+//# sourceMappingURL=world-tools.d.ts.map

package/lib/tools/world-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"world-tools.d.ts","sourceRoot":"","sources":["../../src/tools/world-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAO9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAI/C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAkJxE"}

package/lib/utils/logger.d.ts

@@ -0,0 +1,3 @@
+import log4js from 'log4js';
+export declare const logger: log4js.Logger;
+//# sourceMappingURL=logger.d.ts.map

package/lib/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../src/utils/logger.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,QAAQ,CAAC;AA+D5B,eAAO,MAAM,MAAM,eAAoC,CAAC"}

package/lib/world/block-states.d.ts

@@ -2,6 +2,8 @@ import type { BlockStates } from '../interfaces/block-states.interface.js';
 export declare const EMPTY_BLOCK_STATES: BlockStates;
 export declare function isSafeStateName(name: string): boolean;
 export declare function isSafeStateValue(value: string): boolean;
+export declare function compareStateNames(a: string, b: string): number;
+export declare function isEmptyStates(states: BlockStates | null | undefined): boolean;
 export declare function normalizeStates(states: BlockStates | null | undefined): BlockStates;
 export declare function sameStates(a: BlockStates, b: BlockStates): boolean;
 export declare function formatStates(states: BlockStates): string;

package/lib/world/block-states.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"block-states.d.ts","sourceRoot":"","sources":["../../src/world/block-states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,eAAO,MAAM,kBAAkB,EAAE,WAA+B,CAAC;AAajE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOvD;AAGD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACrC,WAAW,CAgBb;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAMlE;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAMxD"}
+{"version":3,"file":"block-states.d.ts","sourceRoot":"","sources":["../../src/world/block-states.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,eAAO,MAAM,kBAAkB,EAAE,WAA+B,CAAC;AAajE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQrD;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOvD;AAMD,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAK9D;AAGD,wBAAgB,aAAa,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GAAG,OAAO,CAU7E;AAGD,wBAAgB,eAAe,CAC7B,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,SAAS,GACrC,WAAW,CAkBb;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,WAAW,EAAE,CAAC,EAAE,WAAW,GAAG,OAAO,CAMlE;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,WAAW,GAAG,MAAM,CAQxD"}

package/lib/world/entity-inventory.d.ts

@@ -0,0 +1,16 @@
+import { EInventorySection } from '../enums/inventory-section.enum.js';
+import type { IEntityInventory, IItemStack } from '../interfaces/entity-inventory.interface.js';
+export declare const HOTBAR_SLOT_COUNT = 9;
+export declare const INVENTORY_SLOT_COUNT = 27;
+export declare const TOTAL_SLOT_COUNT: number;
+export declare function slotCount(section: EInventorySection): number;
+export declare function isSlotInRange(section: EInventorySection, slot: number): boolean;
+export declare function createEmptyInventory(): IEntityInventory;
+export declare function normalizeItemStack(value: unknown): IItemStack | null;
+export declare function normalizeInventory(value: unknown): IEntityInventory;
+export declare function getInventorySlot(inventory: IEntityInventory, section: EInventorySection, slot: number): IItemStack | null;
+export declare function withInventorySlot(inventory: IEntityInventory, section: EInventorySection, slot: number, stack: IItemStack | null): IEntityInventory;
+export declare function sameItemStack(a: IItemStack | null, b: IItemStack | null): boolean;
+export declare function inventoryUsedSlots(inventory: IEntityInventory): number;
+export declare function sectionUsedSlots(inventory: IEntityInventory, section: EInventorySection): number;
+//# sourceMappingURL=entity-inventory.d.ts.map

package/lib/world/entity-inventory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-inventory.d.ts","sourceRoot":"","sources":["../../src/world/entity-inventory.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAEvE,OAAO,KAAK,EACV,gBAAgB,EAChB,UAAU,EACX,MAAM,6CAA6C,CAAC;AAErD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AACnC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AACvC,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AAEzE,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAI5D;AAED,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAED,wBAAgB,oBAAoB,IAAI,gBAAgB,CAKvD;AAQD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAyBpE;AAaD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAUnE;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GACX,UAAU,GAAG,IAAI,CAInB;AAGD,wBAAgB,iBAAiB,CAC/B,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,UAAU,GAAG,IAAI,GACvB,gBAAgB,CAUlB;AAED,wBAAgB,aAAa,CAC3B,CAAC,EAAE,UAAU,GAAG,IAAI,EACpB,CAAC,EAAE,UAAU,GAAG,IAAI,GACnB,OAAO,CAKT;AAED,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAKtE;AAED,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAMR"}

package/lib/world/item-spec.d.ts

@@ -0,0 +1,10 @@
+import type { IItem } from '../interfaces/item.interface.js';
+export type ItemSpecResult = {
+    readonly ok: true;
+    readonly item: IItem;
+} | {
+    readonly ok: false;
+    readonly error: string;
+};
+export declare function parseItemSpec(input: string): ItemSpecResult;
+//# sourceMappingURL=item-spec.d.ts.map

package/lib/world/item-spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"item-spec.d.ts","sourceRoot":"","sources":["../../src/world/item-spec.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAE7D,MAAM,MAAM,cAAc,GACtB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAA;CAAE,GAC3C;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AASnD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAyB3D"}

package/lib/world/simulated-dimension.d.ts

@@ -1,27 +1,56 @@
+import { EInventorySection } from '../enums/inventory-section.enum.js';
 import type { IBlock } from '../interfaces/block.interface.js';
 import type { BlockStates } from '../interfaces/block-states.interface.js';
 import type { IDimension } from '../interfaces/dimension.interface.js';
+import type { IEntity } from '../interfaces/entity.interface.js';
+import type { IItemStack } from '../interfaces/entity-inventory.interface.js';
+import type { IEntityType } from '../interfaces/entity-type.interface.js';
 import type { IPlacedBlock } from '../interfaces/placed-block.interface.js';
 import type { IWorldStore } from '../interfaces/world-store.interface.js';
 export declare class SimulatedDimension {
     readonly info: IDimension;
     private readonly blocks;
+    private readonly entities;
+    private readonly playersByName;
     private readonly store;
     private readonly writeDelayMs;
     private timer;
     private queue;
     private savePromise;
     private dirty;
+    private sortedBlocksCache;
+    private sortedEntitiesCache;
     constructor(info: IDimension, store: IWorldStore, writeDelayMs?: number);
     get modifiedBlockCount(): number;
+    get entityCount(): number;
+    get playerCount(): number;
     get placedBlocks(): readonly IPlacedBlock[];
+    get sortedPlacedBlocks(): readonly IPlacedBlock[];
+    get placedEntities(): readonly IEntity[];
+    get sortedPlacedEntities(): readonly IEntity[];
     load(): Promise<void>;
     contains(x: number, y: number, z: number): boolean;
     canSetBlock(x: number, y: number, z: number): boolean;
+    canAddEntity(): boolean;
     getBlock(x: number, y: number, z: number): IBlock;
     getStates(x: number, y: number, z: number): BlockStates;
+    getBlockState(x: number, y: number, z: number): {
+        readonly block: IBlock;
+        readonly states: BlockStates;
+    };
+    getEntity(id: string): IEntity | undefined;
+    findPlayer(name: string): IEntity | undefined;
+    removeDuplicatePlayers(claimedNames: Set<string>): number;
+    createEntity(type: IEntityType, name: string, x: number, y: number, z: number): IEntity;
+    createPlayer(name: string, x: number, y: number, z: number): IEntity;
+    private addEntity;
+    setInventorySlot(id: string, section: EInventorySection, slot: number, stack: IItemStack | null): {
+        readonly previous: IItemStack | null;
+        readonly entity: IEntity;
+    };
     setBlock(x: number, y: number, z: number, block: IBlock, states?: BlockStates): IBlock;
     flush(): Promise<void>;
+    private markDirty;
     private scheduleFlush;
 }
 //# sourceMappingURL=simulated-dimension.d.ts.map

package/lib/world/simulated-dimension.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"simulated-dimension.d.ts","sourceRoot":"","sources":["../../src/world/simulated-dimension.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,yCAAyC,CAAC;AAC5E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAQ1E,qBAAa,kBAAkB;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAE1B,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmC;IAC1D,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAc;IACpC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,KAAK,CAAoC;IACjD,OAAO,CAAC,WAAW,CAA8B;IACjD,OAAO,CAAC,KAAK,CAAS;gBAEV,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,WAAW,EAAE,YAAY,SAAK;IAMnE,IAAI,kBAAkB,IAAI,MAAM,CAE/B;IAED,IAAI,YAAY,IAAI,SAAS,YAAY,EAAE,CAE1C;IAGK,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAsB3B,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAYlD,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAOrD,QAAQ,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM;IAIjD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,WAAW;IAMvD,QAAQ,CACN,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,KAAK,EAAE,MAAM,EACb,MAAM,GAAE,WAAgC,GACvC,MAAM;IA4CH,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAiC5B,OAAO,CAAC,aAAa;CAatB"}
+{"version":3,"file":"simulated-dimension.d.ts","sourceRoot":"","sources":["../../src/world/simulated-dimension.ts"],"names":[],"mappings":"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"}

package/lib/world/stores/file-world-store.d.ts

@@ -1,5 +1,5 @@
 import type { EDimensionType } from '../../enums/dimension-type.enum.js';
-import type { IPlacedBlock } from '../../interfaces/placed-block.interface.js';
+import type { IWorldSnapshot } from '../../interfaces/world-store.interface.js';
 import type { IWorldStore } from '../../interfaces/world-store.interface.js';
 export declare class FileWorldStore implements IWorldStore {
     private readonly directory;
@@ -7,8 +7,8 @@ export declare class FileWorldStore implements IWorldStore {
     constructor(directory: string);
     private ensureDirectory;
     private fileFor;
-    load(type: EDimensionType): Promise<readonly IPlacedBlock[]>;
-    save(type: EDimensionType, blocks: readonly IPlacedBlock[]): Promise<void>;
+    load(type: EDimensionType): Promise<IWorldSnapshot>;
+    save(type: EDimensionType, snapshot: IWorldSnapshot): Promise<void>;
     private quarantine;
 }
 //# sourceMappingURL=file-world-store.d.ts.map

package/lib/world/stores/file-world-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-world-store.d.ts","sourceRoot":"","sources":["../../../src/world/stores/file-world-store.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAmB7E,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,cAAc,CAAS;gBAEnB,SAAS,EAAE,MAAM;YAIf,eAAe;IAO7B,OAAO,CAAC,OAAO;IAIT,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAuD5D,IAAI,CACR,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;YAsCF,UAAU;CAWzB"}
+{"version":3,"file":"file-world-store.d.ts","sourceRoot":"","sources":["../../../src/world/stores/file-world-store.ts"],"names":[],"mappings":"AAaA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAChF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAqC7E,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,cAAc,CAAS;gBAEnB,SAAS,EAAE,MAAM;YAIf,eAAe;IAO7B,OAAO,CAAC,OAAO;IAIT,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAsFnD,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAsD3D,UAAU;CAWzB"}

package/lib/world/stores/memory-world-store.d.ts

@@ -1,9 +1,8 @@
 import type { EDimensionType } from '../../enums/dimension-type.enum.js';
-import type { IPlacedBlock } from '../../interfaces/placed-block.interface.js';
-import type { IWorldStore } from '../../interfaces/world-store.interface.js';
+import type { IWorldSnapshot, IWorldStore } from '../../interfaces/world-store.interface.js';
 export declare class MemoryWorldStore implements IWorldStore {
     private readonly worlds;
-    load(type: EDimensionType): Promise<readonly IPlacedBlock[]>;
-    save(type: EDimensionType, blocks: readonly IPlacedBlock[]): Promise<void>;
+    load(type: EDimensionType): Promise<IWorldSnapshot>;
+    save(type: EDimensionType, snapshot: IWorldSnapshot): Promise<void>;
 }
 //# sourceMappingURL=memory-world-store.d.ts.map

package/lib/world/stores/memory-world-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"memory-world-store.d.ts","sourceRoot":"","sources":["../../../src/world/stores/memory-world-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAM7E,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAsD;IAEvE,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,SAAS,YAAY,EAAE,CAAC;IAK5D,IAAI,CACR,IAAI,EAAE,cAAc,EACpB,MAAM,EAAE,SAAS,YAAY,EAAE,GAC9B,OAAO,CAAC,IAAI,CAAC;CAQjB"}
+{"version":3,"file":"memory-world-store.d.ts","sourceRoot":"","sources":["../../../src/world/stores/memory-world-store.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACZ,MAAM,2CAA2C,CAAC;AAMnD,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAE9D,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAOnD,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;CAgB1E"}

package/lib/world/stores/serialized-block.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"serialized-block.d.ts","sourceRoot":"","sources":["../../../src/world/stores/serialized-block.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAG9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAiBnE;AAkBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAyBlE"}
+{"version":3,"file":"serialized-block.d.ts","sourceRoot":"","sources":["../../../src/world/stores/serialized-block.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,4CAA4C,CAAC;AAG9E,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAC;CAC/B;AAED,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAcnE;AAkBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAyBlE"}