mbler 0.1.1 → 0.1.3-alpha

package/lib/modules/create-game/src/config.js

@@ -1 +1,27 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.SAPIGameConfig=void 0;const index_js_1=require("./utils/index.js"),defaultConfig={logLevel:index_js_1.logLevel.debug,onEnd:()=>{},onJoin:()=>{},hub:()=>{},debugMode:!1};class SAPIGameConfig{static _config={};static get config(){return{...defaultConfig,...this._config}}static update(e){this._config={...this._config,...e}}static reset(){this._config={}}}exports.SAPIGameConfig=SAPIGameConfig;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SAPIGameConfig = void 0;
+const index_js_1 = require("./utils/index.js");
+const defaultConfig = {
+    logLevel: index_js_1.logLevel.debug,
+    onEnd: () => { },
+    onJoin: () => { },
+    hub: () => { },
+    debugMode: false,
+};
+class SAPIGameConfig {
+    static _config = {};
+    /** 获取当前配置（合并默认配置和用户配置） */
+    static get config() {
+        return { ...defaultConfig, ...this._config };
+    }
+    /** 更新配置（部分更新即可） */
+    static update(config) {
+        this._config = { ...this._config, ...config };
+    }
+    /** 重置为默认配置 */
+    static reset() {
+        this._config = {};
+    }
+}
+exports.SAPIGameConfig = SAPIGameConfig;

package/lib/modules/create-game/src/constants.js

@@ -1 +1,19 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.Constants=exports.Dimensions=void 0;const server_1=require("@minecraft/server"),deferredObject_js_1=require("./utils/deferredObject.js"),vanila_data_js_1=require("./utils/vanila-data.js"),{proxy:dims,setTarget:setTarget}=(0,deferredObject_js_1.createDeferredObject)();server_1.world.afterEvents.worldLoad.subscribe(()=>{setTarget({Overworld:server_1.world.getDimension(vanila_data_js_1.DimensionIds.Overworld),Nether:server_1.world.getDimension(vanila_data_js_1.DimensionIds.Nether),End:server_1.world.getDimension(vanila_data_js_1.DimensionIds.End)})}),exports.Dimensions=dims,exports.Constants={dimension:dims};
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Constants = exports.Dimensions = void 0;
+const server_1 = require("@minecraft/server");
+const deferredObject_js_1 = require("./utils/deferredObject.js");
+const vanila_data_js_1 = require("./utils/vanila-data.js");
+const { proxy: dims, setTarget } = (0, deferredObject_js_1.createDeferredObject)();
+server_1.world.afterEvents.worldLoad.subscribe(() => {
+    setTarget({
+        Overworld: server_1.world.getDimension(vanila_data_js_1.DimensionIds.Overworld),
+        Nether: server_1.world.getDimension(vanila_data_js_1.DimensionIds.Nether),
+        End: server_1.world.getDimension(vanila_data_js_1.DimensionIds.End),
+    });
+});
+exports.Dimensions = dims;
+exports.Constants = {
+    /**维度常量（游戏加载后可用） */
+    dimension: dims,
+};

package/lib/modules/create-game/src/createGameModule.js

@@ -1 +1,24 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.createGameModule=createGameModule;const gameComponent_js_1=require("./gameComponent/gameComponent.js"),gameEngine_js_1=require("./gameEngine.js"),gamePlayer_js_1=require("./gamePlayer/gamePlayer.js"),gameState_js_1=require("./gameState/gameState.js");function createGameModule(e){const a=e.playerClass??gamePlayer_js_1.GamePlayer;class t extends gameEngine_js_1.GameEngine{constructor(e,t){super(a,e,t)}}class n extends gameState_js_1.GameState{}class s extends gameComponent_js_1.GameComponent{}return{Engine:t,State:n,Component:s}}
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createGameModule = createGameModule;
+const gameComponent_js_1 = require("./gameComponent/gameComponent.js");
+const gameEngine_js_1 = require("./gameEngine.js");
+const gamePlayer_js_1 = require("./gamePlayer/gamePlayer.js");
+const gameState_js_1 = require("./gameState/gameState.js");
+function createGameModule(options) {
+    const playerClass = options.playerClass ?? gamePlayer_js_1.GamePlayer;
+    class Engine extends gameEngine_js_1.GameEngine {
+        constructor(key, config) {
+            super(playerClass, key, config);
+        }
+    }
+    class State extends gameState_js_1.GameState {
+    }
+    class Component extends gameComponent_js_1.GameComponent {
+    }
+    return {
+        Engine,
+        State,
+        Component,
+    };
+}

package/lib/modules/create-game/src/gameComponent/common/autoStop.js

@@ -1 +1,38 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.AutoStopComponent=void 0;const main_js_1=require("../../main.js"),index_js_1=require("../../utils/index.js");class AutoStopComponent extends main_js_1.GameComponent{onAttach(){this.options&&this.subscribe(main_js_1.Game.events.interval,this.tick.bind(this),new index_js_1.Duration(20))}tick(){let t=0;this.options.groupSet.getAllPlayers().forEach(e=>{e.ttl>0&&t++,e.isValid?e.ttl=e.initialTTL:e.ttl>0&&(e.ttl--,this.options?.immediateDie&&(e.ttl=0),0==e.ttl&&(this.options.onLeave?.(e),this.options?.shouldRelease&&main_js_1.Game.playerManager.releasePlayerFromGame(e.id,this.state.gameKey)))}),0===t&&this.options.onStopGame()}}exports.AutoStopComponent=AutoStopComponent;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AutoStopComponent = void 0;
+const main_js_1 = require("../../main.js");
+const index_js_1 = require("../../utils/index.js");
+/**在组中所有玩家寄了之后自动结束游戏 */
+class AutoStopComponent extends main_js_1.GameComponent {
+    onAttach() {
+        if (!this.options)
+            return;
+        this.subscribe(main_js_1.Game.events.interval, this.tick.bind(this), new index_js_1.Duration(20));
+    }
+    tick() {
+        let liveSize = 0;
+        this.options.groupSet.getAllPlayers().forEach((p) => {
+            if (p.ttl > 0)
+                liveSize++;
+            if (p.isValid) {
+                p.ttl = p.initialTTL; //重置TTL
+            }
+            else if (p.ttl > 0) {
+                p.ttl--; //下线的ttl减少
+                if (this.options?.immediateDie)
+                    p.ttl = 0;
+                if (p.ttl == 0) {
+                    this.options.onLeave?.(p);
+                    //自动释放玩家
+                    if (this.options?.shouldRelease)
+                        main_js_1.Game.playerManager.releasePlayerFromGame(p.id, this.state.gameKey);
+                }
+            }
+        });
+        if (liveSize === 0) {
+            this.options.onStopGame();
+        }
+    }
+}
+exports.AutoStopComponent = AutoStopComponent;

package/lib/modules/create-game/src/gameComponent/common/lazyLoader.js

@@ -1 +1,76 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.LazyLoader=void 0;const server_1=require("@minecraft/server"),main_js_1=require("../../main.js"),index_js_1=require("../../utils/index.js"),gameComponent_js_1=require("../gameComponent.js");class LazyLoader extends gameComponent_js_1.GameComponent{active=!1;logger=new index_js_1.Logger(this.constructor.name);components=[];get isActive(){return this.active}onAttach(){this.subscribe(main_js_1.Game.events.interval,()=>{if(!this.options)return;const{dimensionId:e,pos:t,onLoad:o,onUnload:s}=this.options;if(server_1.world.getDimension(e).getBlock(t)){if(!this.active){this.logger.log("load");try{o(this)}catch(e){this.logger.error("onLoad error:",e)}this.active=!0}}else if(this.active){this.logger.log("unload"),this.clearComponents();try{s?.()}catch(e){this.logger.error("onUnload error",e)}this.active=!1}},this.options.interval??new index_js_1.Duration(20))}clearComponents(){this.components.forEach(e=>{this.state.eventManager.unsubscribeBySubscriber(e)}),this.components.forEach(e=>this.state.deleteComponent(e)),this.components=[]}reload(){if(!this.options)return;const{onLoad:e,onUnload:t}=this.options;this.active&&(t?.(),this.clearComponents(),this.active=!1),e(this),this.active=!0}addComponent(e,t){return this.state.addComponent(e,t),this.components.push(e),this}}exports.LazyLoader=LazyLoader;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LazyLoader = void 0;
+const server_1 = require("@minecraft/server");
+const main_js_1 = require("../../main.js");
+const index_js_1 = require("../../utils/index.js");
+const gameComponent_js_1 = require("../gameComponent.js");
+/**用于懒加载区块 */
+class LazyLoader extends gameComponent_js_1.GameComponent {
+    active = false;
+    logger = new index_js_1.Logger(this.constructor.name);
+    components = [];
+    get isActive() {
+        return this.active;
+    }
+    onAttach() {
+        this.subscribe(main_js_1.Game.events.interval, () => {
+            if (!this.options)
+                return;
+            const { dimensionId: dimension, pos, onLoad, onUnload, } = this.options;
+            const load = server_1.world.getDimension(dimension).getBlock(pos);
+            if (load) {
+                if (!this.active) {
+                    this.logger.log("load");
+                    try {
+                        onLoad(this);
+                    }
+                    catch (err) {
+                        this.logger.error("onLoad error:", err);
+                    }
+                    this.active = true;
+                }
+            }
+            else {
+                if (this.active) {
+                    this.logger.log("unload");
+                    this.clearComponents();
+                    try {
+                        onUnload?.();
+                    }
+                    catch (e) {
+                        this.logger.error("onUnload error", e);
+                    }
+                    this.active = false;
+                }
+            }
+        }, this.options.interval ?? new index_js_1.Duration(20));
+    }
+    clearComponents() {
+        //先取消所有订阅
+        this.components.forEach((c) => {
+            this.state.eventManager.unsubscribeBySubscriber(c);
+        });
+        //再删除所有组件
+        this.components.forEach((c) => this.state.deleteComponent(c));
+        this.components = [];
+    }
+    reload() {
+        if (!this.options)
+            return;
+        const { onLoad, onUnload } = this.options;
+        if (this.active) {
+            onUnload?.();
+            this.clearComponents();
+            this.active = false;
+        }
+        onLoad(this);
+        this.active = true;
+    }
+    addComponent(component, options) {
+        this.state.addComponent(component, options);
+        this.components.push(component);
+        return this;
+    }
+}
+exports.LazyLoader = LazyLoader;

package/lib/modules/create-game/src/gameComponent/common/stopWatch/onTimeEvent.js

@@ -1 +1,36 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.StopWatchOnTimeEventSignal=void 0;const logger_js_1=require("../../../utils/logger.js");class StopWatchOnTimeEventSignal{logger=new logger_js_1.Logger(this.constructor.name);events=[];subscribe(e,t){const s={time:t.time,callback:e,once:t.once??!0};return this.events.push(s),{unsubscribe:()=>{this.events=this.events.filter(e=>e!==s)}}}checkAndFireTimeEvents(e){const t=this.events.filter(t=>e===t.time);t.forEach(e=>{try{e.callback()}catch(e){this.logger.error("执行stopWatch事件失败:",e)}}),this.events=this.events.filter(e=>!e.once||!t.includes(e))}}exports.StopWatchOnTimeEventSignal=StopWatchOnTimeEventSignal;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopWatchOnTimeEventSignal = void 0;
+const logger_js_1 = require("../../../utils/logger.js");
+class StopWatchOnTimeEventSignal {
+    logger = new logger_js_1.Logger(this.constructor.name);
+    events = [];
+    subscribe(callback, options) {
+        const event = {
+            time: options.time,
+            callback,
+            once: options.once ?? true,
+        };
+        this.events.push(event);
+        return {
+            unsubscribe: () => {
+                this.events = this.events.filter((e) => e !== event);
+            },
+        };
+    }
+    /**检查并触发到达时间的事件*/
+    checkAndFireTimeEvents(time) {
+        const eventsToFire = this.events.filter((event) => time === event.time);
+        eventsToFire.forEach((event) => {
+            try {
+                event.callback();
+            }
+            catch (e) {
+                this.logger.error("执行stopWatch事件失败:", e);
+            }
+        });
+        // 如果配置为once，则在执行后移除
+        this.events = this.events.filter((event) => !event.once || !eventsToFire.includes(event));
+    }
+}
+exports.StopWatchOnTimeEventSignal = StopWatchOnTimeEventSignal;

package/lib/modules/create-game/src/gameComponent/common/stopWatch/stopWatch.js

@@ -1 +1,90 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.StopWatch=void 0;const main_js_1=require("../../../main.js"),gameComponent_js_1=require("../../gameComponent.js"),onTimeEvent_js_1=require("./onTimeEvent.js"),tickEvent_js_1=require("./tickEvent.js");class StopWatch extends gameComponent_js_1.GameComponent{elapsedTime=0;_isRunning=!1;lastTime=0;isActive=!0;events={tick:new tickEvent_js_1.StopWatchTickEventSignal,onTime:new onTimeEvent_js_1.StopWatchOnTimeEventSignal};get time(){return this.elapsedTime}get isRunning(){return this._isRunning}onAttach(){this.isActive=!0,this.elapsedTime=this.options?.initialTime??0,this.options?.autoStart&&this.start(),this.subscribe(main_js_1.Game.events.interval,()=>{if(!this._isRunning)return;const e=Date.now(),t=e-this.lastTime;if(t>=1e3){if(this.options?.compensate){const e=Math.floor(t/1e3);this.elapsedTime+=e,this.lastTime+=1e3*e}else this.elapsedTime+=1,this.lastTime=e;this.events.tick.publish(this.elapsedTime),this.events.onTime.checkAndFireTimeEvents(this.elapsedTime)}})}onDetach(){this._isRunning=!1,this.isActive=!1,super.onDetach(),this.state.eventManager.unsubscribeByEvent(this.events.onTime),this.state.eventManager.unsubscribeByEvent(this.events.tick)}reset(e=0){this.elapsedTime=Math.max(0,e),this.lastTime=Date.now(),this._isRunning&&this.events.tick.publish(this.elapsedTime)}stop(){this._isRunning=!1}start(){!this._isRunning&&this.isActive&&(this._isRunning=!0,this.lastTime=Date.now(),this.events.tick.publish(this.elapsedTime),this.events.onTime.checkAndFireTimeEvents(this.elapsedTime))}toggle(){this._isRunning?this.stop():this.start()}}exports.StopWatch=StopWatch;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopWatch = void 0;
+const main_js_1 = require("../../../main.js");
+const gameComponent_js_1 = require("../../gameComponent.js");
+const onTimeEvent_js_1 = require("./onTimeEvent.js");
+const tickEvent_js_1 = require("./tickEvent.js");
+class StopWatch extends gameComponent_js_1.GameComponent {
+    elapsedTime = 0;
+    _isRunning = false;
+    lastTime = 0;
+    isActive = true;
+    events = {
+        tick: new tickEvent_js_1.StopWatchTickEventSignal(),
+        onTime: new onTimeEvent_js_1.StopWatchOnTimeEventSignal(),
+    };
+    /** 获取当前已计时间（秒） */
+    get time() {
+        return this.elapsedTime;
+    }
+    /** 获取秒表是否正在运行 */
+    get isRunning() {
+        return this._isRunning;
+    }
+    /** 组件被附加到游戏对象时调用 */
+    onAttach() {
+        this.isActive = true;
+        this.elapsedTime = this.options?.initialTime ?? 0;
+        if (this.options?.autoStart) {
+            this.start();
+        }
+        // 订阅游戏的 tick 事件，驱动秒表
+        this.subscribe(main_js_1.Game.events.interval, () => {
+            if (!this._isRunning)
+                return;
+            const now = Date.now();
+            const diff = now - this.lastTime;
+            if (diff >= 1000) {
+                if (this.options?.compensate) {
+                    // 按真实时间补偿，防止掉帧少加
+                    const steps = Math.floor(diff / 1000);
+                    this.elapsedTime += steps;
+                    this.lastTime += steps * 1000;
+                }
+                else {
+                    // 不补偿，只加 1 秒
+                    this.elapsedTime += 1;
+                    this.lastTime = now;
+                }
+                // 每秒触发 tick
+                this.events.tick.publish(this.elapsedTime);
+                // 检查并触发特定时间事件
+                this.events.onTime.checkAndFireTimeEvents(this.elapsedTime);
+            }
+        });
+    }
+    onDetach() {
+        this._isRunning = false;
+        this.isActive = false;
+        super.onDetach();
+        this.state.eventManager.unsubscribeByEvent(this.events.onTime);
+        this.state.eventManager.unsubscribeByEvent(this.events.tick);
+    }
+    /** 重置秒表时间 */
+    reset(time = 0) {
+        this.elapsedTime = Math.max(0, time);
+        this.lastTime = Date.now();
+        if (this._isRunning) {
+            this.events.tick.publish(this.elapsedTime);
+        }
+    }
+    /** 停止秒表 */
+    stop() {
+        this._isRunning = false;
+    }
+    /** 启动秒表 */
+    start() {
+        if (!this._isRunning && this.isActive) {
+            this._isRunning = true;
+            this.lastTime = Date.now();
+            this.events.tick.publish(this.elapsedTime);
+            this.events.onTime.checkAndFireTimeEvents(this.elapsedTime);
+        }
+    }
+    /** 暂停或恢复 */
+    toggle() {
+        this._isRunning ? this.stop() : this.start();
+    }
+}
+exports.StopWatch = StopWatch;

package/lib/modules/create-game/src/gameComponent/common/stopWatch/tickEvent.js

@@ -1 +1,29 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.StopWatchTickEventSignal=void 0;const index_js_1=require("../../../utils/index.js");class StopWatchTickEventSignal{tickCallbacks=new Set;logger=new index_js_1.Logger(this.constructor.name);constructor(){}subscribe(t){return this.tickCallbacks.add(t),{unsubscribe:()=>{this.tickCallbacks.delete(t)}}}publish(t){this.tickCallbacks.forEach(e=>{try{e({elapsedTime:t})}catch(t){this.logger.error("stopWatch Tick事件执行错误",t)}})}}exports.StopWatchTickEventSignal=StopWatchTickEventSignal;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.StopWatchTickEventSignal = void 0;
+const index_js_1 = require("../../../utils/index.js");
+class StopWatchTickEventSignal {
+    tickCallbacks = new Set();
+    logger = new index_js_1.Logger(this.constructor.name);
+    constructor() { }
+    /** 注册一个在每次时间增加（每秒）时执行的回调函数*/
+    subscribe(callback) {
+        this.tickCallbacks.add(callback);
+        return {
+            unsubscribe: () => {
+                this.tickCallbacks.delete(callback);
+            },
+        };
+    }
+    publish(elapsedTime) {
+        this.tickCallbacks.forEach((cb) => {
+            try {
+                cb({ elapsedTime: elapsedTime });
+            }
+            catch (err) {
+                this.logger.error("stopWatch Tick事件执行错误", err);
+            }
+        });
+    }
+}
+exports.StopWatchTickEventSignal = StopWatchTickEventSignal;

package/lib/modules/create-game/src/gameComponent/common/timer/onTimeEvent.js

@@ -1 +1,36 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.TimerOnTimeEventSignal=void 0;const logger_js_1=require("../../../utils/logger.js");class TimerOnTimeEventSignal{logger=new logger_js_1.Logger(this.constructor.name);events=[];subscribe(e,t){const s={time:t.time,callback:e,once:t.once??!0};return this.events.push(s),{unsubscribe:()=>{this.events=this.events.filter(e=>e!==s)}}}checkAndFireTimeEvents(e){const t=this.events.filter(t=>e===t.time);t.forEach(e=>{try{e.callback()}catch(e){this.logger.error("执行timer事件失败:",e)}}),this.events=this.events.filter(e=>!e.once||!t.includes(e))}}exports.TimerOnTimeEventSignal=TimerOnTimeEventSignal;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimerOnTimeEventSignal = void 0;
+const logger_js_1 = require("../../../utils/logger.js");
+class TimerOnTimeEventSignal {
+    logger = new logger_js_1.Logger(this.constructor.name);
+    events = [];
+    subscribe(callback, options) {
+        const event = {
+            time: options.time,
+            callback,
+            once: options.once ?? true,
+        };
+        this.events.push(event);
+        return {
+            unsubscribe: () => {
+                this.events = this.events.filter((e) => e !== event);
+            },
+        };
+    }
+    /**检查并触发到达时间的事件*/
+    checkAndFireTimeEvents(time) {
+        const eventsToFire = this.events.filter((event) => time === event.time);
+        eventsToFire.forEach((event) => {
+            try {
+                event.callback();
+            }
+            catch (e) {
+                this.logger.error("执行timer事件失败:", e);
+            }
+        });
+        // 如果配置为once，则在执行后移除
+        this.events = this.events.filter((event) => !event.once || !eventsToFire.includes(event));
+    }
+}
+exports.TimerOnTimeEventSignal = TimerOnTimeEventSignal;

package/lib/modules/create-game/src/gameComponent/common/timer/tickEvent.js

@@ -1 +1,29 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.TimerTickEventSignal=void 0;const index_js_1=require("../../../utils/index.js");class TimerTickEventSignal{tickCallbacks=new Set;logger=new index_js_1.Logger(this.constructor.name);constructor(){}subscribe(e){return this.tickCallbacks.add(e),{unsubscribe:()=>{this.tickCallbacks.delete(e)}}}publish(e){this.tickCallbacks.forEach(i=>{try{i({remainingTime:e})}catch(e){this.logger.error("timer Tick事件执行错误",e)}})}}exports.TimerTickEventSignal=TimerTickEventSignal;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TimerTickEventSignal = void 0;
+const index_js_1 = require("../../../utils/index.js");
+class TimerTickEventSignal {
+    tickCallbacks = new Set();
+    logger = new index_js_1.Logger(this.constructor.name);
+    constructor() { }
+    /** 注册一个在每次时间减少（每秒）时执行的回调函数*/
+    subscribe(callback) {
+        this.tickCallbacks.add(callback);
+        return {
+            unsubscribe: () => {
+                this.tickCallbacks.delete(callback);
+            },
+        };
+    }
+    publish(remainingTime) {
+        this.tickCallbacks.forEach((cb) => {
+            try {
+                cb({ remainingTime: remainingTime });
+            }
+            catch (err) {
+                this.logger.error("timer Tick事件执行错误", err);
+            }
+        });
+    }
+}
+exports.TimerTickEventSignal = TimerTickEventSignal;

package/lib/modules/create-game/src/gameComponent/common/timer/timer.js

@@ -1 +1,87 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.Timer=void 0;const main_js_1=require("../../../main.js"),gameComponent_js_1=require("../../gameComponent.js"),onTimeEvent_js_1=require("./onTimeEvent.js"),tickEvent_js_1=require("./tickEvent.js");class Timer extends gameComponent_js_1.GameComponent{remainingTime=0;_isRunning=!1;lastTime=0;events={tick:new tickEvent_js_1.TimerTickEventSignal,onTime:new onTimeEvent_js_1.TimerOnTimeEventSignal};get time(){return this.remainingTime}get isRunning(){return this._isRunning}onAttach(){this.set(this.options?.initialTime??0),this.subscribe(main_js_1.Game.events.interval,()=>{if(!this._isRunning)return;const i=Date.now(),e=i-this.lastTime;if(e>=1e3){if(this.remainingTime<=0)return void(this._isRunning=!1);if(this.options?.compensate){const i=Math.floor(e/1e3);this.remainingTime-=i,this.lastTime+=1e3*i}else this.remainingTime-=1,this.lastTime=i;this.events.tick.publish(this.remainingTime),this.events.onTime.checkAndFireTimeEvents(this.remainingTime)}}),this.options?.autoStart&&this.start()}onDetach(){this._isRunning=!1,super.onDetach(),this.state.eventManager.unsubscribeByEvent(this.events.onTime),this.state.eventManager.unsubscribeByEvent(this.events.tick)}set(i){this.remainingTime=Math.max(0,i),this.lastTime=Date.now()}stop(){this._isRunning=!1}start(){this.remainingTime>0&&!this._isRunning&&this.isAttached&&(this._isRunning=!0,this.lastTime=Date.now(),this.events.tick.publish(this.remainingTime),this.events.onTime.checkAndFireTimeEvents(this.remainingTime))}}exports.Timer=Timer;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Timer = void 0;
+const main_js_1 = require("../../../main.js");
+const gameComponent_js_1 = require("../../gameComponent.js");
+const onTimeEvent_js_1 = require("./onTimeEvent.js");
+const tickEvent_js_1 = require("./tickEvent.js");
+class Timer extends gameComponent_js_1.GameComponent {
+    remainingTime = 0;
+    _isRunning = false;
+    lastTime = 0;
+    events = {
+        tick: new tickEvent_js_1.TimerTickEventSignal(),
+        onTime: new onTimeEvent_js_1.TimerOnTimeEventSignal(),
+    };
+    /** 获取当前剩余时间 */
+    get time() {
+        return this.remainingTime;
+    }
+    /**获取计时器是否正在运行*/
+    get isRunning() {
+        return this._isRunning;
+    }
+    /**
+     * 组件被附加到游戏对象时调用
+     */
+    onAttach() {
+        this.set(this.options?.initialTime ?? 0);
+        // 订阅游戏的tick事件，这是驱动计时器的核心
+        this.subscribe(main_js_1.Game.events.interval, () => {
+            if (!this._isRunning) {
+                return;
+            }
+            const now = Date.now();
+            const diff = now - this.lastTime;
+            if (diff >= 1000) {
+                if (this.remainingTime <= 0) {
+                    this._isRunning = false;
+                    return;
+                }
+                if (this.options?.compensate) {
+                    // 严格按真实时间走，补偿丢失的秒数
+                    const steps = Math.floor(diff / 1000);
+                    this.remainingTime -= steps;
+                    this.lastTime += steps * 1000;
+                }
+                else {
+                    // 不补偿，直接视为 1 秒过去
+                    this.remainingTime -= 1;
+                    this.lastTime = now;
+                }
+                // 执行每一秒的回调
+                this.events.tick.publish(this.remainingTime);
+                // 检查并执行特定时间点的事件
+                this.events.onTime.checkAndFireTimeEvents(this.remainingTime);
+            }
+        });
+        if (this.options?.autoStart) {
+            this.start();
+        }
+    }
+    onDetach() {
+        this._isRunning = false;
+        super.onDetach();
+        this.state.eventManager.unsubscribeByEvent(this.events.onTime);
+        this.state.eventManager.unsubscribeByEvent(this.events.tick);
+    }
+    /** 设置计时器的当前时间 */
+    set(time) {
+        this.remainingTime = Math.max(0, time);
+        this.lastTime = Date.now();
+    }
+    /**停止计时器 */
+    stop() {
+        this._isRunning = false;
+    }
+    /**启动计时器 */
+    start() {
+        if (this.remainingTime > 0 && !this._isRunning && this.isAttached) {
+            this._isRunning = true;
+            this.lastTime = Date.now();
+            this.events.tick.publish(this.remainingTime);
+            this.events.onTime.checkAndFireTimeEvents(this.remainingTime);
+        }
+    }
+}
+exports.Timer = Timer;

package/lib/modules/create-game/src/gameComponent/gameComponent.js

@@ -1 +1,53 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.GameComponent=void 0;class GameComponent{options;_isAttached=!1;get isAttached(){return this._isAttached}state;tag;get context(){return this.state.context}get runner(){return this.state.runner}constructor(t,e,s){this.options=e,this.state=t,this.tag=s}_onAttach(){try{this._isAttached=!0,this.onAttach()}catch(t){throw this._isAttached=!1,t}}_onDetach(){this.state.eventManager.unsubscribeBySubscriber(this),this.onDetach(),this._isAttached=!1}onDetach(){}subscribe(t,...e){if(this.isAttached)return this.state.eventManager.subscribe(this,t,...e)}unsubscribe(t){this.state.eventManager.unsubscribe(t)}}exports.GameComponent=GameComponent;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameComponent = void 0;
+class GameComponent {
+    options;
+    _isAttached = false;
+    /**是否已经attach */
+    get isAttached() {
+        return this._isAttached;
+    }
+    state;
+    /**tag */
+    tag;
+    get context() {
+        return this.state.context;
+    }
+    get runner() {
+        return this.state.runner;
+    }
+    constructor(state, options, tag) {
+        this.options = options;
+        this.state = state;
+        this.tag = tag;
+    }
+    _onAttach() {
+        try {
+            this._isAttached = true;
+            this.onAttach();
+        }
+        catch (err) {
+            this._isAttached = false;
+            throw err;
+        }
+    }
+    _onDetach() {
+        this.state.eventManager.unsubscribeBySubscriber(this);
+        this.onDetach();
+        this._isAttached = false;
+    }
+    /**随便重写 */
+    onDetach() { }
+    /**订阅事件 */
+    subscribe(event, ...args) {
+        if (!this.isAttached)
+            return;
+        return this.state.eventManager.subscribe(this, event, ...args);
+    }
+    /**取消订阅 */
+    unsubscribe(sub) {
+        this.state.eventManager.unsubscribe(sub);
+    }
+}
+exports.GameComponent = GameComponent;

package/lib/modules/create-game/src/gameComponent/index.js

@@ -1 +1,31 @@
-"use strict";var __createBinding=this&&this.__createBinding||(Object.create?function(e,r,t,o){void 0===o&&(o=t);var n=Object.getOwnPropertyDescriptor(r,t);n&&!("get"in n?!r.__esModule:n.writable||n.configurable)||(n={enumerable:!0,get:function(){return r[t]}}),Object.defineProperty(e,o,n)}:function(e,r,t,o){void 0===o&&(o=t),e[o]=r[t]}),__exportStar=this&&this.__exportStar||function(e,r){for(var t in e)"default"===t||Object.prototype.hasOwnProperty.call(r,t)||__createBinding(r,e,t)};Object.defineProperty(exports,"__esModule",{value:!0}),exports.GameComponent=void 0,__exportStar(require("./view/infoScoreboard.js"),exports),__exportStar(require("./common/lazyLoader.js"),exports),__exportStar(require("./common/timer/timer.js"),exports),__exportStar(require("./common/stopWatch/stopWatch.js"),exports);var gameComponent_js_1=require("./gameComponent.js");Object.defineProperty(exports,"GameComponent",{enumerable:!0,get:function(){return gameComponent_js_1.GameComponent}}),__exportStar(require("./player/blockInteractionBlocker.js"),exports),__exportStar(require("./player/entityInteractionBlocker.js"),exports),__exportStar(require("./region/regionProtecter.js"),exports),__exportStar(require("./region/regionTeamChooser.js"),exports),__exportStar(require("./region/regionTeamCleaner.js"),exports),__exportStar(require("./view/teamScoreboard.js"),exports),__exportStar(require("./player/healthIndicator.js"),exports),__exportStar(require("./player/regionMonitor.js"),exports);
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GameComponent = void 0;
+__exportStar(require("./view/infoScoreboard.js"), exports);
+__exportStar(require("./common/lazyLoader.js"), exports);
+__exportStar(require("./common/timer/timer.js"), exports);
+__exportStar(require("./common/stopWatch/stopWatch.js"), exports);
+var gameComponent_js_1 = require("./gameComponent.js");
+Object.defineProperty(exports, "GameComponent", { enumerable: true, get: function () { return gameComponent_js_1.GameComponent; } });
+__exportStar(require("./player/blockInteractionBlocker.js"), exports);
+__exportStar(require("./player/entityInteractionBlocker.js"), exports);
+__exportStar(require("./region/regionProtecter.js"), exports);
+__exportStar(require("./region/regionTeamChooser.js"), exports);
+__exportStar(require("./region/regionTeamCleaner.js"), exports);
+__exportStar(require("./view/teamScoreboard.js"), exports);
+__exportStar(require("./player/healthIndicator.js"), exports);
+__exportStar(require("./player/regionMonitor.js"), exports);

package/lib/modules/create-game/src/gameComponent/player/blockInteractionBlocker.js

@@ -1 +1,40 @@
-"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.BlockInteractionBlocker=void 0;const server_1=require("@minecraft/server"),main_js_1=require("../../main.js");class BlockInteractionBlocker extends main_js_1.GameComponent{onAttach(){if(!this.options)return;const{groupSet:e,blockIds:t,blockComponentType:o,showMessage:r=!0,message:n}=this.options;this.subscribe(server_1.world.beforeEvents.playerInteractWithBlock,s=>{const{player:c,block:i}=s;if(e.findById(c.id)&&(!(t&&t.length>0)||t.includes(i.typeId))){if(o){if(!i.getComponent(o))return}s.cancel=!0,r&&server_1.system.run(()=>c.onScreenDisplay.setActionBar(n??"§c你无法与该方块交互！"))}})}}exports.BlockInteractionBlocker=BlockInteractionBlocker;
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BlockInteractionBlocker = void 0;
+const server_1 = require("@minecraft/server");
+const main_js_1 = require("../../main.js");
+/**
+ * 通用方块交互阻止组件
+ */
+class BlockInteractionBlocker extends main_js_1.GameComponent {
+    onAttach() {
+        if (!this.options)
+            return;
+        const { groupSet, blockIds, blockComponentType, showMessage = true, message, } = this.options;
+        this.subscribe(server_1.world.beforeEvents.playerInteractWithBlock, (t) => {
+            const { player, block } = t;
+            // 1️⃣ 不在限制组内 -> 放行
+            if (!groupSet.findById(player.id))
+                return;
+            // 2️⃣ 若设置 blockIds，则仅匹配这些方块
+            if (blockIds &&
+                blockIds.length > 0 &&
+                !blockIds.includes(block.typeId)) {
+                return;
+            }
+            // 3️⃣ 若设置 blockComponentType，则仅匹配拥有该组件的方块
+            if (blockComponentType) {
+                const comp = block.getComponent(blockComponentType);
+                if (!comp)
+                    return; // 若该方块没有该组件 -> 放行
+            }
+            // 4️⃣ 阻止交互
+            t.cancel = true;
+            // 5️⃣ 提示
+            if (showMessage) {
+                server_1.system.run(() => player.onScreenDisplay.setActionBar(message ?? "§c你无法与该方块交互！"));
+            }
+        });
+    }
+}
+exports.BlockInteractionBlocker = BlockInteractionBlocker;