Skip to main content
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跨脚本共享数据 + 方法调用
render2D GUI 绘制（render_2d / render_screen 里用）
render3d3D 世界绘制（render_3d 里用）

​
目录

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