Java 专服快速开始

适用对象

管理 Minecraft Java 专用服务器，并希望由 Alice 控制服务端 Carpet 假人的服主或管理员。

支持状态与验证版本

• 已支持：Minecraft 1.21.4 Fabric 专服，Java 21。
• 验证依赖：Fabric Loader 0.16.10、Fabric API 0.119.4+1.21.4、Carpet 1.4.161、Alice Mod。
• 已知限制：Java Adapter 当前固定连接 127.0.0.1:27541，因此 Alice 桌面应用与 Java 专服必须同机运行；跨主机部署不是当前支持路径。

前置条件

• 一台可运行 Windows Alice 桌面应用和 Java 21 服务端的主机。
• 已备份现有世界，并能访问服务端 mods 目录和控制台。
• 已取得与 Minecraft 1.21.4 匹配的 Fabric API、Carpet 和 Alice Mod JAR。
• 已阅读 下载与支持平台，并准备可测试的模型。

步骤

1. 使用 Java 21 准备 Minecraft 1.21.4 Fabric 专用服务器，Fabric Loader 使用 0.16.10。

2. 停止服务端，将 Fabric API、Carpet 和 Alice Mod JAR 放入服务端 mods 目录。三者均为必需项。

3. 在同一台主机启动 Alice，并在“模型”页面添加模型、执行“测试连接”。

4. 启动 Java 服务端，等待世界完全加载。Alice Mod 会在服务端世界上下文连接同机 127.0.0.1:27541。

5. 在服务端控制台或有权限的游戏账号中执行：

   /alice status

6. 确认状态显示已连接，然后在 Alice 中接受或选择自动发现的实例/工作区。

7. 创建智能体，选择主模型并绑定该工作区。

8. 先发送只读请求验证工具注册，再执行会改变世界的任务。

成功标志

• 服务端日志确认 Fabric API、Carpet 和 Alice Mod 均已加载。
• /alice status 返回 Alice Mod 运行状态，TCP 连接正常。
• Alice 中出现该 Java 服务端实例及已注册工具。
• 智能体绑定工作区后可完成一次只读工具调用。

常见失败

• 服务端无法启动：确认使用 Java 21 和 Minecraft 1.21.4，不要混用客户端专用模组或不同游戏版本的依赖。
• /alice status 不存在：检查 Alice Mod 是否在服务端的 mods 目录，而不是只装在管理员客户端。
• TCP 连接被拒绝：先在同机启动 Alice，检查端口 27541 占用和本机防火墙。
• Alice 位于另一台机器：当前 Adapter 固定使用 127.0.0.1:27541，文档没有可用的跨主机配置步骤；请把 Alice 与服务端移到同机。
• 实例出现但认证或工具注册失败：查看双方日志，重启 Alice 与服务端以重新握手，不要手工伪造实例文件或 token。

下一步

• 使用 安装验证 检查模型、实例、智能体和首次工具调用。
• 更换为本地世界时，阅读 Java 单机快速开始。