如何使用 AI + Thrixel 在 Roblox 中製作遊戲

開始前，需要安裝 Roblox Studio，並準備一個 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，請在終端機執行對應作業系統的命令：

curl -LsSf https://astral.sh/uv/install.sh | sh

irm https://astral.sh/uv/install.ps1 | iex

執行下方的登入命令。瀏覽器頁面開啟後，點選 Approve 以連結 Thrixel 帳號。

uvx thrixel-mcp@latest login

安裝 Build World

在下方選擇程式設計代理。Build World 同時需要提供操作指引的技能，以及提供資產產生工具的 Thrixel MCP 伺服器。

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

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

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

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

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"

gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/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，然後新增遊戲描述。

/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 發布。