Skip to main content

​
脚本目录

进游戏后用 .scripts folder 命令，会自动打开系统文件管理器定位到脚本目录。把 .bsh 文件放进这个目录就行。

​
加载顺序

启动或 .scripts reload 时，所有 .bsh 文件按以下优先级加载：
  1. _ 开头的文件（_utils.bsh）
  2. 文件名含 libs 的（math_libs.bsh）
  3. 其他文件（按字母序）
先加载的脚本可以通过 bridge 把工具方法发布给后面的脚本。

​
命令

.scripts list             列出所有脚本
.scripts reload           全部重载
.scripts reload <name>    重载一个
.scripts info <name>      详细信息
.scripts folder           在文件管理器打开脚本目录
.scripts events           查看订阅的事件
.scripts help             帮助

​
配置持久化

脚本模块的 enabled 状态、键位绑定、属性值会自动存到 cheart 配置里，下次启动恢复。reload 也保留这些状态。

​
最小脚本

// hello.bsh
@OnLoad void onLoad() { me.log("hello!"); }

@Command(name="hi")
void hi(args) { me.chat("hi " + (args.length > 1 ? args[1] : "world")); }
保存到脚本目录后，进游戏运行 .scripts reload，然后 .hi world。