玩家事件

基本信息

20 个事件类型

全部命名空间为 minetweaker.event.*，Java 类名见下表左列：

「5 个触发」如何核实

grep -rn 'events\.publish' src/main/java 全仓只有 5 处命中，全部在两个 handler 里：

两个 handler 在预初始化期注册（MineTweakerMod.java:136-137）：

MinecraftForge.EVENT_BUS.register(new ForgeEventHandler());
FMLCommonHandler.instance().bus().register(new FMLEventHandler());

对另外 15 个事件，逐个统计「除自身类文件与 MTEventManager.java 外的引用数」，结果全部为 1，且那唯一一处都是 IEventManager 的接口方法声明。例如：

$ grep -rn '\bPlayerAttackEntityEvent\b' src/main/java | grep -v MTEventManager | grep -v 'api/event/PlayerAttackEntityEvent.java'
src/main/java/minetweaker/api/event/IEventManager.java:24:    IEventHandle onPlayerAttackEntity(IEventHandler<PlayerAttackEntityEvent> ev);

即：类型已注册、on* 订阅方法已实现、EventList 已分配，但没有任何 publish* 调用，事件永远不会到达脚本。这是 API 迁移留下的空壳，不是可用功能。

MTEventManager 的实现范围

MTEventManager 为全部 20 个事件各实现三件套（MTEventManager.java:78-390）：

• onXxx(IEventHandler<XxxEvent>) → IEventHandle
• hasXxx() → boolean
• publishXxx(XxxEvent) → void

clear()（:51-72）清空全部 20 个 EventList，由 reload() 步骤 2 调用（MineTweakerImplementationAPI.java:638），所以脚本订阅的事件监听器每次重载都会被清掉，必须写在脚本里重新注册。

缺陷：publishPlayerPickup 存在两个重载

MTEventManager 里 publishPlayerPickup 出现两次，靠参数类型区分：

第二个名字应为 publishPlayerPickupXp。因为两个都是 0 调用方（见上节），目前无实际影响，但对阅读代码的人极具误导性。

事件句柄

IEventHandle（api/event/IEventHandle.java:12-13）标注 @ZenClass("minetweaker.event.IEventHandler")（注意脚本名与 Java 类名不同），继承 java.io.Closeable，只有 1 个 @ZenMethod：

@ZenMethod
@Override
void close();

脚本里保存 events.onPlayerCrafted(...) 的返回值即可用 .close() 取消订阅。

处理器实现

相关条目

• 事件管理器可达性 - events 全局符号的类型注册问题
• 类型系统与扩展 - IEventManager 未标注 @ZenClass
• 重载生命周期 - events.clear() 每次重载清空订阅