开始使用Java 单机快速开始

Java 单机快速开始

适用对象

希望在本机 Minecraft Java 单人世界或“对局域网开放”的本地世界中运行 Alice 智能体的 Windows 用户。

支持状态与验证版本

  • 已支持：Minecraft 1.21.4、Java 21。
  • 验证依赖：Fabric Loader 0.16.10、Fabric API 0.119.4+1.21.4、Carpet 1.4.161、Alice Mod。
  • Fabric API、Carpet 与 Alice Mod 都是必需模组。

前置条件

  • 已安装并能启动 Alice Windows 桌面应用。
  • 已准备独立的 Minecraft 1.21.4 Fabric 实例，并确认使用 Java 21。
  • 已取得与 1.21.4 匹配的 Fabric API、Carpet 和 Alice Mod JAR。
  • Alice 和 Minecraft 必须运行在同一台电脑上；Alice Mod 当前连接固定为 127.0.0.1:27541。

步骤

  1. 在启动器中创建 Minecraft 1.21.4 Fabric 实例，Fabric Loader 使用 0.16.10。

  2. 将 Fabric API、Carpet 和 Alice Mod 的 JAR 一同放入该实例的 mods 目录。

  3. 先启动 Alice，进入“模型”页面添加模型，并执行“测试连接”。

  4. 启动 Minecraft，进入一个单人世界。Alice Mod 在服务端世界上下文加载，而不是仅靠客户端界面工作。

  5. 在游戏聊天框执行：

    /alice status

  6. 确认状态输出显示 Alice Mod 正常运行并已连接；回到 Alice，选择自动发现的实例/工作区。

  7. 点击“创建智能体”，选择已测试的主模型并绑定当前工作区，完成向导。

  8. 向智能体发送只读测试请求，例如“描述当前周围环境”。

成功标志

  • Minecraft 模组列表中 Fabric API、Carpet 和 Alice Mod 均已加载。
  • /alice status 可执行并显示 TCP 已连接。
  • Alice 中出现当前 Java 世界对应的实例/工作区。
  • 智能体完成一次工具调用并返回环境描述。

常见失败

  • 游戏启动崩溃或提示版本不匹配：确认 Minecraft 为 1.21.4、运行时为 Java 21，且三个模组都对应此版本。
  • 提示缺少 Carpet 或 Fabric API：两者都是必需依赖，不能只安装 Alice Mod。
  • /alice status 不存在：Alice Mod 没有加载到当前实例；检查是否放错 mods 目录。
  • 状态显示未连接：先启动 Alice，并确认本机端口 27541 没有被其他程序占用。不要尝试把地址改成远程主机；当前同机目标固定为 127.0.0.1:27541。
  • 连接远程 Java 服务器后没有控制能力：执行端必须安装在远程服务器的服务端世界中；仅客户端安装不能控制远端世界，请改用 Java 专服快速开始。

下一步

下载与支持平台Java 专服快速开始