@lzimul/minecraft-mcp 1.0.3 → 1.0.5

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;AAG9E,eAAO,MAAM,eAAe;;;iBAG1B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAG5D,eAAO,MAAM,qBAAqB;;;;;;;;;iBAGhC,CAAC;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,qBAAqB,CAAC,CAAC;AAGxE,eAAO,MAAM,mBAAmB;;;;;;;;;;;iBAW9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;iBAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAG1D,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;iBAQ9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAGhE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKhC,CAAC;AACH,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/schemas/item-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/item-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAE7D,eAAO,MAAM,cAAc;;;;;;;;iBAQzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAiBhD"}
+{"version":3,"file":"item-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/item-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AAG7D,eAAO,MAAM,cAAc;;;;;;;;iBAQzB,CAAC;AAEH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAGtD,wBAAgB,UAAU,CAAC,IAAI,EAAE,KAAK,GAAG,QAAQ,CAiBhD"}

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;AAK/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;AAgC9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AA8H/C,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAqsBzE"}

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;AAG/C,wBAAgB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAKnE"}

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

@@ -1 +1 @@
-{"version":3,"file":"item-tools.d.ts","sourceRoot":"","sources":["../../src/tools/item-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAQ9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDzD"}
+{"version":3,"file":"item-tools.d.ts","sourceRoot":"","sources":["../../src/tools/item-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9D,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAoDzD"}

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;AAGvE,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;AAGD,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;AAoB9D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAyC/C,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAyjBxE"}

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;AAqE5B,eAAO,MAAM,MAAM,eAAoC,CAAC"}

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

@@ -1 +1 @@
-{"version":3,"file":"block-spec.d.ts","sourceRoot":"","sources":["../../src/world/block-spec.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAE3E,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAUnD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CAwE7D"}
+{"version":3,"file":"block-spec.d.ts","sourceRoot":"","sources":["../../src/world/block-spec.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAC/D,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yCAAyC,CAAC;AAG3E,MAAM,MAAM,eAAe,GACvB;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAA;CAAE,GAC3E;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAAC;AAanD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,eAAe,CA0E7D"}

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;AAMD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAOvD;AAGD,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;AAGD,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;AAGrD,eAAO,MAAM,iBAAiB,IAAI,CAAC;AAEnC,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC,eAAO,MAAM,gBAAgB,QAA2C,CAAC;AAGzE,wBAAgB,SAAS,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAI5D;AAGD,wBAAgB,aAAa,CAC3B,OAAO,EAAE,iBAAiB,EAC1B,IAAI,EAAE,MAAM,GACX,OAAO,CAET;AAGD,wBAAgB,oBAAoB,IAAI,gBAAgB,CAKvD;AAGD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,UAAU,GAAG,IAAI,CAyBpE;AAcD,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,GAAG,gBAAgB,CAUnE;AAGD,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;AAGD,wBAAgB,aAAa,CAC3B,CAAC,EAAE,UAAU,GAAG,IAAI,EACpB,CAAC,EAAE,UAAU,GAAG,IAAI,GACnB,OAAO,CAKT;AAGD,wBAAgB,kBAAkB,CAAC,SAAS,EAAE,gBAAgB,GAAG,MAAM,CAatE;AAGD,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,gBAAgB,EAC3B,OAAO,EAAE,iBAAiB,GACzB,MAAM,CAYR"}

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;AAG7D,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,81 @@
+import { EInventorySection } from '../enums/inventory-section.enum.js';
+import { EMoveDirection } from '../enums/move-direction.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 interface IEntityPosition {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}
+export interface IEntityPositionResult {
+    readonly previous: IEntityPosition;
+    readonly entity: IEntity;
+}
+export interface IInventoryClearResult {
+    readonly clearedSlots: number;
+    readonly entity: IEntity;
+}
+export interface IInventorySwapResult {
+    readonly previousFrom: IItemStack | null;
+    readonly previousTo: IItemStack | null;
+    readonly entity: IEntity;
+}
 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;
+    };
+    deleteEntity(id: string): IEntity | undefined;
+    clearInventory(id: string): IInventoryClearResult;
+    swapInventorySlots(id: string, fromSection: EInventorySection, fromSlot: number, toSection: EInventorySection, toSlot: number): IInventorySwapResult;
+    moveEntity(id: string, direction: EMoveDirection): IEntityPositionResult;
+    setEntityPosition(id: string, x: number, y: number, z: number): IEntityPositionResult;
     setBlock(x: number, y: number, z: number, block: IBlock, states?: BlockStates): IBlock;
+    readRaw(): Promise<string>;
     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,14 +1,14 @@
 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 FileWorldStore implements IWorldStore {
     private readonly directory;
     private directoryReady;
     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>;
+    readRaw(type: EDimensionType): Promise<string>;
+    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":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAGzE,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACZ,MAAM,2CAA2C,CAAC;AAsBnD,qBAAa,cAAe,YAAW,WAAW;IAChD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,cAAc,CAAS;gBAEnB,SAAS,EAAE,MAAM;YAKf,eAAe;IAQ7B,OAAO,CAAC,OAAO;IAKT,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IA+FnD,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAyB9C,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;YAoC3D,UAAU;CAWzB"}

package/lib/world/stores/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/world/stores/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAE7E,wBAAgB,gBAAgB,IAAI,WAAW,CAK9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/world/stores/index.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2CAA2C,CAAC;AAG7E,wBAAgB,gBAAgB,IAAI,WAAW,CAK9C"}

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

@@ -1,9 +1,9 @@
 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>;
+    readRaw(type: EDimensionType): Promise<string>;
 }
 //# 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":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EACV,cAAc,EACd,WAAW,EACZ,MAAM,2CAA2C,CAAC;AAGnD,qBAAa,gBAAiB,YAAW,WAAW;IAClD,OAAO,CAAC,QAAQ,CAAC,MAAM,CAA6C;IAG9D,IAAI,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,cAAc,CAAC;IAQnD,IAAI,CAAC,IAAI,EAAE,cAAc,EAAE,QAAQ,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBnE,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;CAIrD"}

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;AAGD,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,gBAAgB,CAcnE;AAmBD,wBAAgB,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,YAAY,GAAG,IAAI,CAyBlE"}

package/lib/world/stores/serialized-entity.d.ts

@@ -0,0 +1,24 @@
+import type { EDimensionType } from '../../enums/dimension-type.enum.js';
+import type { IEntity } from '../../interfaces/entity.interface.js';
+export interface ISerializedItemStack {
+    readonly item: string;
+    readonly count: number;
+}
+export interface ISerializedInventory {
+    readonly hotbar?: readonly (ISerializedItemStack | null)[];
+    readonly inventory?: readonly (ISerializedItemStack | null)[];
+}
+export interface ISerializedEntity {
+    readonly id: string;
+    readonly kind: string;
+    readonly type: string;
+    readonly name: string;
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+    readonly createdAt: string;
+    readonly inventory?: ISerializedInventory;
+}
+export declare function toSerializedEntity(entity: IEntity): ISerializedEntity;
+export declare function fromSerializedEntity(entry: unknown, dimension: EDimensionType): IEntity | null;
+//# sourceMappingURL=serialized-entity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialized-entity.d.ts","sourceRoot":"","sources":["../../../src/world/stores/serialized-entity.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AACzE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sCAAsC,CAAC;AAMpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAAE,CAAC;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC,oBAAoB,GAAG,IAAI,CAAC,EAAE,CAAC;CAC/D;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,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,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAC3C;AAuBD,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,OAAO,GAAG,iBAAiB,CAiBrE;AAUD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,OAAO,EACd,SAAS,EAAE,cAAc,GACxB,OAAO,GAAG,IAAI,CA6ChB"}

package/lib/world/stores/serialized-snapshot.d.ts

@@ -0,0 +1,6 @@
+import type { EDimensionType } from '../../enums/dimension-type.enum.js';
+import type { IWorldSnapshot } from '../../interfaces/world-store.interface.js';
+export declare const SNAPSHOT_FORMAT = "lzimul:minecraft/dimension";
+export declare const MAX_SNAPSHOT_BYTES: number;
+export declare function serializeSnapshot(type: EDimensionType, snapshot: IWorldSnapshot, updatedAt?: string): string;
+//# sourceMappingURL=serialized-snapshot.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"serialized-snapshot.d.ts","sourceRoot":"","sources":["../../../src/world/stores/serialized-snapshot.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAEzE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2CAA2C,CAAC;AAGhF,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAG5D,eAAO,MAAM,kBAAkB,QAAoB,CAAC;AAuCpD,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,cAAc,EACpB,QAAQ,EAAE,cAAc,EACxB,SAAS,SAA2B,GACnC,MAAM,CAaR"}

package/lib/world/world.d.ts

@@ -1,6 +1,7 @@
 import { SimulatedDimension } from './simulated-dimension.js';
 import type { EDimensionType } from '../enums/dimension-type.enum.js';
 import type { IDimension } from '../interfaces/dimension.interface.js';
+import type { IEntity } from '../interfaces/entity.interface.js';
 import type { IWorldStore } from '../interfaces/world-store.interface.js';
 export declare class World {
     private readonly dimensions;
@@ -8,6 +9,8 @@ export declare class World {
     static load(store: IWorldStore, writeDelayMs?: number): Promise<World>;
     static listDimensions(): readonly IDimension[];
     getDimension(type: EDimensionType): SimulatedDimension;
+    findEntity(id: string): IEntity | undefined;
+    findPlayer(name: string): IEntity | undefined;
     flush(): Promise<void>;
 }
 //# sourceMappingURL=world.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/world/world.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAS1E,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkD;IAE7E,OAAO;WAMM,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAsBxE,MAAM,CAAC,cAAc,IAAI,SAAS,UAAU,EAAE;IAI9C,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,kBAAkB;IAUhD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAc7B"}
+{"version":3,"file":"world.d.ts","sourceRoot":"","sources":["../../src/world/world.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAC;AAE9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wCAAwC,CAAC;AAS1E,qBAAa,KAAK;IAChB,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAkD;IAE7E,OAAO;WAMM,IAAI,CAAC,KAAK,EAAE,WAAW,EAAE,YAAY,SAAK,GAAG,OAAO,CAAC,KAAK,CAAC;IAwCxE,MAAM,CAAC,cAAc,IAAI,SAAS,UAAU,EAAE;IAK9C,YAAY,CAAC,IAAI,EAAE,cAAc,GAAG,kBAAkB;IAWtD,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAW3C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAevC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;CAa7B"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@lzimul/minecraft-mcp",
   "description": "Minecraft Model Context Protocol (MCP) Server",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "author": {
     "name": "lZiMUl",
     "email": "lZiMUl@lzimul.com",
@@ -37,14 +37,16 @@
   },
   "scripts": {
     "start": "node .",
-    "lint": "npx eslint --fix",
-    "build": "npm run lint && npx tsc -p ./tsconfig.json && npm run typedoc",
+    "lint": "npx eslint .",
+    "lint:fix": "npx eslint . --fix",
+    "build": "npm run lint:fix && npx tsc -p ./tsconfig.json && npm run typedoc",
     "typedoc": "npx typedoc --options ./typedoc.json",
     "dev": "npm run build && npm run start",
     "generate-data": "node ./scripts/generate-data.mjs",
     "clean": "node ./scripts/clean.mjs",
-    "test": "node ./scripts/smoke-test.mjs && node ./scripts/protocol-test.mjs && node ./scripts/persistence-test.mjs && node ./scripts/error-test.mjs && node ./scripts/stress-test.mjs",
-    "test:stress": "node ./scripts/stress-test.mjs"
+    "test": "node ./scripts/smoke-test.mjs && node ./scripts/persistence-test.mjs && node ./scripts/error-test.mjs && node ./scripts/stress-test.mjs",
+    "test:stress": "node ./scripts/stress-test.mjs",
+    "prepublishOnly": "npm run build && npm test"
   },
   "files": [
     "./build/",
@@ -61,13 +63,15 @@
     "minecraft-mcp"
   ],
   "engines": {
-    "node": ">=20"
+    "node": ">=22"
   },
   "overrides": {
     "katex": "^0.19.1"
   },
   "dependencies": {
     "@modelcontextprotocol/server": "^2.4.0",
+    "chalk": "^6.0.1",
+    "log4js": "^6.9.1",
     "zod": "^4.6.7"
   },
   "devDependencies": {
@@ -77,8 +81,8 @@
     "@eslint/json": "^2.1.1",
     "@eslint/markdown": "^8.0.3",
     "@types/node": "^26.6.5",
-    "@typescript-eslint/eslint-plugin": "^8.72.0",
-    "@typescript-eslint/parser": "^8.72.0",
+    "@typescript-eslint/eslint-plugin": "^8.72.1",
+    "@typescript-eslint/parser": "^8.72.1",
     "eslint": "^10.13.0",
     "eslint-config-prettier": "^10.1.8",
     "eslint-plugin-prettier": "^5.5.7",
@@ -88,14 +92,14 @@
     "tslib": "^2.8.1",
     "typedoc": "^0.28.20",
     "typescript": "^6.0.3",
-    "typescript-eslint": "^8.72.0"
+    "typescript-eslint": "^8.72.1"
   },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/lZiMUl/minecraft-mcp.git"
+    "url": "git+https://github.com/lZiMUl/Minecraft-MCP.git"
   },
   "bugs": {
-    "url": "https://github.com/lZiMUl/minecraft-mcp/issues",
+    "url": "https://github.com/lZiMUl/Minecraft-MCP/issues",
     "email": "lZiMUl@lzimul.com"
   },
   "publishConfig": {
@@ -106,4 +110,4 @@
   },
   "sideEffects": false,
   "private": false
-}
+}