MineDojo/Voyager项目：Minecraft实例安装完全指南

MineDojo/Voyager项目：Minecraft实例安装完全指南

Voyager An Open-Ended Embodied Agent with Large Language Models 项目地址: https://gitcode.com/gh_mirrors/voya/Voyager

前言

MineDojo/Voyager是一个基于Minecraft环境的AI研究项目，它允许AI智能体在Minecraft世界中进行自主探索和学习。要使用Voyager，首先需要正确配置Minecraft游戏实例。本文将详细介绍两种安装配置方法，帮助研究人员和技术爱好者快速搭建实验环境。

系统要求

在开始安装前，请确保满足以下基本要求：

• 已安装官方Minecraft游戏（版本1.19）
• Python环境（推荐3.8+版本）
• 基本的命令行操作知识

方法一：Azure登录方式（推荐）

这种方法通过Microsoft Azure进行身份验证，具有自动恢复功能，当请求超时时可以自动恢复运行，特别适合长时间运行的实验。

1. Azure应用注册

1. 访问Azure门户并登录您的账户
2. 导航至"Azure Active Directory"服务
3. 选择左侧面板的"应用注册"选项卡
4. 点击"新建注册"按钮

2. 应用配置参数

填写注册表单时，请使用以下配置：

• 名称：自定义您的应用名称
• 支持的账户类型：选择"任何组织目录中的账户(任何Azure AD目录-多租户)和个人Microsoft账户"
• 重定向URI类型：选择"公共客户端/本机(移动和桌面)"
• 重定向URI值：设置为https://127.0.0.1/auth-response

3. 获取关键凭证

注册完成后，您将获得：

• 应用程序(客户端)ID：作为client_id
• [可选]客户端密钥：在"证书和密码"选项卡中创建

4. Minecraft版本确认

导航至您的Minecraft安装目录下的versions文件夹，检查可用版本。Voyager实验使用特定版本：

fabric-loader-0.14.18-1.19

5. 最终配置

将获得的凭证整理为以下Python字典格式：

azure_login = {
    "client_id": "您的客户端ID",
    "redirect_url": "https://127.0.0.1/auth-response",
    "secret_value": "[可选]您的客户端密钥",
    "version": "fabric-loader-0.14.18-1.19",
}

方法二：官方启动器方式

如果您不想使用Azure登录，可以通过官方启动器手动设置：

1. 启动Minecraft官方启动器
2. 选择1.19版本并启动游戏
3. 创建单人游戏世界：
   • 游戏模式：创造模式
   • 难度：和平
4. 进入世界后，按ESC键选择"开放局域网游戏"
5. 确保"允许作弊"选项开启
6. 记下聊天日志中显示的端口号，这将作为mc-port参数

常见问题解答

Q: 为什么推荐使用Azure登录方式？ A: Azure方式提供自动恢复功能，当AI运行出现无限循环导致请求超时时，可以自动恢复实验状态。

Q: 遇到KeyError: 'access_token'错误怎么办？ A: 可以尝试将重定向URI类型从"公共客户端"改为"Web"类型。

Q: 必须使用fabric版本吗？ A: 是的，Voyager的实验都是基于fabric-loader-0.14.18-1.19版本进行的，需要专门安装这个版本。

最佳实践建议

1. 对于长期实验，强烈建议使用Azure登录方式
2. 确保网络连接稳定，特别是使用Azure认证时
3. 定期备份世界存档，防止意外数据丢失
4. 监控系统资源使用情况，Minecraft可能占用较多内存

结语

正确配置Minecraft实例是使用Voyager项目的基础。本文介绍的两种方法各有优势，研究人员可以根据实际需求选择。Azure方式更适合生产环境，而官方启动器方式则更简单直接。无论选择哪种方式，确保按照步骤正确配置，才能获得最佳的研究体验。

Voyager An Open-Ended Embodied Agent with Large Language Models 项目地址: https://gitcode.com/gh_mirrors/voya/Voyager