@block_factory/lib 0.0.4 → 0.0.5

package/_module/BlockFactory.ts

@@ -1,3 +1,5 @@
+export { _INITIALIZE_BF_FRAMEWORK_ } from "@block_factory/lib/_module/Framework/_INIT";
+
 export { MathUtils } from "./util/Math";
 export { Signal } from "./util/Signal";
 export { Vec2, Vec3 } from "./util/Vector";
@@ -15,4 +17,6 @@ export { Inventory, ContainerWrapper } from "./util/Wrapper/Container";
 export { type IEntity, IEntityWrapper } from "./util/Wrapper/IEntity";
 export { type IPlayer, IPlayerWrapper } from "./util/Wrapper/IPlayer";
 
-export { _THREAD_ } from "./sys/Threads";
+export { type Sound, type Animation } from "./Types";
+export { _THREAD_ } from "@block_factory/lib/_module/Framework/Threads";
+export { _EntityHandler_,  type EntityEmissionEvent, onEntityEmission } from "@block_factory/lib/_module/Framework/EntityTasks";

package/_module/Framework/EntityTasks.ts

@@ -0,0 +1,203 @@
+import {
+    Entity,
+    system,
+    ScriptEventCommandMessageAfterEvent,
+    ScriptEventCommandMessageAfterEventSignal,
+    world,
+    WorldLoadAfterEventSignal,
+    WorldLoadAfterEvent,
+    EntitySpawnAfterEventSignal,
+    EntityRemoveAfterEventSignal,
+    EntitySpawnAfterEvent,
+    EntityRemoveAfterEvent,
+    EntityRemoveBeforeEvent,
+    EntityRemoveBeforeEventSignal,
+} from "@minecraft/server";
+
+import { Signal } from "../util/Signal";
+import { IEntityWrapper, IEntity } from "../util/Wrapper/IEntity";
+
+/* -------------------------------------------------------------------------- */
+/* Public API                                                                 */
+/* -------------------------------------------------------------------------- */
+
+export type EntityEmissionEvent = {
+    iEntity: IEntity;
+    parms: any;
+};
+
+export const onEntityEmission = new Signal<EntityEmissionEvent>();
+
+/* -------------------------------------------------------------------------- */
+/* Singleton                                                                  */
+/* -------------------------------------------------------------------------- */
+
+
+
+class EntityHandler {
+    private PACK_ID: string | undefined;
+    private GLOBAL_MEMORY_ID = "GLB_MEM.ENTITY";
+
+    private readonly scriptEventSignal: ScriptEventCommandMessageAfterEventSignal = system.afterEvents.scriptEventReceive;
+    private readonly loadEventSignal: WorldLoadAfterEventSignal = world.afterEvents.worldLoad;
+    private readonly spawnEventSignal: EntitySpawnAfterEventSignal = world.afterEvents.entitySpawn;
+    private readonly removeAfterEventSignal: EntityRemoveAfterEventSignal = world.afterEvents.entityRemove;
+    private readonly removeBeforeEventSignal: EntityRemoveBeforeEventSignal = world.beforeEvents.entityRemove;
+
+    private readonly EM_INDEX = new Map<string, Entity>();
+    private readonly EM_KEYS: string[] = [];
+    private readonly SEARCH_TYPES = new Set<string>();
+
+    private _started = false;
+    private _wired = false;
+
+    public configure(): void {
+        if (this._started) throw new Error("BFLIB: EntityHandler already started;");
+    }
+
+    public registerEntity(typeId: string | string[]): void {
+        if (Array.isArray(typeId)) typeId.forEach((t) => this.SEARCH_TYPES.add(t));
+        else this.SEARCH_TYPES.add(typeId);
+    }
+
+    public start(packId: string): void {
+        if (this._started) return;
+        this._started = true;
+        this.PACK_ID = packId;
+
+        this.loadEventSignal.subscribe(this.onWorldLoad);
+    }
+
+    public stop(): void {
+        if (!this._started) return;
+
+        this.loadEventSignal.unsubscribe(this.onWorldLoad);
+        if (this._wired) {
+            this.scriptEventSignal.unsubscribe(this.processScriptEvents);
+            this.spawnEventSignal.unsubscribe(this.onEntitySpawned);
+            this.removeBeforeEventSignal.unsubscribe(this.onEntityRemovedBefore);
+            this.removeAfterEventSignal.unsubscribe(this.onEntityRemovedAfter);
+            this._wired = false;
+        }
+
+        this._started = false;
+    }
+
+    /* ------------------------------------------------------------------------ */
+    /* Event Wiring                                                             */
+    /* ------------------------------------------------------------------------ */
+
+    private onWorldLoad = (_event: WorldLoadAfterEvent): void => {
+
+        this.scriptEventSignal.subscribe(this.processScriptEvents);
+
+        if (this.SEARCH_TYPES.size > 0) {
+            this.spawnEventSignal.subscribe(this.onEntitySpawned);
+            this.removeBeforeEventSignal.subscribe(this.onEntityRemovedBefore);
+            this.removeAfterEventSignal.subscribe(this.onEntityRemovedAfter);
+        }
+
+        this._wired = true;
+        this.reloadEntityMemory();
+        this.loadEventSignal.unsubscribe(this.onWorldLoad);
+    };
+
+    private processScriptEvents = (event: ScriptEventCommandMessageAfterEvent): void => {
+        if (!event.sourceEntity) return;
+        if (event.id !== `${this.PACK_ID}:entity_emitter`) return;
+
+        let parms: any;
+        try {
+            parms = JSON.parse(event.message);
+        } catch (e) {
+            console.error(`BFLIB: entity_emitter JSON parse failed:`, e);
+            return;
+        }
+
+        onEntityEmission.emit({
+            iEntity: IEntityWrapper.wrap(event.sourceEntity),
+            parms,
+        });
+    };
+
+    /* ------------------------------------------------------------------------ */
+    /* Filters                                                                  */
+    /* ------------------------------------------------------------------------ */
+
+    private isValidType(typeId: string): boolean {
+        return this.SEARCH_TYPES.has(typeId);
+    }
+
+    private onEntitySpawned = (event: EntitySpawnAfterEvent): void => {
+        const entity = event.entity;
+        if (!this.isValidType(entity.typeId)) return;
+        this.saveEntityInMemory(entity);
+    };
+
+    private onEntityRemovedBefore = (event: EntityRemoveBeforeEvent): void => {
+        const entity = event.removedEntity;
+        if (!this.isValidType(entity.typeId)) return;
+        this.deleteEntityInMemory(entity);
+    };
+
+    private onEntityRemovedAfter = (_event: EntityRemoveAfterEvent): void => {
+        // 
+    };
+
+    /* ------------------------------------------------------------------------ */
+    /* Persistence                                                              */
+    /* ------------------------------------------------------------------------ */
+
+    private reloadEntityMemory(): void {
+        this.EM_INDEX.clear();
+        this.EM_KEYS.length = 0;
+
+        const raw = world.getDynamicProperty(this.GLOBAL_MEMORY_ID) as string | undefined;
+        if (!raw) return;
+
+        let parsed: string[];
+        try {
+            parsed = JSON.parse(raw) as string[];
+        } catch (e) {
+            console.error(`BFLIB: Failed to parse ${this.GLOBAL_MEMORY_ID}:`, e);
+            return;
+        }
+
+        for (const id of parsed) {
+            this.EM_KEYS.push(id);
+            const entity = world.getEntity(id);
+            if (entity) this.EM_INDEX.set(entity.id, entity);
+        }
+    }
+
+    private persistKeys(): void {
+        world.setDynamicProperty(this.GLOBAL_MEMORY_ID, JSON.stringify(this.EM_KEYS));
+    }
+
+    public saveEntityInMemory(entity: Entity): boolean {
+        if (this.EM_INDEX.has(entity.id)) return false;
+        this.EM_KEYS.push(entity.id);
+        this.EM_INDEX.set(entity.id, entity);
+        this.persistKeys();
+
+        return true;
+    }
+
+    public deleteEntityInMemory(entity: Entity): boolean {
+        const existed = this.EM_INDEX.delete(entity.id);
+        if (!existed) return false;
+
+        const idx = this.EM_KEYS.indexOf(entity.id);
+        if (idx !== -1) this.EM_KEYS.splice(idx, 1);
+
+        this.persistKeys();
+
+        return true;
+    }
+
+    public getEntitiesInMemory(): Entity[] {
+        return Array.from(this.EM_INDEX.values());
+    }
+}
+
+export const _EntityHandler_ = new EntityHandler();

package/_module/Framework/Threads.ts

@@ -0,0 +1,72 @@
+import { system, TicksPerSecond } from "@minecraft/server";
+import { Signal } from "../util/Signal";
+
+export type ThreadConfig = {
+    mainRate?: number; // interval ticks
+    lateRate?: number; // interval ticks
+};
+
+class Threads {
+    public readonly MAIN = new Signal<number>();
+    public readonly LATE = new Signal<void>();
+
+    private _mainRate = 0;
+    private _lateRate = TicksPerSecond;
+
+    private _MAIN_ID: number | undefined;
+    private _LATE_ID: number | undefined;
+
+    private _delta = this.createDeltaTimer();
+    private _started = false;
+
+    public configure(cfg: ThreadConfig) {
+        if (this._started) throw new Error("BFLIB: _THREAD_ already started; configure before start().");
+        if (cfg.mainRate !== undefined) this._mainRate = cfg.mainRate;
+        if (cfg.lateRate !== undefined) this._lateRate = cfg.lateRate;
+    }
+
+    public start() {
+        if (this._started) return; // idempotent
+        this._started = true;
+
+        this._MAIN_ID = system.runInterval(() => {
+            if (this.MAIN.count <= 0) return;
+            try {
+                const delta = this._delta();
+                this.MAIN.emit(delta);
+            } catch (e) {
+                console.error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} |`, e);
+            }
+        }, this._mainRate);
+
+        this._LATE_ID = system.runInterval(() => {
+            if (this.LATE.count <= 0) return;
+            try {
+                this.LATE.emit();
+            } catch (e) {
+                console.error(`ERROR: _THREAD_.LATE:${this._LATE_ID} |`, e);
+            }
+        }, this._lateRate);
+    }
+
+    public stop() {
+        if (this._MAIN_ID !== undefined) system.clearRun(this._MAIN_ID);
+        if (this._LATE_ID !== undefined) system.clearRun(this._LATE_ID);
+        this._MAIN_ID = undefined;
+        this._LATE_ID = undefined;
+        this._started = false;
+        this._delta = this.createDeltaTimer(); // reset delta timing
+    }
+
+    private createDeltaTimer() {
+        let last = Date.now();
+        return () => {
+            const now = Date.now();
+            const delta = (now - last) / 1000;
+            last = now;
+            return delta;
+        };
+    }
+}
+
+export const _THREAD_ = new Threads();

package/_module/Framework/_INIT.ts

@@ -0,0 +1,39 @@
+let IS_INITIALIZED: boolean = false
+let PACK_ID: string | undefined = undefined
+
+/* -------------------------------------------------------------------------- */
+/* Public API                                                                 */
+/* -------------------------------------------------------------------------- */
+
+/**
+ * Initializes the Block Factory framework.
+ *
+ * This **must be called exactly once** before using any backend systems
+ * such as threads, entity tasks, or event routing.
+ *
+ * @param packId - Unique identifier for the active pack instance.
+ *
+ * @throws Error if the framework has already been initialized.
+ *
+ * @example
+ * ```ts
+ * _INITIALIZE_BF_FRAMEWORK_("bf:utility_tools");
+ * ```
+ */
+export function _INITIALIZE_BF_FRAMEWORK_(packId: string): void {
+    if (IS_INITIALIZED) throw Error(`CONFLICT WARNING: ${PACK_ID} already initialized.`);
+    PACK_ID = packId; IS_INITIALIZED = true;
+    console.log("Block Factory Framework Loaded");
+}
+
+/* -------------------------------------------------------------------------- */
+/* Internal API                                                               */
+/* -------------------------------------------------------------------------- */
+
+export function getPackId(): string | undefined {
+    return PACK_ID;
+}
+
+export function isInitalized(): boolean {
+    return IS_INITIALIZED;
+}

package/_module/Types.ts

@@ -0,0 +1,10 @@
+export type Sound = {
+    id: string,
+    length: number
+}
+
+export type Animation = {
+    id: string,
+    length: number,
+    loop?: boolean,
+}

package/_module/util/Signal.ts

@@ -24,8 +24,10 @@ export class Signal<T = void> {
     }
 
     public emit(data: T): void {
-        for (const cb of Array.from(this.listeners)) {
-            cb(data);
+        for (const callback of Array.from(this.listeners)) {
+            try { callback(data) } catch (err) {
+                console.error("BFLIB: Signal listener error:", err);
+            }
         }
     }
 }

package/_module/util/Wrapper/IEntity.ts

@@ -1,6 +1,7 @@
-import { Entity, EntityInventoryComponent } from "@minecraft/server";
+import { Entity, EntityInventoryComponent, PlayAnimationOptions, system, TicksPerSecond } from "@minecraft/server";
 import { ContainerWrapper, Inventory } from "./Container";
 import { System } from "../System";
+import { Animation } from "../../Types";
 
 export type IEntity = IEntityWrapper & Entity;
 
@@ -17,9 +18,8 @@ export class IEntityWrapper {
     }
 
     //======================== Interal ========================
-    public isAlive: boolean = false;
 
-    public get inventory(): Inventory {
+    public get inventory(): Inventory | undefined {
         const i = this.source.getComponent(
             EntityInventoryComponent.componentId
         ) as EntityInventoryComponent;
@@ -27,8 +27,9 @@ export class IEntityWrapper {
         return ContainerWrapper.wrap(i.container);
     }
 
-    public test(): void {
-        //this.source.sendMessage(`${this.source.name} was tested`);
+    public async playAnimationAsync(animation: Animation, options: PlayAnimationOptions): Promise<void> {
+        this.source.playAnimation(animation.id, options);
+        await system.waitTicks(animation.length * TicksPerSecond);
     }
 
 }

package/_module/util/Wrapper/IPlayer.ts

@@ -1,6 +1,7 @@
-import { EntityInventoryComponent, Player } from "@minecraft/server";
+import { EntityInventoryComponent, PlayAnimationOptions, Player, PlayerSoundOptions, system, TicksPerSecond } from "@minecraft/server";
 import { ContainerWrapper, Inventory } from "./Container";
 import { System } from "../System";
+import { Animation, Sound } from "../../Types";
 
 export type IPlayer = IPlayerWrapper & Player;
 
@@ -17,7 +18,6 @@ export class IPlayerWrapper {
     }
 
     //======================== Interal ========================
-    public isAlive: boolean = false;
 
     public get inventory(): Inventory {
         const i = this.source.getComponent(
@@ -27,8 +27,14 @@ export class IPlayerWrapper {
         return ContainerWrapper.wrap(i.container);
     }
 
-    public test(): void {
-        this.source.sendMessage(`${this.source.name} was tested`);
+    public async playSoundAsync(sound:Sound, options: PlayerSoundOptions): Promise<void>{
+        this.source.playSound(sound.id, options);
+        await system.waitTicks(sound.length * TicksPerSecond);
+    }
+
+    public async playAnimationAsync(animation: Animation, options: PlayAnimationOptions): Promise<void> {
+        this.source.playAnimation(animation.id, options);
+        await system.waitTicks(animation.length * TicksPerSecond);
     }
 
 }

package/_types/_module/BlockFactory.d.ts

@@ -1,3 +1,4 @@
+export { _INITIALIZE_BF_FRAMEWORK_ } from "@block_factory/lib/_module/Framework/_INIT";
 export { MathUtils } from "./util/Math";
 export { Signal } from "./util/Signal";
 export { Vec2, Vec3 } from "./util/Vector";
@@ -12,5 +13,7 @@ export { type IFormRegistration, RegisterForm } from "./util/Forms/FormRegistry"
 export { Inventory, ContainerWrapper } from "./util/Wrapper/Container";
 export { type IEntity, IEntityWrapper } from "./util/Wrapper/IEntity";
 export { type IPlayer, IPlayerWrapper } from "./util/Wrapper/IPlayer";
-export { _THREAD_ } from "./sys/Threads";
+export { type Sound, type Animation } from "./Types";
+export { _THREAD_ } from "@block_factory/lib/_module/Framework/Threads";
+export { _EntityHandler_, type EntityEmissionEvent, onEntityEmission } from "@block_factory/lib/_module/Framework/EntityTasks";
 //# sourceMappingURL=BlockFactory.d.ts.map

package/_types/_module/BlockFactory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"BlockFactory.d.ts","sourceRoot":"","sources":["../../_module/BlockFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9H,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/K,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,KAAK,iBAAiB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"BlockFactory.d.ts","sourceRoot":"","sources":["../../_module/BlockFactory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,4CAA4C,CAAC;AAEvF,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,OAAO,EAAE,MAAM,gBAAgB,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,mBAAmB,EAAE,KAAK,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC9H,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,gBAAgB,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,KAAK,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAC/K,OAAO,EAAE,KAAK,gBAAgB,EAAE,KAAK,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAC5F,OAAO,EAAE,KAAK,iBAAiB,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAEjF,OAAO,EAAE,SAAS,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AACvE,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EAAE,KAAK,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AAEtE,OAAO,EAAE,KAAK,KAAK,EAAE,KAAK,SAAS,EAAE,MAAM,SAAS,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,MAAM,8CAA8C,CAAC;AACxE,OAAO,EAAE,eAAe,EAAG,KAAK,mBAAmB,EAAE,gBAAgB,EAAE,MAAM,kDAAkD,CAAC"}

package/_types/_module/Framework/EntityTasks.d.ts

@@ -0,0 +1,40 @@
+import { Entity } from "@minecraft/server";
+import { Signal } from "../util/Signal";
+import { IEntity } from "../util/Wrapper/IEntity";
+export type EntityEmissionEvent = {
+    iEntity: IEntity;
+    parms: any;
+};
+export declare const onEntityEmission: Signal<EntityEmissionEvent>;
+declare class EntityHandler {
+    private PACK_ID;
+    private GLOBAL_MEMORY_ID;
+    private readonly scriptEventSignal;
+    private readonly loadEventSignal;
+    private readonly spawnEventSignal;
+    private readonly removeAfterEventSignal;
+    private readonly removeBeforeEventSignal;
+    private readonly EM_INDEX;
+    private readonly EM_KEYS;
+    private readonly SEARCH_TYPES;
+    private _started;
+    private _wired;
+    configure(): void;
+    registerEntity(typeId: string | string[]): void;
+    start(): void;
+    stop(): void;
+    private onWorldLoad;
+    private processScriptEvents;
+    private isValidType;
+    private onEntitySpawned;
+    private onEntityRemovedBefore;
+    private onEntityRemovedAfter;
+    private reloadEntityMemory;
+    private persistKeys;
+    saveEntityInMemory(entity: Entity): boolean;
+    deleteEntityInMemory(entity: Entity): boolean;
+    getEntitiesInMemory(): Entity[];
+}
+export declare const _EntityHandler_: EntityHandler;
+export {};
+//# sourceMappingURL=EntityTasks.d.ts.map

package/_types/_module/Framework/EntityTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EntityTasks.d.ts","sourceRoot":"","sources":["../../../_module/Framework/EntityTasks.ts"],"names":[],"mappings":"AAAA,OAAO,EACH,MAAM,EAaT,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAkB,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAOlE,MAAM,MAAM,mBAAmB,GAAG;IAC9B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,GAAG,CAAC;CACd,CAAC;AAEF,eAAO,MAAM,gBAAgB,6BAAoC,CAAC;AAQlE,cAAM,aAAa;IACf,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,gBAAgB,CAAoB;IAE5C,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAoF;IACtH,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA0D;IAC1F,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAA8D;IAC/F,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAgE;IACvG,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAkE;IAE1G,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAqB;IAElD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAAS;IAEhB,SAAS,IAAI,IAAI;IAIjB,cAAc,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAK/C,KAAK,IAAI,IAAI;IAWb,IAAI,IAAI,IAAI;IAmBnB,OAAO,CAAC,WAAW,CAcjB;IAEF,OAAO,CAAC,mBAAmB,CAgBzB;IAMF,OAAO,CAAC,WAAW;IAInB,OAAO,CAAC,eAAe,CAIrB;IAEF,OAAO,CAAC,qBAAqB,CAI3B;IAEF,OAAO,CAAC,oBAAoB,CAE1B;IAMF,OAAO,CAAC,kBAAkB;IAsB1B,OAAO,CAAC,WAAW;IAIZ,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAU3C,oBAAoB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAY7C,mBAAmB,IAAI,MAAM,EAAE;CAGzC;AAED,eAAO,MAAM,eAAe,eAAsB,CAAC"}

package/_types/_module/{sys → Framework}/Threads.d.ts

@@ -1,14 +1,20 @@
 import { Signal } from "../util/Signal";
+export type ThreadConfig = {
+    mainRate?: number;
+    lateRate?: number;
+};
 declare class Threads {
-    static create(): Threads;
     readonly MAIN: Signal<number>;
     readonly LATE: Signal<void>;
-    MAIN_INTERVAL_RATE: number;
-    LATE_INTERVAL_RATE: number;
+    private _mainRate;
+    private _lateRate;
     private _MAIN_ID;
     private _LATE_ID;
     private _delta;
-    private constructor();
+    private _started;
+    configure(cfg: ThreadConfig): void;
+    start(): void;
+    stop(): void;
     private createDeltaTimer;
 }
 export declare const _THREAD_: Threads;

package/_types/_module/Framework/Threads.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Threads.d.ts","sourceRoot":"","sources":["../../../_module/Framework/Threads.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,MAAM,MAAM,YAAY,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF,cAAM,OAAO;IACT,SAAgB,IAAI,iBAAwB;IAC5C,SAAgB,IAAI,eAAsB;IAE1C,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,SAAS,CAAkB;IAEnC,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAS;IAElB,SAAS,CAAC,GAAG,EAAE,YAAY;IAM3B,KAAK;IAwBL,IAAI;IASX,OAAO,CAAC,gBAAgB;CAS3B;AAED,eAAO,MAAM,QAAQ,SAAgB,CAAC"}

package/_types/_module/Framework/_INIT.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Initializes the Block Factory framework.
+ *
+ * This **must be called exactly once** before using any backend systems
+ * such as threads, entity tasks, or event routing.
+ *
+ * @param packId - Unique identifier for the active pack instance.
+ *
+ * @throws Error if the framework has already been initialized.
+ *
+ * @example
+ * ```ts
+ * _INITIALIZE_BF_FRAMEWORK_("bf:utility_tools");
+ * ```
+ */
+export declare function _INITIALIZE_BF_FRAMEWORK_(packId: string): void;
+export declare function getPackId(): string | undefined;
+export declare function isInitalized(): boolean;
+//# sourceMappingURL=_INIT.d.ts.map

package/_types/_module/Framework/_INIT.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_INIT.d.ts","sourceRoot":"","sources":["../../../_module/Framework/_INIT.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAI9D;AAMD,wBAAgB,SAAS,IAAI,MAAM,GAAG,SAAS,CAE9C;AAED,wBAAgB,YAAY,IAAI,OAAO,CAEtC"}

package/_types/_module/Types.d.ts

@@ -0,0 +1,10 @@
+export type Sound = {
+    id: string;
+    length: number;
+};
+export type Animation = {
+    id: string;
+    length: number;
+    loop?: boolean;
+};
+//# sourceMappingURL=Types.d.ts.map

package/_types/_module/Types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Types.d.ts","sourceRoot":"","sources":["../../_module/Types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,KAAK,GAAG;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,MAAM,MAAM,SAAS,GAAG;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,OAAO,CAAC;CAClB,CAAA"}

package/_types/_module/util/Signal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../../_module/util/Signal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE5C,qBAAa,MAAM,CAAC,CAAC,GAAG,IAAI;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,IAAW,KAAK,IAAI,MAAM,CAEzB;IAEM,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAIpC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO;IAI1C,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO;IAI3C,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;CAK7B"}
+{"version":3,"file":"Signal.d.ts","sourceRoot":"","sources":["../../../_module/util/Signal.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,IAAI,CAAC;AAE5C,qBAAa,MAAM,CAAC,CAAC,GAAG,IAAI;IACxB,OAAO,CAAC,QAAQ,CAAC,SAAS,CAA0B;IAEpD,IAAW,KAAK,IAAI,MAAM,CAEzB;IAEM,OAAO,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,IAAI;IAIpC,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO;IAI1C,KAAK,IAAI,IAAI;IAIb,WAAW,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,GAAG,OAAO;IAI3C,IAAI,CAAC,IAAI,EAAE,CAAC,GAAG,IAAI;CAO7B"}

package/_types/_module/util/Wrapper/IEntity.d.ts

@@ -1,12 +1,12 @@
-import { Entity } from "@minecraft/server";
+import { Entity, PlayAnimationOptions } from "@minecraft/server";
 import { Inventory } from "./Container";
+import { Animation } from "../../Types";
 export type IEntity = IEntityWrapper & Entity;
 export declare class IEntityWrapper {
     readonly source: Entity;
     private constructor();
     static wrap(source: Entity): IEntity;
-    isAlive: boolean;
-    get inventory(): Inventory;
-    test(): void;
+    get inventory(): Inventory | undefined;
+    playAnimationAsync(animation: Animation, options: PlayAnimationOptions): Promise<void>;
 }
 //# sourceMappingURL=IEntity.d.ts.map

package/_types/_module/util/Wrapper/IEntity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IEntity.d.ts","sourceRoot":"","sources":["../../../../_module/util/Wrapper/IEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA4B,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAoB,SAAS,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9C,qBAAa,cAAc;IACvB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO;WAKO,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKpC,OAAO,EAAE,OAAO,CAAS;IAEhC,IAAW,SAAS,IAAI,SAAS,CAMhC;IAEM,IAAI,IAAI,IAAI;CAItB"}
+{"version":3,"file":"IEntity.d.ts","sourceRoot":"","sources":["../../../../_module/util/Wrapper/IEntity.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAA4B,oBAAoB,EAA0B,MAAM,mBAAmB,CAAC;AACnH,OAAO,EAAoB,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9C,qBAAa,cAAc;IACvB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO;WAKO,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM3C,IAAW,SAAS,IAAI,SAAS,GAAG,SAAS,CAM5C;IAEY,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtG"}

package/_types/_module/util/Wrapper/IPlayer.d.ts

@@ -1,12 +1,13 @@
-import { Player } from "@minecraft/server";
+import { PlayAnimationOptions, Player, PlayerSoundOptions } from "@minecraft/server";
 import { Inventory } from "./Container";
+import { Animation, Sound } from "../../Types";
 export type IPlayer = IPlayerWrapper & Player;
 export declare class IPlayerWrapper {
     readonly source: Player;
     private constructor();
     static wrap(player: Player): IPlayer;
-    isAlive: boolean;
     get inventory(): Inventory;
-    test(): void;
+    playSoundAsync(sound: Sound, options: PlayerSoundOptions): Promise<void>;
+    playAnimationAsync(animation: Animation, options: PlayAnimationOptions): Promise<void>;
 }
 //# sourceMappingURL=IPlayer.d.ts.map

package/_types/_module/util/Wrapper/IPlayer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"IPlayer.d.ts","sourceRoot":"","sources":["../../../../_module/util/Wrapper/IPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,MAAM,EAAE,MAAM,mBAAmB,CAAC;AACrE,OAAO,EAAoB,SAAS,EAAE,MAAM,aAAa,CAAC;AAG1D,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9C,qBAAa,cAAc;IACvB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO;WAKO,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAKpC,OAAO,EAAE,OAAO,CAAS;IAEhC,IAAW,SAAS,IAAI,SAAS,CAMhC;IAEM,IAAI,IAAI,IAAI;CAItB"}
+{"version":3,"file":"IPlayer.d.ts","sourceRoot":"","sources":["../../../../_module/util/Wrapper/IPlayer.ts"],"names":[],"mappings":"AAAA,OAAO,EAA4B,oBAAoB,EAAE,MAAM,EAAE,kBAAkB,EAA0B,MAAM,mBAAmB,CAAC;AACvI,OAAO,EAAoB,SAAS,EAAE,MAAM,aAAa,CAAC;AAE1D,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAE/C,MAAM,MAAM,OAAO,GAAG,cAAc,GAAG,MAAM,CAAC;AAE9C,qBAAa,cAAc;IACvB,SAAgB,MAAM,EAAE,MAAM,CAAC;IAE/B,OAAO;WAKO,IAAI,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO;IAM3C,IAAW,SAAS,IAAI,SAAS,CAMhC;IAEY,cAAc,CAAC,KAAK,EAAC,KAAK,EAAE,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKvE,kBAAkB,CAAC,SAAS,EAAE,SAAS,EAAE,OAAO,EAAE,oBAAoB,GAAG,OAAO,CAAC,IAAI,CAAC;CAKtG"}

package/index.js

@@ -1,8 +1,10 @@
 var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
 };
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
 
 // _module/BlockFactory.ts
 var BlockFactory_exports = {};
@@ -19,9 +21,22 @@ __export(BlockFactory_exports, {
   System: () => System,
   Vec2: () => Vec2,
   Vec3: () => Vec3,
-  _THREAD_: () => _THREAD_
+  _EntityHandler_: () => _EntityHandler_,
+  _INITIALIZE_BF_FRAMEWORK_: () => _INITIALIZE_BF_FRAMEWORK_,
+  _THREAD_: () => _THREAD_,
+  onEntityEmission: () => onEntityEmission
 });
 
+// _module/Framework/_INIT.ts
+var IS_INITIALIZED = false;
+var PACK_ID = void 0;
+function _INITIALIZE_BF_FRAMEWORK_(packId) {
+  if (IS_INITIALIZED) throw Error(`CONFLICT WARNING: ${PACK_ID} already initialized.`);
+  PACK_ID = packId;
+  IS_INITIALIZED = true;
+  console.log("Block Factory Framework Loaded");
+}
+
 // _module/util/Math.ts
 var MathUtils;
 ((MathUtils2) => {
@@ -95,7 +110,7 @@ var MathUtils;
 // _module/util/Signal.ts
 var Signal = class {
   constructor() {
-    this.listeners = /* @__PURE__ */ new Set();
+    __publicField(this, "listeners", /* @__PURE__ */ new Set());
   }
   get count() {
     return this.listeners.size;
@@ -113,8 +128,12 @@ var Signal = class {
     return this.listeners.has(callback);
   }
   emit(data) {
-    for (const cb of Array.from(this.listeners)) {
-      cb(data);
+    for (const callback of Array.from(this.listeners)) {
+      try {
+        callback(data);
+      } catch (err) {
+        console.error("BFLIB: Signal listener error:", err);
+      }
     }
   }
 };
@@ -247,15 +266,15 @@ var _Vec2 = class _Vec2 {
   }
 };
 /** Constant zero vector (0, 0) */
-_Vec2.ZERO = new _Vec2(0, 0);
+__publicField(_Vec2, "ZERO", new _Vec2(0, 0));
 /** Up direction (0, 1) */
-_Vec2.UP = new _Vec2(0, 1);
+__publicField(_Vec2, "UP", new _Vec2(0, 1));
 /** Down direction (0, -1) */
-_Vec2.DOWN = new _Vec2(0, -1);
+__publicField(_Vec2, "DOWN", new _Vec2(0, -1));
 /** Left direction (-1, 0) */
-_Vec2.LEFT = new _Vec2(-1, 0);
+__publicField(_Vec2, "LEFT", new _Vec2(-1, 0));
 /** Right direction (1, 0) */
-_Vec2.RIGHT = new _Vec2(1, 0);
+__publicField(_Vec2, "RIGHT", new _Vec2(1, 0));
 var Vec2 = _Vec2;
 var _Vec3 = class _Vec3 {
   /**
@@ -416,27 +435,27 @@ var _Vec3 = class _Vec3 {
   }
 };
 /** Constant zero vector (0, 0, 0) */
-_Vec3.ZERO = new _Vec3(0, 0, 0);
+__publicField(_Vec3, "ZERO", new _Vec3(0, 0, 0));
 /** Up direction (0, 1, 0) */
-_Vec3.UP = new _Vec3(0, 1, 0);
+__publicField(_Vec3, "UP", new _Vec3(0, 1, 0));
 /** Down direction (0, -1, 0) */
-_Vec3.DOWN = new _Vec3(0, -1, 0);
+__publicField(_Vec3, "DOWN", new _Vec3(0, -1, 0));
 /** Left direction (-1, 0, 0) */
-_Vec3.LEFT = new _Vec3(-1, 0, 0);
+__publicField(_Vec3, "LEFT", new _Vec3(-1, 0, 0));
 /** Right direction (1, 0, 0) */
-_Vec3.RIGHT = new _Vec3(1, 0, 0);
+__publicField(_Vec3, "RIGHT", new _Vec3(1, 0, 0));
 /** Forward direction (0, 0, 1) */
-_Vec3.FORWARD = new _Vec3(0, 0, 1);
+__publicField(_Vec3, "FORWARD", new _Vec3(0, 0, 1));
 /** Backward direction (0, 0, -1) */
-_Vec3.BACK = new _Vec3(0, 0, -1);
+__publicField(_Vec3, "BACK", new _Vec3(0, 0, -1));
 /** West direction (-1, 0, 0) */
-_Vec3.WEST = new _Vec3(-1, 0, 0);
+__publicField(_Vec3, "WEST", new _Vec3(-1, 0, 0));
 /** East direction (1, 0, 0) */
-_Vec3.EAST = new _Vec3(1, 0, 0);
+__publicField(_Vec3, "EAST", new _Vec3(1, 0, 0));
 /** North direction (0, 0, 1) */
-_Vec3.NORTH = new _Vec3(0, 0, 1);
+__publicField(_Vec3, "NORTH", new _Vec3(0, 0, 1));
 /** South direction (0, 0, -1) */
-_Vec3.SOUTH = new _Vec3(0, 0, -1);
+__publicField(_Vec3, "SOUTH", new _Vec3(0, 0, -1));
 var Vec3 = _Vec3;
 
 // _module/util/RawText.ts
@@ -482,7 +501,7 @@ var RawText = class {
 /**
  * Common formatting and color codes.
  */
-RawText.FORMAT = {
+__publicField(RawText, "FORMAT", {
   DarkRed: "\xA74",
   Red: "\xA7c",
   Gold: "\xA76",
@@ -505,7 +524,7 @@ RawText.FORMAT = {
   Italic: "\xA7o",
   Reset: "\xA7r",
   NewLine: "\n"
-};
+});
 
 // _module/util/Command.ts
 import {
@@ -514,6 +533,14 @@ import {
 var Command;
 ((Command2) => {
   class ICustomCommand {
+    constructor() {
+      /** Whether cheats must be enabled */
+      __publicField(this, "cheatsRequired");
+      /** Required command parameters */
+      __publicField(this, "mandatoryParameters");
+      /** Optional command parameters */
+      __publicField(this, "optionalParameters");
+    }
   }
   Command2.ICustomCommand = ICustomCommand;
   ;
@@ -581,8 +608,8 @@ var _IForm = class _IForm {
     else _IForm.occupiedPlayers.delete(player.id);
   }
 };
-_IForm.occupiedPlayers = /* @__PURE__ */ new Set();
-_IForm.returnText = "Back";
+__publicField(_IForm, "occupiedPlayers", /* @__PURE__ */ new Set());
+__publicField(_IForm, "returnText", "Back");
 var IForm = _IForm;
 
 // _module/util/Forms/FormAction.ts
@@ -617,6 +644,7 @@ world2.afterEvents.itemUse.subscribe((event) => {
 // _module/util/Wrapper/Container.ts
 var ContainerWrapper = class _ContainerWrapper {
   constructor(source) {
+    __publicField(this, "source");
     this.source = source;
     return System.ProxyConstructor(this, source);
   }
@@ -638,83 +666,107 @@ var ContainerWrapper = class _ContainerWrapper {
 };
 
 // _module/util/Wrapper/IEntity.ts
-import { EntityInventoryComponent } from "@minecraft/server";
+import { EntityInventoryComponent, system as system2, TicksPerSecond } from "@minecraft/server";
 var IEntityWrapper = class _IEntityWrapper {
   constructor(source) {
-    //======================== Interal ========================
-    this.isAlive = false;
+    __publicField(this, "source");
     this.source = source;
     return System.ProxyConstructor(this, source);
   }
   static wrap(source) {
     return new _IEntityWrapper(source);
   }
+  //======================== Interal ========================
   get inventory() {
     const i = this.source.getComponent(
       EntityInventoryComponent.componentId
     );
     return ContainerWrapper.wrap(i.container);
   }
-  test() {
+  async playAnimationAsync(animation, options) {
+    this.source.playAnimation(animation.id, options);
+    await system2.waitTicks(animation.length * TicksPerSecond);
   }
 };
 
 // _module/util/Wrapper/IPlayer.ts
-import { EntityInventoryComponent as EntityInventoryComponent2 } from "@minecraft/server";
+import { EntityInventoryComponent as EntityInventoryComponent2, system as system3, TicksPerSecond as TicksPerSecond2 } from "@minecraft/server";
 var IPlayerWrapper = class _IPlayerWrapper {
   constructor(source) {
-    //======================== Interal ========================
-    this.isAlive = false;
+    __publicField(this, "source");
     this.source = source;
     return System.ProxyConstructor(this, source);
   }
   static wrap(player) {
     return new _IPlayerWrapper(player);
   }
+  //======================== Interal ========================
   get inventory() {
     const i = this.source.getComponent(
       EntityInventoryComponent2.componentId
     );
     return ContainerWrapper.wrap(i.container);
   }
-  test() {
-    this.source.sendMessage(`${this.source.name} was tested`);
+  async playSoundAsync(sound, options) {
+    this.source.playSound(sound.id, options);
+    await system3.waitTicks(sound.length * TicksPerSecond2);
+  }
+  async playAnimationAsync(animation, options) {
+    this.source.playAnimation(animation.id, options);
+    await system3.waitTicks(animation.length * TicksPerSecond2);
   }
 };
 
-// _module/sys/Threads.ts
-import { system as system2, TicksPerSecond } from "@minecraft/server";
-var Threads = class _Threads {
+// _module/Framework/Threads.ts
+import { system as system4, TicksPerSecond as TicksPerSecond3 } from "@minecraft/server";
+var Threads = class {
   constructor() {
-    this.MAIN = new Signal();
-    this.LATE = new Signal();
-    this.MAIN_INTERVAL_RATE = 0;
-    this.LATE_INTERVAL_RATE = TicksPerSecond;
-    this._delta = this.createDeltaTimer();
-    this._MAIN_ID = system2.runInterval(() => {
+    __publicField(this, "MAIN", new Signal());
+    __publicField(this, "LATE", new Signal());
+    __publicField(this, "_mainRate", 0);
+    __publicField(this, "_lateRate", TicksPerSecond3);
+    __publicField(this, "_MAIN_ID");
+    __publicField(this, "_LATE_ID");
+    __publicField(this, "_delta", this.createDeltaTimer());
+    __publicField(this, "_started", false);
+  }
+  configure(cfg) {
+    if (this._started) throw new Error("BFLIB: _THREAD_ already started; configure before start().");
+    if (cfg.mainRate !== void 0) this._mainRate = cfg.mainRate;
+    if (cfg.lateRate !== void 0) this._lateRate = cfg.lateRate;
+  }
+  start() {
+    if (this._started) return;
+    this._started = true;
+    this._MAIN_ID = system4.runInterval(() => {
       if (this.MAIN.count <= 0) return;
       try {
         const delta = this._delta();
         this.MAIN.emit(delta);
-      } catch (error) {
-        throw Error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} | ${error}`);
+      } catch (e) {
+        console.error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} |`, e);
       }
-    }, this.MAIN_INTERVAL_RATE);
-    this._LATE_ID = system2.runInterval(() => {
+    }, this._mainRate);
+    this._LATE_ID = system4.runInterval(() => {
       if (this.LATE.count <= 0) return;
       try {
         this.LATE.emit();
-      } catch (error) {
-        throw Error(`ERROR: _THREAD_.LATE:${this._LATE_ID} | ${error}`);
+      } catch (e) {
+        console.error(`ERROR: _THREAD_.LATE:${this._LATE_ID} |`, e);
       }
-    }, this.LATE_INTERVAL_RATE);
-  }
-  static create() {
-    return new _Threads();
+    }, this._lateRate);
+  }
+  stop() {
+    if (this._MAIN_ID !== void 0) system4.clearRun(this._MAIN_ID);
+    if (this._LATE_ID !== void 0) system4.clearRun(this._LATE_ID);
+    this._MAIN_ID = void 0;
+    this._LATE_ID = void 0;
+    this._started = false;
+    this._delta = this.createDeltaTimer();
   }
   createDeltaTimer() {
     let last = Date.now();
-    return function nextDelta() {
+    return () => {
       const now = Date.now();
       const delta = (now - last) / 1e3;
       last = now;
@@ -722,7 +774,145 @@ var Threads = class _Threads {
     };
   }
 };
-var _THREAD_ = Threads.create();
+var _THREAD_ = new Threads();
+
+// _module/Framework/EntityTasks.ts
+import {
+  system as system5,
+  world as world3
+} from "@minecraft/server";
+var onEntityEmission = new Signal();
+var EntityHandler = class {
+  constructor() {
+    __publicField(this, "PACK_ID");
+    __publicField(this, "GLOBAL_MEMORY_ID", "GLB_MEM.ENTITY");
+    __publicField(this, "scriptEventSignal", system5.afterEvents.scriptEventReceive);
+    __publicField(this, "loadEventSignal", world3.afterEvents.worldLoad);
+    __publicField(this, "spawnEventSignal", world3.afterEvents.entitySpawn);
+    __publicField(this, "removeAfterEventSignal", world3.afterEvents.entityRemove);
+    __publicField(this, "removeBeforeEventSignal", world3.beforeEvents.entityRemove);
+    __publicField(this, "EM_INDEX", /* @__PURE__ */ new Map());
+    __publicField(this, "EM_KEYS", []);
+    __publicField(this, "SEARCH_TYPES", /* @__PURE__ */ new Set());
+    __publicField(this, "_started", false);
+    __publicField(this, "_wired", false);
+    /* ------------------------------------------------------------------------ */
+    /* Event Wiring                                                             */
+    /* ------------------------------------------------------------------------ */
+    __publicField(this, "onWorldLoad", (_event) => {
+      this.scriptEventSignal.subscribe(this.processScriptEvents);
+      if (this.SEARCH_TYPES.size > 0) {
+        this.spawnEventSignal.subscribe(this.onEntitySpawned);
+        this.removeBeforeEventSignal.subscribe(this.onEntityRemovedBefore);
+        this.removeAfterEventSignal.subscribe(this.onEntityRemovedAfter);
+      }
+      this._wired = true;
+      this.reloadEntityMemory();
+      this.loadEventSignal.unsubscribe(this.onWorldLoad);
+    });
+    __publicField(this, "processScriptEvents", (event) => {
+      if (!event.sourceEntity) return;
+      if (event.id !== `${this.PACK_ID}:entity_emitter`) return;
+      let parms;
+      try {
+        parms = JSON.parse(event.message);
+      } catch (e) {
+        console.error(`BFLIB: entity_emitter JSON parse failed:`, e);
+        return;
+      }
+      onEntityEmission.emit({
+        iEntity: IEntityWrapper.wrap(event.sourceEntity),
+        parms
+      });
+    });
+    __publicField(this, "onEntitySpawned", (event) => {
+      const entity = event.entity;
+      if (!this.isValidType(entity.typeId)) return;
+      this.saveEntityInMemory(entity);
+    });
+    __publicField(this, "onEntityRemovedBefore", (event) => {
+      const entity = event.removedEntity;
+      if (!this.isValidType(entity.typeId)) return;
+      this.deleteEntityInMemory(entity);
+    });
+    __publicField(this, "onEntityRemovedAfter", (_event) => {
+    });
+  }
+  configure() {
+    if (this._started) throw new Error("BFLIB: EntityHandler already started;");
+  }
+  registerEntity(typeId) {
+    if (Array.isArray(typeId)) typeId.forEach((t) => this.SEARCH_TYPES.add(t));
+    else this.SEARCH_TYPES.add(typeId);
+  }
+  start(packId) {
+    if (this._started) return;
+    this._started = true;
+    this.PACK_ID = packId;
+    this.loadEventSignal.subscribe(this.onWorldLoad);
+  }
+  stop() {
+    if (!this._started) return;
+    this.loadEventSignal.unsubscribe(this.onWorldLoad);
+    if (this._wired) {
+      this.scriptEventSignal.unsubscribe(this.processScriptEvents);
+      this.spawnEventSignal.unsubscribe(this.onEntitySpawned);
+      this.removeBeforeEventSignal.unsubscribe(this.onEntityRemovedBefore);
+      this.removeAfterEventSignal.unsubscribe(this.onEntityRemovedAfter);
+      this._wired = false;
+    }
+    this._started = false;
+  }
+  /* ------------------------------------------------------------------------ */
+  /* Filters                                                                  */
+  /* ------------------------------------------------------------------------ */
+  isValidType(typeId) {
+    return this.SEARCH_TYPES.has(typeId);
+  }
+  /* ------------------------------------------------------------------------ */
+  /* Persistence                                                              */
+  /* ------------------------------------------------------------------------ */
+  reloadEntityMemory() {
+    this.EM_INDEX.clear();
+    this.EM_KEYS.length = 0;
+    const raw = world3.getDynamicProperty(this.GLOBAL_MEMORY_ID);
+    if (!raw) return;
+    let parsed;
+    try {
+      parsed = JSON.parse(raw);
+    } catch (e) {
+      console.error(`BFLIB: Failed to parse ${this.GLOBAL_MEMORY_ID}:`, e);
+      return;
+    }
+    for (const id of parsed) {
+      this.EM_KEYS.push(id);
+      const entity = world3.getEntity(id);
+      if (entity) this.EM_INDEX.set(entity.id, entity);
+    }
+  }
+  persistKeys() {
+    world3.setDynamicProperty(this.GLOBAL_MEMORY_ID, JSON.stringify(this.EM_KEYS));
+  }
+  saveEntityInMemory(entity) {
+    if (this.EM_INDEX.has(entity.id)) return false;
+    this.EM_KEYS.push(entity.id);
+    this.EM_INDEX.set(entity.id, entity);
+    this.persistKeys();
+    return true;
+  }
+  deleteEntityInMemory(entity) {
+    const existed = this.EM_INDEX.delete(entity.id);
+    if (!existed) return false;
+    const idx = this.EM_KEYS.indexOf(entity.id);
+    if (idx !== -1) this.EM_KEYS.splice(idx, 1);
+    this.persistKeys();
+    return true;
+  }
+  getEntitiesInMemory() {
+    return Array.from(this.EM_INDEX.values());
+  }
+};
+var _EntityHandler_ = new EntityHandler();
 export {
   BlockFactory_exports as BlockFactory,
   Command,
@@ -737,5 +927,8 @@ export {
   System,
   Vec2,
   Vec3,
-  _THREAD_
+  _EntityHandler_,
+  _INITIALIZE_BF_FRAMEWORK_,
+  _THREAD_,
+  onEntityEmission
 };

package/package.json

@@ -1,34 +1,34 @@
-{
-  "name": "@block_factory/lib",
-  "version": "0.0.4",
-  "main": "index.js",
-  "types": "index.d.ts",
-  "description": "Typescript Library for Minecraft Bedrock Edition",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/Block-Factory-Studio/bf-lib.git"
-  },
-  "author": "Block Factory x Donthedev",
-  "contributors": [
-    {
-      "name": "Donthedev",
-      "email": "donthedev@blockfactory.studio"
-    }
-  ],
-  "license": "MIT",
-  "bugs": {
-    "url": "https://github.com/Block-Factory-Studio/bf-mcbr-library/issues"
-  },
-  "homepage": "https://github.com/Block-Factory-Studio/bf-mcbr-library#readme",
-  "dependencies": {
-    "@minecraft/server": "^2.4.0",
-    "@minecraft/server-ui": "^2.0.0"
-  },
-  "devDependencies": {
-    "esbuild": "^0.25.9"
-  },
-  "scripts": {
-    "build": "node esbuild.config.mjs",
-    "build:types": "tsc -p tsconfig.types.json"
-  }
-}
+{
+  "name": "@block_factory/lib",
+  "version": "0.0.5",
+  "main": "index.js",
+  "types": "index.d.ts",
+  "description": "Typescript Library for Minecraft Bedrock Edition",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Block-Factory-Studio/bf-lib.git"
+  },
+  "author": "Block Factory x Donthedev",
+  "contributors": [
+    {
+      "name": "Donthedev",
+      "email": "donthedev@blockfactory.studio"
+    }
+  ],
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/Block-Factory-Studio/bf-mcbr-library/issues"
+  },
+  "homepage": "https://github.com/Block-Factory-Studio/bf-mcbr-library#readme",
+  "dependencies": {
+    "@minecraft/server": "^2.4.0",
+    "@minecraft/server-ui": "^2.0.0"
+  },
+  "devDependencies": {
+    "esbuild": "^0.25.9"
+  },
+  "scripts": {
+    "build": "node esbuild.config.mjs",
+    "build:types": "tsc -p tsconfig.types.json"
+  }
+}

package/_module/sys/Threads.ts

@@ -1,43 +0,0 @@
-import { system, TicksPerSecond } from "@minecraft/server";
-import { Signal } from "../util/Signal";
-
-class Threads {
-    public static create(): Threads { return new Threads() }
-    public readonly MAIN = new Signal<number>();
-    public readonly LATE = new Signal();
-    public MAIN_INTERVAL_RATE: number = 0;
-    public LATE_INTERVAL_RATE: number = TicksPerSecond;
-
-    private _MAIN_ID: number;
-    private _LATE_ID: number;
-    private _delta = this.createDeltaTimer();
-
-    private constructor() {
-        this._MAIN_ID = system.runInterval(() => {
-            if (this.MAIN.count <= 0) return;
-            try { const delta = this._delta(); this.MAIN.emit(delta) }
-            catch (error) {
-                throw Error(`ERROR: _THREAD_.MAIN:${this._MAIN_ID} | ${error}`)
-            }
-        }, this.MAIN_INTERVAL_RATE);
-
-        this._LATE_ID = system.runInterval(() => {
-            if (this.LATE.count <= 0) return;
-            try { this.LATE.emit() }
-            catch (error) { throw Error(`ERROR: _THREAD_.LATE:${this._LATE_ID} | ${error}`) }
-        }, this.LATE_INTERVAL_RATE);
-    }
-
-    private createDeltaTimer() {
-        let last = Date.now();
-
-        return function nextDelta(): number {
-            const now = Date.now();
-            const delta = (now - last) / 1000; // seconds
-            last = now;
-            return delta;
-        };
-    }
-}
-
-export const _THREAD_ = Threads.create();

package/_types/_module/sys/Threads.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Threads.d.ts","sourceRoot":"","sources":["../../../_module/sys/Threads.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC,cAAM,OAAO;WACK,MAAM,IAAI,OAAO;IAC/B,SAAgB,IAAI,iBAAwB;IAC5C,SAAgB,IAAI,eAAgB;IAC7B,kBAAkB,EAAE,MAAM,CAAK;IAC/B,kBAAkB,EAAE,MAAM,CAAkB;IAEnD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,MAAM,CAA2B;IAEzC,OAAO;IAgBP,OAAO,CAAC,gBAAgB;CAU3B;AAED,eAAO,MAAM,QAAQ,SAAmB,CAAC"}