@nice2dev/game-engine 1.3.14 → 1.3.16

package/dist/cjs/export/MinecraftBedrockExporter.js

@@ -1,605 +1,600 @@
-'use strict';
-
-var PlatformExporter = require('./PlatformExporter.js');
-
-/* ────────────────────────────────────────────────────────────────
-   Minecraft Bedrock Exporter — Resource & Behavior Pack Export
-   
-   Exports Nice2Dev projects to Minecraft Bedrock Edition format:
-   - Resource packs (textures, models, sounds)
-   - Behavior packs (entities, scripts)
-   - World structure
-   - Manifest files
-──────────────────────────────────────────────────────────────── */
-/* ── UUID Generator ───────────────────────────────────────────── */
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const PlatformExporter = require("./PlatformExporter.js");
 function generateUUID() {
-    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'.replace(/[xy]/g, (c) => {
-        const r = (Math.random() * 16) | 0;
-        const v = c === 'x' ? r : (r & 0x3) | 0x8;
-        return v.toString(16);
-    });
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
 }
-/* ── Minecraft Component Mappings ─────────────────────────────── */
 const MINECRAFT_COMPONENT_MAP = {
-    rigidbody: (_comp) => ({
-        'minecraft:physics': {
-            has_gravity: true,
-            has_collision: true,
-        },
-    }),
-    boxCollider: (comp) => ({
-        'minecraft:collision_box': {
-            width: comp.properties?.['width'] ?? 1,
-            height: comp.properties?.['height'] ?? 1,
+  rigidbody: (_comp) => ({
+    "minecraft:physics": {
+      has_gravity: true,
+      has_collision: true
+    }
+  }),
+  boxCollider: (comp) => ({
+    "minecraft:collision_box": {
+      width: comp.properties?.["width"] ?? 1,
+      height: comp.properties?.["height"] ?? 1
+    }
+  }),
+  health: (comp) => ({
+    "minecraft:health": {
+      value: comp.properties?.["current"] ?? 20,
+      max: comp.properties?.["max"] ?? 20
+    }
+  }),
+  movement: (comp) => ({
+    "minecraft:movement": {
+      value: comp.properties?.["speed"] ?? 0.25
+    },
+    "minecraft:movement.basic": {}
+  }),
+  jump: (comp) => ({
+    "minecraft:jump.static": {
+      jump_power: comp.properties?.["power"] ?? 0.42
+    }
+  })
+};
+class MinecraftBedrockExporter extends PlatformExporter.PlatformExporter {
+  constructor() {
+    super(...arguments);
+    this.platformId = "minecraft-bedrock";
+    this.platformInfo = {
+      id: "minecraft-bedrock",
+      name: "Minecraft Bedrock Edition",
+      description: "Minecraft Bedrock resource packs and behavior packs for custom content",
+      website: "https://learn.microsoft.com/en-us/minecraft/",
+      features: ["3d-rendering", "physics-3d", "audio", "particles", "animation"],
+      supportedAssets: ["texture", "audio", "prefab", "scene", "data"],
+      exportFormats: [".json", ".png", ".ogg", ".mcstructure"]
+    };
+    this.projectName = "nice2dev_pack";
+    this.namespace = "n2d";
+    this.resourcePackUUID = "";
+    this.behaviorPackUUID = "";
+  }
+  async doExport(project, options) {
+    const safeName = (options.projectName ?? project.name).toLowerCase().replace(/[^a-z0-9_]/g, "_");
+    this.projectName = safeName;
+    this.namespace = safeName.substring(0, 10);
+    this.resourcePackUUID = generateUUID();
+    this.behaviorPackUUID = generateUUID();
+    const platformOpts = options.platformOptions ?? {};
+    const minEngineVersion = platformOpts.minEngineVersion ?? [1, 20, 0];
+    const packVersion = platformOpts.packVersion ?? [1, 0, 0];
+    await this.generateResourcePack(project, options, minEngineVersion, packVersion);
+    await this.generateBehaviorPack(project, options, minEngineVersion, packVersion);
+    if (platformOpts.generateScripts !== false) {
+      await this.generateScripts(project, options);
+    }
+    for (const prefab of project.prefabs) {
+      await this.exportPrefab(prefab, options);
+    }
+    for (const scene of project.scenes) {
+      await this.exportScene(scene, project, options);
+    }
+  }
+  /* ── Resource Pack ──────────────────────────────────────────── */
+  async generateResourcePack(project, options, minEngineVersion, packVersion) {
+    const rpPath = `${this.projectName}_RP`;
+    const manifest = {
+      format_version: 2,
+      header: {
+        name: `${project.name} Resource Pack`,
+        description: `Resource pack generated from Nice2Dev project v${project.version}`,
+        uuid: this.resourcePackUUID,
+        version: packVersion,
+        min_engine_version: minEngineVersion
+      },
+      modules: [
+        {
+          type: "resources",
+          uuid: generateUUID(),
+          version: packVersion
+        }
+      ]
+    };
+    this.addTextFile(`${rpPath}/manifest.json`, JSON.stringify(manifest, null, 2));
+    this.addTextFile(
+      `${rpPath}/pack_icon.png.txt`,
+      "<!-- Replace this file with a 256x256 PNG named pack_icon.png -->"
+    );
+    const texts = [
+      `pack.name=${project.name} Resource Pack`,
+      `pack.description=Resource pack from Nice2Dev project`
+    ];
+    this.addTextFile(`${rpPath}/texts/en_US.lang`, texts.join("\n"));
+    this.addTextFile(
+      `${rpPath}/textures/item_texture.json`,
+      JSON.stringify(
+        {
+          resource_pack_name: this.projectName,
+          texture_name: "atlas.items",
+          texture_data: {}
         },
-    }),
-    health: (comp) => ({
-        'minecraft:health': {
-            value: comp.properties?.['current'] ?? 20,
-            max: comp.properties?.['max'] ?? 20,
+        null,
+        2
+      )
+    );
+    this.addTextFile(
+      `${rpPath}/textures/terrain_texture.json`,
+      JSON.stringify(
+        {
+          resource_pack_name: this.projectName,
+          texture_name: "atlas.terrain",
+          padding: 8,
+          num_mip_levels: 4,
+          texture_data: {}
         },
-    }),
-    movement: (comp) => ({
-        'minecraft:movement': {
-            value: comp.properties?.['speed'] ?? 0.25,
+        null,
+        2
+      )
+    );
+    this.addTextFile(
+      `${rpPath}/sounds/sound_definitions.json`,
+      JSON.stringify(
+        {
+          format_version: "1.14.0",
+          sound_definitions: {}
         },
-        'minecraft:movement.basic': {},
-    }),
-    jump: (comp) => ({
-        'minecraft:jump.static': {
-            jump_power: comp.properties?.['power'] ?? 0.42,
+        null,
+        2
+      )
+    );
+    this.addTextFile(
+      `${rpPath}/render_controllers/default.render_controllers.json`,
+      JSON.stringify(
+        {
+          format_version: "1.10.0",
+          render_controllers: {
+            [`controller.render.${this.namespace}`]: {
+              geometry: "Geometry.default",
+              materials: [{ "*": "Material.default" }],
+              textures: ["Texture.default"]
+            }
+          }
         },
-    }),
-};
-/* ── Exporter Implementation ──────────────────────────────────── */
-class MinecraftBedrockExporter extends PlatformExporter.PlatformExporter {
-    constructor() {
-        super(...arguments);
-        this.platformId = 'minecraft-bedrock';
-        this.platformInfo = {
-            id: 'minecraft-bedrock',
-            name: 'Minecraft Bedrock Edition',
-            description: 'Minecraft Bedrock resource packs and behavior packs for custom content',
-            website: 'https://learn.microsoft.com/en-us/minecraft/',
-            features: ['3d-rendering', 'physics-3d', 'audio', 'particles', 'animation'],
-            supportedAssets: ['texture', 'audio', 'prefab', 'scene', 'data'],
-            exportFormats: ['.json', '.png', '.ogg', '.mcstructure'],
-        };
-        this.projectName = 'nice2dev_pack';
-        this.namespace = 'n2d';
-        this.resourcePackUUID = '';
-        this.behaviorPackUUID = '';
+        null,
+        2
+      )
+    );
+  }
+  /* ── Behavior Pack ──────────────────────────────────────────── */
+  async generateBehaviorPack(project, options, minEngineVersion, packVersion) {
+    const bpPath = `${this.projectName}_BP`;
+    const platformOpts = options.platformOptions ?? {};
+    const modules = [
+      {
+        type: "data",
+        uuid: generateUUID(),
+        version: packVersion
+      }
+    ];
+    if (platformOpts.generateScripts !== false) {
+      modules.push({
+        type: "script",
+        uuid: generateUUID(),
+        version: packVersion,
+        entry: "scripts/main.js",
+        language: "javascript"
+      });
     }
-    async doExport(project, options) {
-        const safeName = (options.projectName ?? project.name)
-            .toLowerCase()
-            .replace(/[^a-z0-9_]/g, '_');
-        this.projectName = safeName;
-        this.namespace = safeName.substring(0, 10);
-        // Generate unique UUIDs for packs
-        this.resourcePackUUID = generateUUID();
-        this.behaviorPackUUID = generateUUID();
-        const platformOpts = options.platformOptions ?? {};
-        const minEngineVersion = platformOpts.minEngineVersion ?? [1, 20, 0];
-        const packVersion = platformOpts.packVersion ?? [1, 0, 0];
-        // Generate Resource Pack
-        await this.generateResourcePack(project, options, minEngineVersion, packVersion);
-        // Generate Behavior Pack
-        await this.generateBehaviorPack(project, options, minEngineVersion, packVersion);
-        // Generate scripts if enabled
-        if (platformOpts.generateScripts !== false) {
-            await this.generateScripts(project, options);
-        }
-        // Export entities as custom mobs/items
-        for (const prefab of project.prefabs) {
-            await this.exportPrefab(prefab, options);
-        }
-        // Export scenes as structure files
-        for (const scene of project.scenes) {
-            await this.exportScene(scene, project, options);
+    const manifest = {
+      format_version: 2,
+      header: {
+        name: `${project.name} Behavior Pack`,
+        description: `Behavior pack generated from Nice2Dev project v${project.version}`,
+        uuid: this.behaviorPackUUID,
+        version: packVersion,
+        min_engine_version: minEngineVersion
+      },
+      modules,
+      dependencies: [
+        {
+          uuid: this.resourcePackUUID,
+          version: packVersion
         }
+      ]
+    };
+    if (platformOpts.generateScripts !== false) {
+      manifest.dependencies.push({
+        uuid: "b26a4d4c-afdf-4690-88f8-931846312678",
+        // @minecraft/server
+        version: [1, 7, 0]
+      });
     }
-    /* ── Resource Pack ──────────────────────────────────────────── */
-    async generateResourcePack(project, options, minEngineVersion, packVersion) {
-        const rpPath = `${this.projectName}_RP`;
-        // Manifest
-        const manifest = {
-            format_version: 2,
-            header: {
-                name: `${project.name} Resource Pack`,
-                description: `Resource pack generated from Nice2Dev project v${project.version}`,
-                uuid: this.resourcePackUUID,
-                version: packVersion,
-                min_engine_version: minEngineVersion,
-            },
-            modules: [
-                {
-                    type: 'resources',
-                    uuid: generateUUID(),
-                    version: packVersion,
-                },
-            ],
-        };
-        this.addTextFile(`${rpPath}/manifest.json`, JSON.stringify(manifest, null, 2));
-        // Pack icon placeholder
-        this.addTextFile(`${rpPath}/pack_icon.png.txt`, '<!-- Replace this file with a 256x256 PNG named pack_icon.png -->');
-        // Texts for localization
-        const texts = [
-            `pack.name=${project.name} Resource Pack`,
-            `pack.description=Resource pack from Nice2Dev project`,
-        ];
-        this.addTextFile(`${rpPath}/texts/en_US.lang`, texts.join('\n'));
-        // Texture definitions
-        this.addTextFile(`${rpPath}/textures/item_texture.json`, JSON.stringify({
-            resource_pack_name: this.projectName,
-            texture_name: 'atlas.items',
-            texture_data: {},
-        }, null, 2));
-        this.addTextFile(`${rpPath}/textures/terrain_texture.json`, JSON.stringify({
-            resource_pack_name: this.projectName,
-            texture_name: 'atlas.terrain',
-            padding: 8,
-            num_mip_levels: 4,
-            texture_data: {},
-        }, null, 2));
-        // Sound definitions
-        this.addTextFile(`${rpPath}/sounds/sound_definitions.json`, JSON.stringify({
-            format_version: '1.14.0',
-            sound_definitions: {},
-        }, null, 2));
-        // Entity render controllers
-        this.addTextFile(`${rpPath}/render_controllers/default.render_controllers.json`, JSON.stringify({
-            format_version: '1.10.0',
-            render_controllers: {
-                [`controller.render.${this.namespace}`]: {
-                    geometry: 'Geometry.default',
-                    materials: [{ '*': 'Material.default' }],
-                    textures: ['Texture.default'],
-                },
-            },
-        }, null, 2));
+    if (platformOpts.experimentalGameplay) {
+      manifest.capabilities = ["script_eval"];
     }
-    /* ── Behavior Pack ──────────────────────────────────────────── */
-    async generateBehaviorPack(project, options, minEngineVersion, packVersion) {
-        const bpPath = `${this.projectName}_BP`;
-        const platformOpts = options.platformOptions ?? {};
-        const modules = [
-            {
-                type: 'data',
-                uuid: generateUUID(),
-                version: packVersion,
-            },
-        ];
-        // Add script module if scripts enabled
-        if (platformOpts.generateScripts !== false) {
-            modules.push({
-                type: 'script',
-                uuid: generateUUID(),
-                version: packVersion,
-                entry: 'scripts/main.js',
-                language: 'javascript',
-            });
-        }
-        // Manifest
-        const manifest = {
-            format_version: 2,
-            header: {
-                name: `${project.name} Behavior Pack`,
-                description: `Behavior pack generated from Nice2Dev project v${project.version}`,
-                uuid: this.behaviorPackUUID,
-                version: packVersion,
-                min_engine_version: minEngineVersion,
-            },
-            modules,
-            dependencies: [
-                {
-                    uuid: this.resourcePackUUID,
-                    version: packVersion,
-                },
-            ],
-        };
-        // Add script dependencies
-        if (platformOpts.generateScripts !== false) {
-            manifest.dependencies.push({
-                uuid: 'b26a4d4c-afdf-4690-88f8-931846312678', // @minecraft/server
-                version: [1, 7, 0],
-            });
-        }
-        if (platformOpts.experimentalGameplay) {
-            manifest.capabilities = ['script_eval'];
+    this.addTextFile(`${bpPath}/manifest.json`, JSON.stringify(manifest, null, 2));
+    this.addTextFile(
+      `${bpPath}/pack_icon.png.txt`,
+      "<!-- Replace this file with a 256x256 PNG named pack_icon.png -->"
+    );
+    this.addTextFile(
+      `${bpPath}/texts/en_US.lang`,
+      `pack.name=${project.name} Behavior Pack
+pack.description=Behavior pack from Nice2Dev project`
+    );
+  }
+  /* ── Scripts ────────────────────────────────────────────────── */
+  async generateScripts(project, _options) {
+    const bpPath = `${this.projectName}_BP`;
+    const mainScript = `// ${project.name} - Nice2Dev Minecraft Bedrock Export
+// Main script entry point
+
+import { world, system } from '@minecraft/server';
+
+// Game state
+const gameState = {
+    isPaused: false,
+    entities: new Map(),
+    globalVariables: new Map(),
+};
+
+// Settings from Nice2Dev project
+const GameSettings = {
+    width: ${project.settings.resolution.width},
+    height: ${project.settings.resolution.height},
+    masterVolume: ${project.settings.audio.masterVolume},
+    gravity: { x: ${project.settings.physics.gravity.x}, y: ${project.settings.physics.gravity.y} },
+};
+
+// Initialization
+world.afterEvents.worldInitialize.subscribe(() => {
+    console.log('[${project.name}] World initialized');
+});
+
+// Player join
+world.afterEvents.playerSpawn.subscribe((event) => {
+    if (event.initialSpawn) {
+        const player = event.player;
+        console.log(\`[${project.name}] Player \${player.name} joined\`);
+        
+        // Welcome message
+        player.sendMessage('§a§l[${project.name}]§r Welcome to the game!');
+    }
+});
+
+// Main game loop (runs every tick)
+system.runInterval(() => {
+    if (gameState.isPaused) return;
+    
+    // Update all registered entities
+    for (const [id, entity] of gameState.entities) {
+        if (entity.update) {
+            entity.update();
         }
-        this.addTextFile(`${bpPath}/manifest.json`, JSON.stringify(manifest, null, 2));
-        // Pack icon placeholder
-        this.addTextFile(`${bpPath}/pack_icon.png.txt`, '<!-- Replace this file with a 256x256 PNG named pack_icon.png -->');
-        // Texts for localization
-        this.addTextFile(`${bpPath}/texts/en_US.lang`, `pack.name=${project.name} Behavior Pack\npack.description=Behavior pack from Nice2Dev project`);
     }
-    /* ── Scripts ────────────────────────────────────────────────── */
-    async generateScripts(project, _options) {
-        const bpPath = `${this.projectName}_BP`;
-        // Main entry script
-        const mainScript = `// ${project.name} - Nice2Dev Minecraft Bedrock Export
-// Main script entry point
-
-import { world, system } from '@minecraft/server';
-
-// Game state
-const gameState = {
-    isPaused: false,
-    entities: new Map(),
-    globalVariables: new Map(),
-};
-
-// Settings from Nice2Dev project
-const GameSettings = {
-    width: ${project.settings.resolution.width},
-    height: ${project.settings.resolution.height},
-    masterVolume: ${project.settings.audio.masterVolume},
-    gravity: { x: ${project.settings.physics.gravity.x}, y: ${project.settings.physics.gravity.y} },
-};
-
-// Initialization
-world.afterEvents.worldInitialize.subscribe(() => {
-    console.log('[${project.name}] World initialized');
-});
-
-// Player join
-world.afterEvents.playerSpawn.subscribe((event) => {
-    if (event.initialSpawn) {
-        const player = event.player;
-        console.log(\`[${project.name}] Player \${player.name} joined\`);
-        
-        // Welcome message
-        player.sendMessage('§a§l[${project.name}]§r Welcome to the game!');
-    }
-});
-
-// Main game loop (runs every tick)
-system.runInterval(() => {
-    if (gameState.isPaused) return;
-    
-    // Update all registered entities
-    for (const [id, entity] of gameState.entities) {
-        if (entity.update) {
-            entity.update();
-        }
-    }
-}, 1);
-
-// Utility functions
-export function registerEntity(id, entity) {
-    gameState.entities.set(id, entity);
-}
-
-export function unregisterEntity(id) {
-    gameState.entities.delete(id);
-}
-
-export function setGlobalVariable(key, value) {
-    gameState.globalVariables.set(key, value);
-}
-
-export function getGlobalVariable(key) {
-    return gameState.globalVariables.get(key);
-}
-
-export function pauseGame() {
-    gameState.isPaused = true;
-}
-
-export function resumeGame() {
-    gameState.isPaused = false;
-}
-
-console.log('[${project.name}] Scripts loaded');
-`;
-        this.addTextFile(`${bpPath}/scripts/main.js`, mainScript);
-        // Entity manager module
-        const entityManager = `// Entity Manager Module
-// Handles custom entity logic and lifecycle
-
-import { world, system } from '@minecraft/server';
-
-export class EntityManager {
-    constructor() {
-        this.customEntities = new Map();
-        this.setupEventListeners();
-    }
-    
-    setupEventListeners() {
-        // Handle entity spawn
-        world.afterEvents.entitySpawn.subscribe((event) => {
-            const entity = event.entity;
-            const typeId = entity.typeId;
-            
-            if (typeId.startsWith('${this.namespace}:')) {
-                this.onCustomEntitySpawn(entity);
-            }
-        });
-        
-        // Handle entity removed
-        world.afterEvents.entityRemove.subscribe((event) => {
-            const typeId = event.typeId;
-            
-            if (typeId.startsWith('${this.namespace}:')) {
-                this.onCustomEntityRemoved(event.removedEntityId);
-            }
-        });
-    }
-    
-    onCustomEntitySpawn(entity) {
-        const id = entity.id;
-        console.log(\`[EntityManager] Custom entity spawned: \${entity.typeId} (ID: \${id})\`);
-        
-        this.customEntities.set(id, {
-            entity: entity,
-            typeId: entity.typeId,
-            customData: {},
-        });
-    }
-    
-    onCustomEntityRemoved(entityId) {
-        console.log(\`[EntityManager] Custom entity removed: \${entityId}\`);
-        this.customEntities.delete(entityId);
-    }
-    
-    getCustomEntity(entityId) {
-        return this.customEntities.get(entityId);
-    }
-    
-    getAllCustomEntities() {
-        return Array.from(this.customEntities.values());
-    }
-}
-
-export const entityManager = new EntityManager();
+}, 1);
+
+// Utility functions
+export function registerEntity(id, entity) {
+    gameState.entities.set(id, entity);
+}
+
+export function unregisterEntity(id) {
+    gameState.entities.delete(id);
+}
+
+export function setGlobalVariable(key, value) {
+    gameState.globalVariables.set(key, value);
+}
+
+export function getGlobalVariable(key) {
+    return gameState.globalVariables.get(key);
+}
+
+export function pauseGame() {
+    gameState.isPaused = true;
+}
+
+export function resumeGame() {
+    gameState.isPaused = false;
+}
+
+console.log('[${project.name}] Scripts loaded');
 `;
-        this.addTextFile(`${bpPath}/scripts/entityManager.js`, entityManager);
-        // Utilities module
-        const utilities = `// Utility Functions Module
-
-import { world, system } from '@minecraft/server';
-
-// Math utilities
-export function lerp(a, b, t) {
-    return a + (b - a) * Math.max(0, Math.min(1, t));
-}
-
-export function distance3D(pos1, pos2) {
-    const dx = pos2.x - pos1.x;
-    const dy = pos2.y - pos1.y;
-    const dz = pos2.z - pos1.z;
-    return Math.sqrt(dx * dx + dy * dy + dz * dz);
-}
-
-export function randomRange(min, max) {
-    return Math.random() * (max - min) + min;
-}
-
-// Entity utilities
-export function findNearbyEntities(location, dimension, radius, typeFilter) {
-    const entities = dimension.getEntities({
-        location: location,
-        maxDistance: radius,
-        type: typeFilter,
-    });
-    return entities;
-}
-
-export function findNearestPlayer(location, dimension, maxDistance = 64) {
-    const players = dimension.getPlayers({
-        location: location,
-        maxDistance: maxDistance,
-    });
-    
-    if (players.length === 0) return null;
-    
-    let nearest = players[0];
-    let nearestDist = distance3D(location, nearest.location);
-    
-    for (const player of players) {
-        const dist = distance3D(location, player.location);
-        if (dist < nearestDist) {
-            nearest = player;
-            nearestDist = dist;
-        }
-    }
-    
-    return nearest;
-}
-
-// Timer utilities
-export function setTimeout(callback, ticks) {
-    return system.runTimeout(callback, ticks);
-}
-
-export function setInterval(callback, ticks) {
-    return system.runInterval(callback, ticks);
-}
-
-export function clearTimeout(id) {
-    system.clearRun(id);
-}
-
-export function clearInterval(id) {
-    system.clearRun(id);
-}
-
-// Block utilities
-export function getBlockAt(dimension, x, y, z) {
-    return dimension.getBlock({ x, y, z });
-}
-
-export function setBlockAt(dimension, x, y, z, blockType) {
-    const block = dimension.getBlock({ x, y, z });
-    if (block) {
-        block.setType(blockType);
-    }
-}
-
-// Particle utilities
-export function spawnParticle(dimension, particleType, location) {
-    dimension.spawnParticle(particleType, location);
-}
-
-// Sound utilities
-export function playSound(dimension, soundId, location, options = {}) {
-    const settings = {
-        volume: options.volume ?? 1.0,
-        pitch: options.pitch ?? 1.0,
-    };
-    dimension.playSound(soundId, location, settings);
-}
+    this.addTextFile(`${bpPath}/scripts/main.js`, mainScript);
+    const entityManager = `// Entity Manager Module
+// Handles custom entity logic and lifecycle
+
+import { world, system } from '@minecraft/server';
+
+export class EntityManager {
+    constructor() {
+        this.customEntities = new Map();
+        this.setupEventListeners();
+    }
+    
+    setupEventListeners() {
+        // Handle entity spawn
+        world.afterEvents.entitySpawn.subscribe((event) => {
+            const entity = event.entity;
+            const typeId = entity.typeId;
+            
+            if (typeId.startsWith('${this.namespace}:')) {
+                this.onCustomEntitySpawn(entity);
+            }
+        });
+        
+        // Handle entity removed
+        world.afterEvents.entityRemove.subscribe((event) => {
+            const typeId = event.typeId;
+            
+            if (typeId.startsWith('${this.namespace}:')) {
+                this.onCustomEntityRemoved(event.removedEntityId);
+            }
+        });
+    }
+    
+    onCustomEntitySpawn(entity) {
+        const id = entity.id;
+        console.log(\`[EntityManager] Custom entity spawned: \${entity.typeId} (ID: \${id})\`);
+        
+        this.customEntities.set(id, {
+            entity: entity,
+            typeId: entity.typeId,
+            customData: {},
+        });
+    }
+    
+    onCustomEntityRemoved(entityId) {
+        console.log(\`[EntityManager] Custom entity removed: \${entityId}\`);
+        this.customEntities.delete(entityId);
+    }
+    
+    getCustomEntity(entityId) {
+        return this.customEntities.get(entityId);
+    }
+    
+    getAllCustomEntities() {
+        return Array.from(this.customEntities.values());
+    }
+}
+
+export const entityManager = new EntityManager();
 `;
-        this.addTextFile(`${bpPath}/scripts/utilities.js`, utilities);
+    this.addTextFile(`${bpPath}/scripts/entityManager.js`, entityManager);
+    const utilities = `// Utility Functions Module
+
+import { world, system } from '@minecraft/server';
+
+// Math utilities
+export function lerp(a, b, t) {
+    return a + (b - a) * Math.max(0, Math.min(1, t));
+}
+
+export function distance3D(pos1, pos2) {
+    const dx = pos2.x - pos1.x;
+    const dy = pos2.y - pos1.y;
+    const dz = pos2.z - pos1.z;
+    return Math.sqrt(dx * dx + dy * dy + dz * dz);
+}
+
+export function randomRange(min, max) {
+    return Math.random() * (max - min) + min;
+}
+
+// Entity utilities
+export function findNearbyEntities(location, dimension, radius, typeFilter) {
+    const entities = dimension.getEntities({
+        location: location,
+        maxDistance: radius,
+        type: typeFilter,
+    });
+    return entities;
+}
+
+export function findNearestPlayer(location, dimension, maxDistance = 64) {
+    const players = dimension.getPlayers({
+        location: location,
+        maxDistance: maxDistance,
+    });
+    
+    if (players.length === 0) return null;
+    
+    let nearest = players[0];
+    let nearestDist = distance3D(location, nearest.location);
+    
+    for (const player of players) {
+        const dist = distance3D(location, player.location);
+        if (dist < nearestDist) {
+            nearest = player;
+            nearestDist = dist;
+        }
     }
-    /* ── Prefab Export (Custom Entity) ──────────────────────────── */
-    async exportPrefab(prefab, _options) {
-        const bpPath = `${this.projectName}_BP`;
-        const rpPath = `${this.projectName}_RP`;
-        const entityId = `${this.namespace}:${prefab.name.toLowerCase().replace(/[^a-z0-9_]/g, '_')}`;
-        const safeName = prefab.name.toLowerCase().replace(/[^a-z0-9_]/g, '_');
-        // Server-side entity definition
-        const serverEntity = {
-            format_version: '1.18.0',
-            'minecraft:entity': {
-                description: {
-                    identifier: entityId,
-                    is_spawnable: true,
-                    is_summonable: true,
-                    is_experimental: false,
-                },
-                components: {
-                    'minecraft:type_family': {
-                        family: [this.namespace, 'custom'],
-                    },
-                    'minecraft:nameable': {
-                        default_trigger: {
-                            event: 'named',
-                        },
-                    },
-                },
-            },
-        };
-        // Map components to Minecraft component format
-        const components = serverEntity['minecraft:entity'].components;
-        for (const comp of prefab.entity.components) {
-            const mapper = MINECRAFT_COMPONENT_MAP[comp.type];
-            if (mapper) {
-                Object.assign(components, mapper(comp));
+    
+    return nearest;
+}
+
+// Timer utilities
+export function setTimeout(callback, ticks) {
+    return system.runTimeout(callback, ticks);
+}
+
+export function setInterval(callback, ticks) {
+    return system.runInterval(callback, ticks);
+}
+
+export function clearTimeout(id) {
+    system.clearRun(id);
+}
+
+export function clearInterval(id) {
+    system.clearRun(id);
+}
+
+// Block utilities
+export function getBlockAt(dimension, x, y, z) {
+    return dimension.getBlock({ x, y, z });
+}
+
+export function setBlockAt(dimension, x, y, z, blockType) {
+    const block = dimension.getBlock({ x, y, z });
+    if (block) {
+        block.setType(blockType);
+    }
+}
+
+// Particle utilities
+export function spawnParticle(dimension, particleType, location) {
+    dimension.spawnParticle(particleType, location);
+}
+
+// Sound utilities
+export function playSound(dimension, soundId, location, options = {}) {
+    const settings = {
+        volume: options.volume ?? 1.0,
+        pitch: options.pitch ?? 1.0,
+    };
+    dimension.playSound(soundId, location, settings);
+}
+`;
+    this.addTextFile(`${bpPath}/scripts/utilities.js`, utilities);
+  }
+  /* ── Prefab Export (Custom Entity) ──────────────────────────── */
+  async exportPrefab(prefab, _options) {
+    const bpPath = `${this.projectName}_BP`;
+    const rpPath = `${this.projectName}_RP`;
+    const entityId = `${this.namespace}:${prefab.name.toLowerCase().replace(/[^a-z0-9_]/g, "_")}`;
+    const safeName = prefab.name.toLowerCase().replace(/[^a-z0-9_]/g, "_");
+    const serverEntity = {
+      format_version: "1.18.0",
+      "minecraft:entity": {
+        description: {
+          identifier: entityId,
+          is_spawnable: true,
+          is_summonable: true,
+          is_experimental: false
+        },
+        components: {
+          "minecraft:type_family": {
+            family: [this.namespace, "custom"]
+          },
+          "minecraft:nameable": {
+            default_trigger: {
+              event: "named"
             }
+          }
         }
-        // Add scale component for entity size
-        const scale = prefab.entity.scale ?? { x: 1, y: 1 };
-        components['minecraft:scale'] = { value: Math.max(scale.x, scale.y) };
-        this.addTextFile(`${bpPath}/entities/${safeName}.json`, JSON.stringify(serverEntity, null, 2));
-        // Client-side entity definition
-        const clientEntity = {
-            format_version: '1.10.0',
-            'minecraft:client_entity': {
-                description: {
-                    identifier: entityId,
-                    materials: { default: 'entity_alphatest' },
-                    textures: { default: `textures/entity/${safeName}` },
-                    geometry: { default: `geometry.${safeName}` },
-                    render_controllers: [`controller.render.${this.namespace}`],
-                    spawn_egg: {
-                        base_color: '#3C5D99',
-                        overlay_color: '#7FB8B5',
-                    },
-                },
-            },
-        };
-        this.addTextFile(`${rpPath}/entity/${safeName}.entity.json`, JSON.stringify(clientEntity, null, 2));
-        // Generate basic geometry
-        const geometry = {
-            format_version: '1.12.0',
-            'minecraft:geometry': [
-                {
-                    description: {
-                        identifier: `geometry.${safeName}`,
-                        texture_width: 64,
-                        texture_height: 64,
-                        visible_bounds_width: 2,
-                        visible_bounds_height: 2,
-                        visible_bounds_offset: [0, 1, 0],
-                    },
-                    bones: [
-                        {
-                            name: 'body',
-                            pivot: [0, 0, 0],
-                            cubes: [
-                                {
-                                    origin: [-8, 0, -8],
-                                    size: [16, 16, 16],
-                                    uv: [0, 0],
-                                },
-                            ],
-                        },
-                    ],
-                },
-            ],
-        };
-        this.addTextFile(`${rpPath}/models/entity/${safeName}.geo.json`, JSON.stringify(geometry, null, 2));
-        // Add to spawn rules
-        const spawnRules = {
-            format_version: '1.8.0',
-            'minecraft:spawn_rules': {
-                description: {
-                    identifier: entityId,
-                    population_control: 'monster',
-                },
-                conditions: [
-                    {
-                        'minecraft:spawns_on_surface': {},
-                    },
-                ],
-            },
-        };
-        this.addTextFile(`${bpPath}/spawn_rules/${safeName}.json`, JSON.stringify(spawnRules, null, 2));
+      }
+    };
+    const components = serverEntity["minecraft:entity"].components;
+    for (const comp of prefab.entity.components) {
+      const mapper = MINECRAFT_COMPONENT_MAP[comp.type];
+      if (mapper) {
+        Object.assign(components, mapper(comp));
+      }
     }
-    /* ── Scene Export ───────────────────────────────────────────── */
-    async exportScene(scene, _project, _options) {
-        const bpPath = `${this.projectName}_BP`;
-        const safeName = scene.name.toLowerCase().replace(/[^a-z0-9_]/g, '_');
-        // Export scene as a function that sets up entities
-        const setupFunction = `# Scene Setup: ${scene.name}
-# Generated from Nice2Dev scene
-# Run this function to spawn scene entities
-
-${scene.entities
-            .map((entity, _index) => {
-            const pos = entity.position ?? { x: 0, y: 0 };
-            const entityId = `${this.namespace}:${(entity.name ?? entity.id).toLowerCase().replace(/[^a-z0-9_]/g, '_')}`;
-            return `# Entity: ${entity.name ?? entity.id}
+    const scale = prefab.entity.scale ?? { x: 1, y: 1 };
+    components["minecraft:scale"] = { value: Math.max(scale.x, scale.y) };
+    this.addTextFile(`${bpPath}/entities/${safeName}.json`, JSON.stringify(serverEntity, null, 2));
+    const clientEntity = {
+      format_version: "1.10.0",
+      "minecraft:client_entity": {
+        description: {
+          identifier: entityId,
+          materials: { default: "entity_alphatest" },
+          textures: { default: `textures/entity/${safeName}` },
+          geometry: { default: `geometry.${safeName}` },
+          render_controllers: [`controller.render.${this.namespace}`],
+          spawn_egg: {
+            base_color: "#3C5D99",
+            overlay_color: "#7FB8B5"
+          }
+        }
+      }
+    };
+    this.addTextFile(
+      `${rpPath}/entity/${safeName}.entity.json`,
+      JSON.stringify(clientEntity, null, 2)
+    );
+    const geometry = {
+      format_version: "1.12.0",
+      "minecraft:geometry": [
+        {
+          description: {
+            identifier: `geometry.${safeName}`,
+            texture_width: 64,
+            texture_height: 64,
+            visible_bounds_width: 2,
+            visible_bounds_height: 2,
+            visible_bounds_offset: [0, 1, 0]
+          },
+          bones: [
+            {
+              name: "body",
+              pivot: [0, 0, 0],
+              cubes: [
+                {
+                  origin: [-8, 0, -8],
+                  size: [16, 16, 16],
+                  uv: [0, 0]
+                }
+              ]
+            }
+          ]
+        }
+      ]
+    };
+    this.addTextFile(
+      `${rpPath}/models/entity/${safeName}.geo.json`,
+      JSON.stringify(geometry, null, 2)
+    );
+    const spawnRules = {
+      format_version: "1.8.0",
+      "minecraft:spawn_rules": {
+        description: {
+          identifier: entityId,
+          population_control: "monster"
+        },
+        conditions: [
+          {
+            "minecraft:spawns_on_surface": {}
+          }
+        ]
+      }
+    };
+    this.addTextFile(`${bpPath}/spawn_rules/${safeName}.json`, JSON.stringify(spawnRules, null, 2));
+  }
+  /* ── Scene Export ───────────────────────────────────────────── */
+  async exportScene(scene, _project, _options) {
+    const bpPath = `${this.projectName}_BP`;
+    const safeName = scene.name.toLowerCase().replace(/[^a-z0-9_]/g, "_");
+    const setupFunction = `# Scene Setup: ${scene.name}
+# Generated from Nice2Dev scene
+# Run this function to spawn scene entities
+
+${scene.entities.map((entity, _index) => {
+      const pos = entity.position ?? { x: 0, y: 0 };
+      const entityId = `${this.namespace}:${(entity.name ?? entity.id).toLowerCase().replace(/[^a-z0-9_]/g, "_")}`;
+      return `# Entity: ${entity.name ?? entity.id}
 summon ${entityId} ~${Math.floor(pos.x / 16)} ~0 ~${Math.floor(pos.y / 16)}`;
-        })
-            .join('\n\n')}
+    }).join("\n\n")}
 `;
-        this.addTextFile(`${bpPath}/functions/scenes/${safeName}_setup.mcfunction`, setupFunction);
-        // Cleanup function
-        const cleanupFunction = `# Scene Cleanup: ${scene.name}
-# Removes all entities from this scene
-
-${scene.entities
-            .map((entity) => {
-            const entityId = `${this.namespace}:${(entity.name ?? entity.id).toLowerCase().replace(/[^a-z0-9_]/g, '_')}`;
-            return `kill @e[type=${entityId}]`;
-        })
-            .join('\n')}
+    this.addTextFile(`${bpPath}/functions/scenes/${safeName}_setup.mcfunction`, setupFunction);
+    const cleanupFunction = `# Scene Cleanup: ${scene.name}
+# Removes all entities from this scene
+
+${scene.entities.map((entity) => {
+      const entityId = `${this.namespace}:${(entity.name ?? entity.id).toLowerCase().replace(/[^a-z0-9_]/g, "_")}`;
+      return `kill @e[type=${entityId}]`;
+    }).join("\n")}
 `;
-        this.addTextFile(`${bpPath}/functions/scenes/${safeName}_cleanup.mcfunction`, cleanupFunction);
-        // Generate tick.json for auto-registered functions
-        const tickJson = {
-            values: [],
-        };
-        this.addTextFile(`${bpPath}/functions/tick.json`, JSON.stringify(tickJson, null, 2));
-    }
+    this.addTextFile(`${bpPath}/functions/scenes/${safeName}_cleanup.mcfunction`, cleanupFunction);
+    const tickJson = {
+      values: []
+    };
+    this.addTextFile(`${bpPath}/functions/tick.json`, JSON.stringify(tickJson, null, 2));
+  }
 }
-/* ── Factory ──────────────────────────────────────────────────── */
 function createMinecraftBedrockExporter() {
-    return new MinecraftBedrockExporter();
+  return new MinecraftBedrockExporter();
 }
-
 exports.MinecraftBedrockExporter = MinecraftBedrockExporter;
 exports.createMinecraftBedrockExporter = createMinecraftBedrockExporter;