MinecraftCodex 开源项目教程

1. 项目介绍

MinecraftCodex 是一个开源项目，由微软开发，它使用 GPT-3 Codex 来驱动 Minecraft 中的非玩家角色（NPC）。通过“提示工程”的技巧，该项目展示了模型如何使用 Minecraft 的 SimulatedPlayer API 编写代码来进行导航、挖掘、制作物品甚至进行对话。

2. 项目快速启动

环境准备

• OpenAI 账户及 API Key

• OpenAI 组织 ID（如果有多个组织，请将默认组织更新为可以访问 codex 引擎的组织）

• OpenAI 模型 ID（该项目主要使用 code-davinci-002，但目前可能需要使用 text-davinci-002）

• Minecraft 所有者权限或 PC GamePass

• Minecraft Bedrock Edition 和 Minecraft Bedrock Dedicated Server

• LTS 16.15 版本的 Node.JS

• Visual Studio Code

克隆仓库

首先，克隆 MinecraftCodex 仓库到本地：

git clone https://github.com/microsoft/MinecraftCodex.git

安装依赖

在 Visual Studio Code 中打开项目文件夹，运行以下命令安装依赖：

npm install

配置变量

在 scripts 文件夹中创建一个名为 vars.ts 的文件，并填入以下内容，替换 <YOUR_KEY_HERE>、<YOUR_ORG_ID_HERE> 和 <YOUR_CODEX_MODEL_NAME_HERE> 为实际值：

export let OPENAI_API_KEY = "<YOUR_KEY_HERE>";
export let OPENAI_ORGANIZATION_ID = "<YOUR_ORG_ID_HERE>";
export let OPENAI_ENGINE_ID = "<YOUR_CODEX_MODEL_NAME_HERE>";
export let DEBUG = false;

设置 Minecraft Bedrock Dedicated Server

下载并解压 Minecraft Bedrock Dedicated Server 到硬盘上的某个位置。在项目目录中的 gulpfile.js 文件中，更新 dedicatedServerPath 变量为你的服务器文件夹路径，注意路径末尾需要有一个反斜杠。

在 VSCode 终端中运行以下命令来关闭 PowerShell 签名要求：

Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

接着运行以下命令来配置服务器：

gulp updateconfig
gulp updateserver
gulp updateworld

最后，使用以下命令启动服务器：

gulp serve

3. 应用案例和最佳实践

• 导航和交互：展示如何使用 SimulatedPlayer API 编写代码，让 NPC 在 Minecraft 世界中自由导航并与环境交互。
• 挖掘与建造：演示如何让 NPC 自动挖掘资源并建造结构。
• 对话系统：介绍如何实现一个简单的对话系统，让 NPC 能够与玩家交流。

4. 典型生态项目

• Minecraft Mod 开发：探索如何使用 MinecraftCodex 来辅助开发 Minecraft 的模组。
• 教育工具：将 MinecraftCodex 作为一个教育工具，教授编程和游戏开发。
• AI 驱动的游戏体验：结合 AI 技术创建更加智能和动态的游戏体验。