部署与运维Java 版

Java 版部署

Java Adapter 是 Minecraft 1.21.4 的 Fabric 模组，在单人世界或 Fabric 专服中激活世界上下文，并通过 Carpet 假人执行工具。

需求

组件当前要求
Minecraft1.21.4
Java21
模组加载器Fabric Loader
必需模组Fabric API、Carpet、Alice Mod
Agent CoreWindows Alice，与游戏或专服同机
连接目标固定 127.0.0.1:27541

Carpet 是必需依赖，不是可选增强。安装前备份世界，并确认所有 JAR 都与 Minecraft 1.21.4 匹配。

架构

Alice（同机 TCP 服务） ← 127.0.0.1:27541 ← Alice Fabric Mod
                                              ├─ /alice 指令
                                              ├─ Carpet 假人
                                              └─ <游戏根目录>/Alice/

模组同时适用于集成服务器与专用服务器；连接远程服务器的普通客户端不会激活服务端世界上下文。运行数据位于游戏根目录的 Alice/，包括实例身份、配置、日志及按世界隔离的 SQLite 数据。不要沿用旧目录或旧命令教程。

执行

安装

  1. 使用 Java 21 准备 Minecraft 1.21.4 Fabric 实例或专服。
  2. 完全停止游戏或服务端。
  3. 将 Fabric API、Carpet 与 Alice Mod JAR 一并放入该实例的 mods 目录。
  4. 在同一台 Windows 主机先启动 Alice，并完成模型测试。
  5. 启动游戏进入本地世界，或启动 Fabric 专服并等待世界加载。

验证

在游戏或服务端控制台执行：

/alice status

需要管理配置时使用 /alice config get、/alice config set、/alice config list 与 /alice reload。成功标志是命令存在、状态正常、Alice 中出现实例且工具完成动态注册；不要用固定工具数量判断。

故障处理

  • 命令不存在：确认 Alice Mod 位于实际运行实例的 mods，并核对 Fabric 加载日志。
  • 启动报依赖错误：核对 Java 21、Minecraft 1.21.4、Fabric API 与 Carpet。
  • 连接拒绝：确认 Alice 已在同机启动，再检查 27541；参见 连接问题。
  • 跨机器部署：当前不支持，不要尝试通过旧配置改远程地址。
  • 数据异常：停止双方后备份 Alice/，参见 数据备份。

按场景继续：Java 单机快速开始 · Java 专服快速开始 · Java 问题

Agent CoreBedrock 版