事件规范
本模组的事件监听有以下规则和限制。
仅支持服务端事件
所有引擎事件名可以在 网易事件文档 中查到。本模组仅支持服务端事件(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。
