Cheart 脚本 - Cheart Scripts

AI / LLM 读者：直接读 LLM Primer

Cheart 支持用 BeanShell 脚本扩展客户端功能。脚本可以注册模块、命令、GUI，订阅事件，调用客户端 API。

示例

@Module(name="Hello", category="PLAYER", defaultEnabled=true)
void meta(valueManager) {
    valueManager.registerSlider("count", "Count", 0, 100, 10);
}

@EventTarget(events="tick")
void onTick(event) {
    me.log("tick, count = " + me.getInt("count"));
}

MCP

MCP服务器为https://docs.cheart.getvapu.today/mcp 您可以使用任何AI工具连接让您的AI助手获得知识库

顶层对象

名字	作用
`me`	玩家 / 世界 / 聊天 / 动作
`moduleManager`	查询 / 操作 cheart 所有模块
`inventory`	背包 / 容器 / slot spoof
`packet`	构造 + 发送 serverbound 包
`notify`	右下角通知
`bridge`	跨脚本共享数据 + 方法调用
`render`	2D GUI 绘制（render_2d / render_screen 里用）
`render3d`	3D 世界绘制（render_3d 里用）

目录

LLM Primer — AI 必读
setup — 脚本位置、加载顺序、命令
examples — 常见模式
API 参考见左侧边栏