@lzimul/minecraft-mcp 1.0.3 → 1.0.5

package/build/world/stores/memory-world-store.js

@@ -1,14 +1,27 @@
 import { WORLD_LIMITS } from '../../config/world-limits.js';
+import { serializeSnapshot } from './serialized-snapshot.js';
 export class MemoryWorldStore {
     worlds = new Map();
     async load(type) {
         const stored = this.worlds.get(type);
-        return stored ? [...stored] : [];
+        return stored
+            ? { blocks: [...stored.blocks], entities: [...stored.entities] }
+            : { blocks: [], entities: [] };
     }
-    async save(type, blocks) {
-        if (blocks.length > WORLD_LIMITS.maxModifiedBlocks) {
-            throw new RangeError(`World snapshot has ${blocks.length} blocks, above the limit of ${WORLD_LIMITS.maxModifiedBlocks}`);
+    async save(type, snapshot) {
+        if (snapshot.blocks.length > WORLD_LIMITS.maxModifiedBlocks) {
+            throw new RangeError(`World snapshot has ${snapshot.blocks.length} blocks, above the limit of ${WORLD_LIMITS.maxModifiedBlocks}`);
         }
-        this.worlds.set(type, [...blocks]);
+        if (snapshot.entities.length > WORLD_LIMITS.maxEntitiesPerDimension) {
+            throw new RangeError(`World snapshot has ${snapshot.entities.length} entities, above the limit of ${WORLD_LIMITS.maxEntitiesPerDimension}`);
+        }
+        this.worlds.set(type, {
+            blocks: [...snapshot.blocks],
+            entities: [...snapshot.entities]
+        });
+    }
+    async readRaw(type) {
+        const stored = this.worlds.get(type);
+        return serializeSnapshot(type, stored ?? { blocks: [], entities: [] });
     }
 }

package/build/world/stores/serialized-block.js

@@ -1,21 +1,16 @@
 import { getBlockByName } from '../../data/blocks.js';
-import { normalizeStates } from '../block-states.js';
+import { isEmptyStates, normalizeStates } from '../block-states.js';
 export function toSerialized(placed) {
-    const states = normalizeStates(placed.states);
-    if (Object.keys(states).length === 0) {
-        return {
-            x: placed.x,
-            y: placed.y,
-            z: placed.z,
-            block: placed.block.key
-        };
+    const { x, y, z, block, states } = placed;
+    if (isEmptyStates(states)) {
+        return { x, y, z, block: block.key };
     }
     return {
-        x: placed.x,
-        y: placed.y,
-        z: placed.z,
-        block: placed.block.key,
-        states
+        x,
+        y,
+        z,
+        block: block.key,
+        states: normalizeStates(states)
     };
 }
 function readStates(value) {

package/build/world/stores/serialized-entity.js

@@ -0,0 +1,75 @@
+import { WORLD_LIMITS } from '../../config/world-limits.js';
+import { getEntityTypeByName } from '../../data/entities.js';
+import { EEntityKind } from '../../enums/entity-kind.enum.js';
+import { createEmptyInventory, normalizeInventory } from '../entity-inventory.js';
+function serializeStack(stack) {
+    return stack ? { item: stack.item, count: stack.count } : null;
+}
+function serializeInventory(inventory) {
+    return {
+        hotbar: inventory.hotbar.map(serializeStack),
+        inventory: inventory.inventory.map(serializeStack)
+    };
+}
+function hasItems(inventory) {
+    return (inventory.hotbar.some(stack => stack !== null) ||
+        inventory.inventory.some(stack => stack !== null));
+}
+export function toSerializedEntity(entity) {
+    const payload = {
+        id: entity.id,
+        kind: entity.kind,
+        type: entity.type.key,
+        name: entity.name,
+        x: entity.x,
+        y: entity.y,
+        z: entity.z,
+        createdAt: entity.createdAt
+    };
+    if (hasItems(entity.inventory)) {
+        return { ...payload, inventory: serializeInventory(entity.inventory) };
+    }
+    return payload;
+}
+function isCoordinate(value) {
+    return typeof value === 'number' && Number.isInteger(value);
+}
+export function fromSerializedEntity(entry, dimension) {
+    if (typeof entry !== 'object' || entry === null || Array.isArray(entry)) {
+        return null;
+    }
+    const record = entry;
+    const { id, type, name, x, y, z, createdAt, inventory } = record;
+    if (typeof id !== 'string' ||
+        id.trim().length === 0 ||
+        id.length > WORLD_LIMITS.maxEntityIdLength ||
+        typeof type !== 'string' ||
+        typeof name !== 'string' ||
+        name.trim().length === 0 ||
+        name.length > WORLD_LIMITS.maxEntityNameLength ||
+        !isCoordinate(x) ||
+        !isCoordinate(y) ||
+        !isCoordinate(z)) {
+        return null;
+    }
+    const resolved = getEntityTypeByName(type.trim().toLowerCase());
+    if (!resolved) {
+        return null;
+    }
+    return {
+        id: id.trim(),
+        kind: resolved.name === 'player' ? EEntityKind.Player : EEntityKind.Entity,
+        type: resolved,
+        name: name.trim(),
+        x,
+        y,
+        z,
+        dimension,
+        inventory: typeof inventory === 'undefined'
+            ? createEmptyInventory()
+            : normalizeInventory(inventory),
+        createdAt: typeof createdAt === 'string' && createdAt.length > 0
+            ? createdAt
+            : new Date().toISOString()
+    };
+}

package/build/world/stores/serialized-snapshot.js

@@ -0,0 +1,35 @@
+import { toSerialized } from './serialized-block.js';
+import { toSerializedEntity } from './serialized-entity.js';
+export const SNAPSHOT_FORMAT = 'lzimul:minecraft/dimension';
+export const MAX_SNAPSHOT_BYTES = 128 * 1024 * 1024;
+function compareIds(a, b) {
+    if (a.id === b.id) {
+        return 0;
+    }
+    return a.id < b.id ? -1 : 1;
+}
+function compareBlocks(a, b) {
+    return a.x - b.x || a.y - b.y || a.z - b.z;
+}
+function sortedCopy(values, compare) {
+    for (let index = 1; index < values.length; index += 1) {
+        if (compare(values[index - 1], values[index]) > 0) {
+            return values.toSorted(compare);
+        }
+    }
+    return values;
+}
+export function serializeSnapshot(type, snapshot, updatedAt = new Date().toISOString()) {
+    const sortedBlocks = sortedCopy(snapshot.blocks, compareBlocks);
+    const sortedEntities = sortedCopy(snapshot.entities, compareIds);
+    const payload = {
+        format: SNAPSHOT_FORMAT,
+        dimension: `minecraft:${type}`,
+        updatedAt,
+        modifiedBlockCount: sortedBlocks.length,
+        entityCount: sortedEntities.length,
+        blocks: sortedBlocks.map(toSerialized),
+        entities: sortedEntities.map(toSerializedEntity)
+    };
+    return `${JSON.stringify(payload)}\n`;
+}

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/app/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/app/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAMzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAE/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAKpD"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/app/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAMzD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAG/C,wBAAgB,YAAY,CAAC,KAAK,EAAE,KAAK,GAAG,SAAS,CAKpD"}

package/lib/config/dimensions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/config/dimensions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAEvE,eAAO,MAAM,UAAU,EAAE,SAAS,UAAU,EAyB3C,CAAC"}
+{"version":3,"file":"dimensions.d.ts","sourceRoot":"","sources":["../../src/config/dimensions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sCAAsC,CAAC;AAGvE,eAAO,MAAM,UAAU,EAAE,SAAS,UAAU,EAyB3C,CAAC"}

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;AAGzD,eAAO,MAAM,WAAW;;;;;;;;;;;;CAoBvB,CAAC"}

package/lib/config/storage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/config/storage.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAeD,eAAO,MAAM,aAAa,EAAE,mBAI3B,CAAC"}
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/config/storage.ts"],"names":[],"mappings":"AAGA,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,QAAQ,CAAC;AAGlD,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAoBD,eAAO,MAAM,aAAa,EAAE,mBAI3B,CAAC"}

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

@@ -4,5 +4,10 @@ export declare const WORLD_LIMITS: {
     readonly minVertical: -64;
     readonly maxVertical: 320;
     readonly maxModifiedBlocks: 250000;
+    readonly maxFillVolume: 16384;
+    readonly maxEntitiesPerDimension: 10000;
+    readonly maxEntityIdLength: 128;
+    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":"AACA,eAAO,MAAM,YAAY;;;;;;;;;;;CAaf,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;AACF,eAAO,MAAM,sBAAsB,QAAgC,CAAC;AAMpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEzE"}

package/lib/enums/bounding-box.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"bounding-box.enum.d.ts","sourceRoot":"","sources":["../../src/enums/bounding-box.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,YAAY;IACtB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB"}
+{"version":3,"file":"bounding-box.enum.d.ts","sourceRoot":"","sources":["../../src/enums/bounding-box.enum.ts"],"names":[],"mappings":"AACA,oBAAY,YAAY;IACtB,KAAK,UAAU;IACf,KAAK,UAAU;CAChB"}

package/lib/enums/dimension-type.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dimension-type.enum.d.ts","sourceRoot":"","sources":["../../src/enums/dimension-type.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,cAAc;IACxB,SAAS,cAAc;IACvB,SAAS,eAAe;IACxB,MAAM,YAAY;CACnB"}
+{"version":3,"file":"dimension-type.enum.d.ts","sourceRoot":"","sources":["../../src/enums/dimension-type.enum.ts"],"names":[],"mappings":"AACA,oBAAY,cAAc;IACxB,SAAS,cAAc;IACvB,SAAS,eAAe;IACxB,MAAM,YAAY;CACnB"}

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":"AACA,oBAAY,WAAW;IACrB,MAAM,WAAW;IACjB,MAAM,WAAW;CAClB"}

package/lib/enums/icon-theme.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"icon-theme.enum.d.ts","sourceRoot":"","sources":["../../src/enums/icon-theme.enum.ts"],"names":[],"mappings":"AAAA,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,IAAI,SAAS;CACd"}
+{"version":3,"file":"icon-theme.enum.d.ts","sourceRoot":"","sources":["../../src/enums/icon-theme.enum.ts"],"names":[],"mappings":"AACA,oBAAY,UAAU;IACpB,KAAK,UAAU;IACf,IAAI,SAAS;CACd"}

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":"AACA,oBAAY,iBAAiB;IAC3B,MAAM,WAAW;IACjB,SAAS,cAAc;CACxB"}

package/lib/enums/move-direction.enum.d.ts

@@ -0,0 +1,9 @@
+export declare enum EMoveDirection {
+    Forward = "forward",
+    Back = "back",
+    Left = "left",
+    Right = "right",
+    Up = "up",
+    Down = "down"
+}
+//# sourceMappingURL=move-direction.enum.d.ts.map

package/lib/enums/move-direction.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"move-direction.enum.d.ts","sourceRoot":"","sources":["../../src/enums/move-direction.enum.ts"],"names":[],"mappings":"AACA,oBAAY,cAAc;IACxB,OAAO,YAAY;IACnB,IAAI,SAAS;IACb,IAAI,SAAS;IACb,KAAK,UAAU;IACf,EAAE,OAAO;IACT,IAAI,SAAS;CACd"}

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

@@ -1 +1 @@
-{"version":3,"file":"block.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/block.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;CACpC"}
+{"version":3,"file":"block.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/block.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAE7D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,WAAW,MAAO,SAAQ,UAAU;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,YAAY,CAAC;CACpC"}

package/lib/interfaces/data-entry.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"data-entry.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/data-entry.interface.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}
+{"version":3,"file":"data-entry.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/data-entry.interface.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

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

@@ -1 +1 @@
-{"version":3,"file":"dimension.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/dimension.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAEjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}
+{"version":3,"file":"dimension.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/dimension.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AAGjE,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,cAAc,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;CAC/B"}

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;IACzB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAGD,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;AAG5D,MAAM,WAAW,WAAY,SAAQ,UAAU;IAC7C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,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;IAC3B,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/item.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/item.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC"}
+{"version":3,"file":"item.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/item.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAG5D,MAAM,WAAW,KAAM,SAAQ,UAAU;IACvC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC/C,QAAQ,CAAC,UAAU,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACzC"}

package/lib/interfaces/placed-block.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"placed-block.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/placed-block.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD,MAAM,WAAW,YAAY;IAC3B,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,EAAE,WAAW,CAAC;CAC9B"}
+{"version":3,"file":"placed-block.interface.d.ts","sourceRoot":"","sources":["../../src/interfaces/placed-block.interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,6BAA6B,CAAC;AAC/D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAGnD,MAAM,WAAW,YAAY;IAC3B,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,EAAE,WAAW,CAAC;CAC9B"}

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

@@ -1,7 +1,13 @@
 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>;
+    readRaw(type: EDimensionType): Promise<string>;
 }
 //# 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;AAGhE,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,MAAM,EAAE,SAAS,YAAY,EAAE,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,SAAS,OAAO,EAAE,CAAC;CACvC;AAGD,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;IACpE,OAAO,CAAC,IAAI,EAAE,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC,CAAC;CAChD"}

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

@@ -1 +1 @@
-{"version":3,"file":"block-resources.d.ts","sourceRoot":"","sources":["../../src/resources/block-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAS9D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAa9D"}
+{"version":3,"file":"block-resources.d.ts","sourceRoot":"","sources":["../../src/resources/block-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAU9D,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAa9D"}

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

@@ -1 +1 @@
-{"version":3,"file":"data-resources.d.ts","sourceRoot":"","sources":["../../src/resources/data-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAYxE,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,UAAU,EAC5D,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CACvB,GACA,IAAI,CA6BN;AAED,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,UAAU,EAC7D,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CACvB,GACA,IAAI,CAwBN"}
+{"version":3,"file":"data-resources.d.ts","sourceRoot":"","sources":["../../src/resources/data-resources.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAI9D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAkBxE,wBAAgB,yBAAyB,CAAC,CAAC,SAAS,UAAU,EAC5D,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IACN,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CACvB,GACA,IAAI,CA6BN;AAGD,wBAAgB,0BAA0B,CAAC,CAAC,SAAS,UAAU,EAC7D,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE;IACN,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,SAAS,CAAC,EAAE,CAAC;CACvB,GACA,IAAI,CAwBN"}

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;AAI9D,OAAO,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAC;AAqD1C,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,SAAS,EACjB,KAAK,EAAE,KAAK,GACX,IAAI,CAgCN;AAGD,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;AAa9D,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;AAG/C,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAMvE"}

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

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

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

@@ -1 +1 @@
-{"version":3,"file":"block-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/block-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAE/D,eAAO,MAAM,eAAe;;;;;;;;;;;iBAW1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAExD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAapD"}
+{"version":3,"file":"block-schema.d.ts","sourceRoot":"","sources":["../../src/schemas/block-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,kCAAkC,CAAC;AAG/D,eAAO,MAAM,eAAe;;;;;;;;;;;iBAW1B,CAAC;AAEH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC;AAGxD,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,CAapD"}

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;AAK5B,eAAO,MAAM,oBAAoB,aAIC,CAAC;AAGnC,eAAO,MAAM,kBAAkB,aAIC,CAAC;AAGjC,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;AAGjE,eAAO,MAAM,eAAe,gDAEQ,CAAC;AAGrC,eAAO,MAAM,mBAAmB,kCAAyB,CAAC;AAG1D,eAAO,MAAM,cAAc,gDAE1B,CAAC"}