LKT命令引擎 模组文档

Appearance

注意事项 ​

权限要求 ​

  • 使用 /lktrun 和 /lktevent 命令需要管理员权限或为主机玩家
  • 非管理员玩家首次进入游戏时会收到帮助信息（含操作指引）

语言限制 ​

  • 脚本必须以 LittleKt 语法 编写，不支持 Python
  • 书籍代码从所有页面顺序拼接，每页内容之间自动以换行符连接
  • 成书（minecraft:written_book）和书与笔（minecraft:writable_book）均可使用

事件监听器 ​

  • 事件监听器持久化保存在世界自定义数据中，服务器重启后自动恢复
  • 容器中的书籍被移除后，事件触发时对应的监听器自动跳过（不会报错）
  • 同一个事件可以有多个监听器，指向不同容器位置的不同书籍
  • 不可注册 CustomCommandTriggerServerEvent 事件

执行错误 ​

  • 脚本执行错误会以灰色文字显示在服务器聊天栏
  • 错误信息格式：[Lkt] <事件名>: <错误详情>
  • 使用 /lktrun 直接执行时，错误信息会直接作为命令返回结果显示

性能建议 ​

  • OnMCTick（最高 20 次/秒）和 EntityTickServerEvent 等高频事件中避免大量 API 调用或循环，简单逻辑无妨
  • 避免在脚本中执行耗时操作（如大量循环、频繁的 API 调用）
  • 使用 globals 保存需要跨执行共享的状态数据

回调函数 ​

  • createConfirmbox 和 createInputbox 的回调函数为异步执行，在玩家操作后才会触发
  • 回调函数中无法访问原事件的 event 变量（因为此时原事件已结束）

LittleKt 语言 ​

  • 本模组使用 PyKt（Python 2.7 实现）作为 LittleKt 解释器
  • 完整语法请参阅 LittleKt 语言文档