> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cheart.getvapu.today/llms.txt
> Use this file to discover all available pages before exploring further.

# 安装 & 加载

> 脚本放哪 / 怎么加载

## 脚本目录

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

## 加载顺序

启动或 `.scripts reload` 时，所有 `.bsh` 文件按以下优先级加载：

1. `_` 开头的文件（`_utils.bsh`）
2. 文件名含 `libs` 的（`math_libs.bsh`）
3. 其他文件（按字母序）

先加载的脚本可以通过 [`bridge`](/api/bridge) 把工具方法发布给后面的脚本。

## 命令

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

## 配置持久化

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

## 最小脚本

```java theme={null}
// 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`。