Skip to content

事件规范

本模组的事件监听有以下规则和限制。

仅支持服务端事件

所有引擎事件名可以在 网易事件文档 中查到。本模组仅支持服务端事件(Server 结尾或服务端专用事件),客户端事件无法监听。

禁止注册的事件

CustomCommandTriggerServerEvent 禁止通过 /lktevent add 注册。

OnMCTick

OnMCTick 是本模组内部实现的 tick 事件,在原版 ModSDK 中不存在。跟随服务端游戏刻走,最高一秒 20 次。ModSDK 原版的 OnScriptTickServer 则是一秒 30 次。

以下是一个用 globals 做计数器的示例(不需要高频执行的逻辑可以降频):

kotlin
var tick = globals["timer"]
if (tick == null) { globals["timer"] = 0; tick = 0 }
globals["timer"] = tick + 1

// 每 200 刻(约 10 秒)执行
if (tick % 200 == 0) {
    println("定时任务,刻数:$tick")
}

事件验证

/lktevent add 会校验事件名是否为已知的服务端引擎事件。输入不存在或不被支持的事件名将被拒绝。

持久化

事件监听器保存在世界自定义数据中,服务器重启后自动恢复。移除书籍不会自动取消监听,事件触发时找不到书只是静默跳过。要真正取消监听,必须用 /lktevent remove