外观
接口参考
从按任务开发选择示例，或按下方任务选择专题；已知类名或方法名时，直接查完整 API 目录。原生插件从 Plugin、PluginContext 和 Event 开始，完整项目见第一个插件。
插件运行与业务状态
| 任务 | 参考 |
|---|---|
| 取得上下文、管理异步任务和操作回执 | 插件运行与上下文 · SDK 入门 |
| 保存数据、一起提交事件确认和动作、调用其他插件 | 存储、业务事务与服务 |
| 声明权限、配置与秘密引用 | 权限 · 配置 |
| 订阅事件、启动停止、升级和错误恢复 | 事件 · 生命周期 · 错误与恢复 |
| 分段发送消息、查询每段结果 | 通知 |
玩家、实体与观察
| 任务 | 参考 |
|---|---|
| 解析玩家身份、处理聊天命令、观察进退服与位置 | 玩家与聊天 |
| 读取实体状态、位置与观察来源 | 实体 |
| 观察动作、战斗、投射物、死亡和本机输入 | 动作与战斗观察 |
命令、世界与制品
| 任务 | 参考 |
|---|---|
| 执行命令、查询状态、读写计分板 | 命令与计分板 |
| 读取方块、快照，写入方块、物品与容器 | 世界读写 |
| 上传 BDX 等制品、运行导入任务、查看进度与取消 | 制品与 BDX |
库存、移动与动作
| 任务 | 参考 |
|---|---|
| 读取槽位与装备、移动拆分合并物品 | 库存 |
| 检查容器、转移物品、核对 NBT 与结果 | 容器 |
| 单块挖掘、单次合成 | 挖掘与合成 |
| 有界移动、跳跃与同高静态导航 | 移动与导航 |
| 目标跟踪、瞄准、近战、弩与物品使用 | 目标与战斗控制 · 物品动作 |
协议与外部调用
| 任务 | 参考 |
|---|---|
包描述、零发送预览、编解码、录制、观察与授权发送、ctx.packets.typed | 协议与数据包 |
| 从外部 Python 程序调用本机 HTTP 服务 | HTTP 客户端 |
| 使用现有 ToolDelta、Go 与 Lua 桥接 | 兼容与语言桥接 |
| 查询确切签名、类型字段、兼容层与内部模块归类 | 完整 API 目录 |
选择调用方式
ctx 用于由 Host 启动的插件；外部 Python 程序通过 Client 调用 HTTP 服务。查方法签名和类型字段用 API 目录，查权限、参数和结果处理用对应专题。
操作提交后可以用 ctx.operations.wait() 等待回执。结果为 unknown 时保留原操作 ID 和幂等键，按错误与恢复查询处理，避免重复执行。遇到异常请反馈问题。
原生 Bus 与 Go SDK
新增的 Bus 主题 区分 read、service、持久 op、View 与在线事件，并说明权限和清理。具名 helper 继续保留。本页既有接口不因此改名；独立 Go 插件见 Go SDK，通道选择见 Worker 传输。
Go 的完整公开声明见 Go API 目录，参数语义与回执处理见 Go SDK。
资源会话与远程调用
1.1.0 的资源会话与远程 EP 接口需要配套 Host、SDK 和成员授权。
- 资源会话 Scope：手动申请和关闭、多资源声明、回调包装及操作结果。
- 远程 EP 与投影：可信会话、普通 Bus 调用、观察流恢复和断线处理。