部署与运维Bedrock 版

Bedrock 版部署

Bedrock Adapter 当前是 Bedrock Dedicated Server 的 Legacy Script Engine(LSE)Node.js 插件,不是现代 LeviLamina 原生插件。

需求

  • 可运行 BDS 的环境,以及兼容的 Legacy Script Engine Node.js 运行时。
  • 完整编译产物,插件根目录至少包含 manifest.json 与编译后的 index.js。
  • manifest.json 类型为 lse-nodejs,依赖包含 legacy-script-engine-nodejs。
  • Windows Alice 与 BDS 同机运行;当前入口固定连接 127.0.0.1:27541。
  • 安装前备份 BDS 世界和插件数据。

Bedrock 接入目前属于实验性能力,BDS 与 LSE 的具体兼容性以实际加载日志为准。

架构

Alice(同机) ← TCP 127.0.0.1:27541 ← LSE Node.js
                                         └─ Bedrock Adapter index.js
                                              └─ BDS / FakePlayer 能力

Adapter 启动后向 Alice 握手并动态注册工具。即使插件配置中出现地址字段,当前部署入口仍按同机固定地址使用;不要把跨主机部署视为已支持。

执行

安装

  1. 停止 BDS,并备份世界和现有插件目录。
  2. 在 BDS 的 LSE 插件目录创建 Adapter 目录。
  3. 复制完整编译产物,保持 manifest.json 与 index.js 位于插件根目录。
  4. 核对 manifest 的 lse-nodejs 类型和 legacy-script-engine-nodejs 依赖。
  5. 先在同机启动 Alice 并测试模型,再启动 BDS。
  6. 观察 BDS 控制台,确认 Node.js 入口加载、TCP 握手及工具注册没有错误。
  7. 在 Alice 中选择新出现的实例,创建或绑定智能体,并发起一次只读查询。

验收与排错

  • 插件未加载:不要按现代 LeviLamina 原生插件目录或 manifest 安装,检查 LSE Node.js 环境与编译后的入口文件。
  • TCP 被拒绝:确认 Alice 先启动且双方同机,随后阅读 网络与端口。
  • 实例在线但工具为空:检查插件启动期的扫描和注册日志,确认复制的不是 TypeScript 源码目录。
  • 修改地址后行为不一致:恢复当前同机路径,不依赖未验证的远程配置。

继续阅读:Bedrock 专服快速开始 · Bedrock 问题 · 工具兼容矩阵