如何使用 AI + Thrixel 在 Roblox 中制作游戏

Thrixel 生成 3D 模型，Build World 指导编程智能体，Rojo 则将游戏代码同步到 Roblox Studio。

开始前，需要安装 Roblox Studio，并准备一个 Roblox 账号。

Build a Gigacorp，一款使用 Thrixel 的 Build World 技能制作的 Roblox 游戏。

1. 使用 VS Code 安装 Rojo

  1. 安装 Visual Studio Code（VS Code）。
  2. 为 VS Code 安装 Rojo - Roblox Studio Sync 扩展。
  3. 在 VS Code 中，选择 File > Open Folder，为游戏打开一个空文件夹。
  4. 按 Ctrl + Shift + P（Mac 上按 Cmd + Shift + P）打开命令面板。输入“Rojo”，然后选择 Rojo: Open Menu。
  5. 如果菜单提示尚未安装 Rojo，点击 Install Rojo now。
  6. 点击 Install Roblox Studio Plugin。如果 Studio 已打开，请重启。随后应能在 Studio 的 Plugins 选项卡中看到 Rojo。

2. 添加 Build World 技能

登录

安装技能前，先登录 Thrixel。所有智能体使用相同的登录命令，并且都需要 uv。如果尚未安装 uv，请在终端运行对应操作系统的命令：

macOS, Linux, WSL 
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows PowerShell 
irm https://astral.sh/uv/install.ps1 | iex

运行下面的登录命令。浏览器页面打开后，点击 Approve 以连接 Thrixel 账号。

登录 Thrixel 
uvx thrixel-mcp@latest login

安装 Build World

在下方选择编程智能体。Build World 同时需要提供操作指引的技能，以及提供资源生成工具的 Thrixel MCP 服务器。

Claude Code

在终端运行这些命令来安装 Thrixel 插件。插件同时包含技能和 MCP 服务器。

终端 
claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

运行 claude plugin list，确认 thrixel@thrixel 已启用。然后运行 claude mcp list，确认 plugin:thrixel:thrixel 已连接。安装后，开启一个新的 Claude Code 会话。

Codex

在终端运行这些命令，将插件安装到 Codex：

终端 
codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

运行 codex plugin list，确认在 Thrixel marketplace 下的 thrixel@thrixel 已安装并启用。运行 codex mcp list，确认 thrixel 已启用。开启一个新的 Codex 会话以加载插件。

对于不支持插件的 Codex 版本，请使用手动安装说明。

Cursor

将此配置添加到 ~/.cursor/mcp.json。如果文件中已有 mcpServers 部分，请将 thrixel 条目添加到其中，不要替换已有条目。

Cursor MCP 配置 
{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

然后使用对应操作系统的命令安装技能：

macOS, Linux, WSL 
git clone https://github.com/thrixel/build-world ~/.thrixel/build-world
mkdir -p ~/.cursor/skills
ln -s ~/.thrixel/build-world/skills/build-world ~/.cursor/skills/build-world
Windows PowerShell 
git clone https://github.com/thrixel/build-world "$HOME\.thrixel\build-world"
New-Item -ItemType Directory -Force "$HOME\.cursor\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.cursor\skills\build-world" -Target "$HOME\.thrixel\build-world\skills\build-world"

重启 Cursor。在 Settings > MCP 中确认存在 thrixel，然后在 Agent 聊天中输入 /，查找 build-world。

Gemini CLI

在终端运行这些命令，注册 Thrixel MCP 服务器并安装技能：

终端 
gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

开启一个新的 Gemini CLI 会话。运行 /mcp，检查是否列出 thrixel；运行 /skills list，检查是否列出 build-world。

Build World 设置指南还介绍了手动安装、更新和已有安装的处理方法。

3. 设置 Roblox Studio

启用 Studio 的 MCP 服务器，让智能体能够在 Studio 中运行代码并截取游戏画面。

  1. 打开 Roblox Studio，新建一个 Baseplate。这会创建一个 place，即保存游戏世界的 Roblox 文件。
  2. 点击窗口右上角的 Assistant 图标。
  3. 在 Assistant 面板中，打开 … > Settings > Manage MCP Servers。开启 Enable Studio as MCP server。绿色指示灯表示服务器正在运行。

4. 创建 Roblox API 密钥

Rojo 不会同步 3D 模型文件。智能体使用 Roblox API 密钥单独上传模型。

  1. 前往你的 Creator Hub 凭据页面，点击 Create API Key。
  2. 在 Access Permissions 下添加 Assets API 系统。选择自己的账号作为所有者，并启用 Read 和 Write。
  3. 在 Accepted IP Addresses 下添加 0.0.0.0/0，或关闭 IP 限制。如果此字段为空，上传将无法完成。
  4. 此密钥允许从任意 IP 地址访问，因此应设置较短的有效期，例如 30 天。
  5. 点击 Save 并复制密钥。密钥只会显示一次。
  6. 将密钥保存在游戏文件夹中的 roblox_api_key.txt 文件内。不要将此文件加入 Git。

5. 运行服务器

从 VS Code 启动服务器

  1. 在 VS Code 中，按 Ctrl + Shift + P（Mac 上按 Cmd + Shift + P）打开命令面板。输入“Rojo”，选择 Rojo: Open Menu。
  2. 如果文件夹中没有 Rojo 项目，点击 Create one now。Rojo 会添加 default.project.json 和游戏的初始文件夹。
  3. 在 Projects in this workspace 下，点击播放图标旁的项目名称。

VS Code 右下角会弹出提示，确认服务器正在 localhost 的 34872 端口监听。要停止服务器，打开 Rojo 菜单，再次点击项目。服务器运行时，播放图标会变为停止图标。

将 Roblox Studio 连接到服务器

  1. 返回 Roblox Studio 中的 Baseplate place。
  2. 打开 Plugins 选项卡，点击 Rojo。
  3. 地址保留为 localhost，端口保留为 34872，除非服务器报告了其他端口。
  4. 点击 Connect。
  5. 在“Sync changes for project”下，检查 Rojo 即将对 place 进行的更改，然后点击 Accept。

Rojo 窗口现在会显示项目名称、服务器地址和 Disconnect 按钮。Studio 已连接，可以接收更改。

如果 Studio 无法连接，请在浏览器中打开 http://localhost:34872/。若出现 Rojo 状态页面，则说明服务器正在运行。

6. 制作游戏

Thrixel Cubes

生成 3D 资源时，Thrixel 会收取 Cubes。总费用取决于所用操作和游戏中的资源数量。有些操作按固定费用收费，有些则按用量计费，在运行后扣费。制作完整游戏也可能消耗编程智能体套餐中的大量额度。开始大型项目之前，请检查余额，并在 Thrixel 网站查看当前费率。

运行 Build World

  1. 在包含 Rojo 项目的文件夹中打开编程智能体。
  2. 以对应智能体的 Build World 命令开始一条消息：
    智能体命令
    Claude Code/thrixel:build-world
    Codex$build-world
    Cursor/build-world
    Gemini CLI/build-world
  3. 在命令后描述游戏。加入“Roblox”，确保技能使用正确的引擎。
  4. 说明 Rojo 已经运行，并注明端口，以免智能体启动第二个服务器。

在 Codex 中，输入 $build，从技能选择器中选择 build-world，然后添加游戏描述。

Claude Code 示例提示词 
/thrixel:build-world 在 Roblox 中制作一款以浮岛为场景的障碍赛游戏。Rojo 和它的 Studio 插件都已设置好，Rojo 正在端口 34872 为此文件夹提供服务，所以不要启动其他服务器。

在 Roblox Studio 中接受更改

首次连接 Rojo 时需要批准更改。连接后，只要智能体将更改保存到磁盘，Rojo 就会进行同步。

  • 连接时：Rojo 会列出文件与 place 之间的差异。点击 Accept 以应用，或点击 Abort 取消连接。如果没有差异，则直接连接，无需确认。
  • 智能体工作时：新增和编辑的脚本会自动出现在 Studio 中。如果 Studio 已关闭或已断开连接，请在智能体提示时再次点击 Connect。智能体无法自行重新连接 Rojo。
  • 检查更改：在 Rojo 窗口中点击上次更改的时间，打开 View changes。其中会列出已应用的更改，并标记失败项。Rojo 更改也会记录在 Studio 的撤销历史中。

要在同步前批量检查更改，打开 Rojo 窗口中的 Settings，将 Confirmation Behavior 设为 Always。点击 Disconnect，等待智能体完成，然后点击 Connect 一起检查更改。此检查发生在连接时。连接期间保存的更改仍会自动同步。

有两件事需要手动处理：

  • 保存导入内容。Rojo 同步脚本和实例。智能体会单独上传 3D 模型，并将其插入 ReplicatedStorage.Assets，因此这些模型不保存在项目文件中。请在 Studio 中使用 File > Save 保存它们。
  • 在项目文件中编辑已同步的脚本。Rojo 默认关闭双向同步。在 Studio 中对这些脚本所做的编辑不会写回文件，并且可能被覆盖。

7. 发布游戏

游戏可以分享时，在 Studio 中使用 File > Publish to Roblox 发布。