ROBLOX SETUP
任務列表 常見問題
插圖：方塊角色跳向發光嘅平台。
OBBY 示意圖

CURSOR / ROJO / MCP

Roblox Studio
設定教學

連接 Cursor 同 Roblox Studio，由第一次同步程式，到試玩同發布你嘅遊戲。

開始設定 課程範本

設定任務

已完成0 / 5

Studio 開場景同試玩。Cursor 改程式。Rojo 將程式同步去 Studio。MCP 俾 Cursor 嘅 AI 查睇你開緊嘅場景。

任務 01 / 05

安裝工具

用 Windows 或 macOS 電腦，安裝以下兩個程式，再分別登入。

Roblox Studio

開場景、試玩同發布，用你嘅 Roblox 帳戶登入。

下載 Studio ↗

Cursor

開課程資料夾，同 AI 一齊改 Luau 程式，安裝後登入。

下載 Cursor ↗

第一次喺 Studio 試玩

  1. 喺 Studio 首頁嘅模板區揀 Baseplate。你會見到一塊灰色地板同出生點。
  2. 喺上方選單開 Window → Explorer 同 Window → Output。Explorer 係場景嘅物件清單，Output 會顯示程式訊息。
  3. 喺上方揀 Test，按隔籬嘅三角形 Play。見到角色後，用 W、A、S、D 行幾步，再用空白鍵跳一下。
  4. 按上方嘅方形 Stop 返到編輯畫面。保持呢個 Baseplate 開住，任務 03 會用返佢。
喺 Studio 上方揀 Test，再按三角形 Play。
試玩時，按上方嘅方形 Stop。

圖片來源 Roblox Creator Hub

設定 Rojo

任務 02 / 05

設定 Rojo

先喺 Cursor 開課程範本，再啟動 Rojo 同步服務。

  1. 下載範本，開啱資料夾

    去 課程範本 GitHub 頁，按 Code → Download ZIP，然後解壓。

    喺 Cursor 按 File → Open Folder，揀解壓後嘅專案資料夾。同一層應該見到 src/、README.md 同 default.project.json。

    喺 GitHub 按 Code，再揀 Download ZIP。
    Cursor 左邊應該見到呢三個項目。
    見到「Create one now」？

    返 File → Open Folder，揀含有 default.project.json 嗰層。範本已經有設定，可以直接用。

  2. 喺 Cursor 裝 Rojo 擴充功能同服務

    打開 Extensions，搜尋 evaera.vscode-rojo，揀 Rojo 再按 Install。

    按 Ctrl + Shift + PCmd + Shift + P，搜尋 Rojo: Open Menu。見到 Install Rojo now 就按一下。選單顯示版本號就可以繼續。

    用 Extensions 搜尋 Rojo。
    未有 Rojo 服務時，選單會提供安裝選項。
    安裝後仲見到「Not installed」？

    如果安裝程式要求加 Aftman 路徑，將 ~/.aftman/bin 加到你嘅 PATH，再重新開 Cursor。

    完全關閉再開 Cursor，重新開啟專案，再睇 Rojo 選單。

    仍然搵唔到服務，可以跟 Rojo 官方安裝指南 安裝 CLI，再重新開 Cursor。

  3. 啟動同步服務

    喺 Rojo: Open Menu 嘅 Projects 區，按 default.project.json 旁邊嘅開始按鈕。見到 Rojo server listening，記低顯示嘅連接埠，通常係 34872。

    按範本嘅 default.project.json 開始同步。
    有紅色停止按鈕，表示同步服務運行緊。
    已安裝 CLI，可以用終端機

    喺專案資料夾執行以下指令，然後保持終端機開住。

    Terminal 
    rojo serve
連接 Studio

任務 03 / 05

連接 Studio

將 Cursor 嘅專案同步到練習場景，再用 Output 確認程式有執行。

  1. 返去 Baseplate，安裝 Studio 插件

    返任務 01 開好嘅 Baseplate。如果仲試玩緊，先按 Stop。

    返 Cursor，開 Rojo: Open Menu，揀 Install Roblox Studio Plugin。裝好後返 Studio 睇 Plugins 有冇 Rojo。未見到就重新開 Studio，再揀一個新 Baseplate。

    喺 Studio 安裝 Rojo 插件

    按 Home → Toolbox。喺 Creator Store 搜尋 Rojo，揀 Plugins 分類，確認發布者係 Rojo Foundation，再按 Install。

    Creator Store 入面嘅 Rojo 插件。

  2. 輸入本機地址，再按 Connect

    保持 Cursor 嘅 Rojo 服務開住。喺 Studio 按 Plugins → Rojo，填 localhost 同頭先見到嘅連接埠，再按 Connect。

    先確認係練習用嘅 Baseplate。 如果 Rojo 提示確認同步，先核對場景。呢個範本會用電腦上嘅檔案更新三個 Studio 程式位置，當中可能有項目會被移除。開錯場景就按取消，返去新 Baseplate 再連接。

    輸入 localhost 同 Rojo 顯示嘅連接埠。
    見到專案名同 Disconnect，代表已連線。

  3. 改一行字，確認 Rojo 同步成功

    1. 喺 Studio 開 Window → Output，用 Test 模式按 Play。見到 Server started 同 Client started 後按 Stop。
    2. 返 Cursor，喺左邊打開 src/ServerScriptService/Server.server.lua。將引號入面嘅 Server started 改成 Rojo sync works，保留引號，再按 Ctrl + SCmd + S 儲存。
    3. 返 Studio 再按 Play。喺 Output 見到新一行 Rojo sync works，就按 Stop。

    如果睇唔到新訊息，先核對 Studio 嘅 Rojo 面板有冇顯示 Disconnect，再確認 Cursor 已經儲存檔案。

連接 MCP

任務 04 / 05

連接 Studio MCP

讓 Cursor 嘅 AI 讀取 Studio 場景。之後所有程式修改都喺專案嘅 src/ 進行，再由 Rojo 同步。

  1. 喺 Studio 開啟 MCP，再揀 Cursor

    保持 Studio 同練習場景開住。按 Assistant → … → Manage MCP Servers，開啟 Enable Studio as MCP server。如果選單顯示 Settings，入去再揀 MCP Servers。

    展開 Quick connect，開啟 Cursor。返 Cursor 喺側欄開 Customize → MCPs，確認 Roblox Studio 已啟用，再返 Studio 睇有冇綠色嘅 connected clients。數字可能同示範唔同。

    打開 Quick connect，開啟 Cursor，留意綠色連線提示。
    搵唔到 Cursor？用 JSON 手動連接
    1. 喺 Studio 嘅 MCP Servers 展開 Setup instructions，複製 JSON Configuration。
    2. 返 Cursor，打開設定，搜尋 MCP。喺 MCPs 或 Customize → MCP 按 New MCP Server，揀 User。亦可以開全域設定檔 ~/.cursor/mcp.json。
    3. 如果檔案係空白，貼上成段 JSON。已有其他伺服器，就將 Roblox_Studio 呢一項加到現有嘅 mcpServers 入面，再檢查項目之間嘅逗號。
    4. 按 Ctrl + SCmd + S，重新開 Cursor，確認伺服器已啟用。
    複製 Studio 提供嘅 JSON 設定。
    喺 Cursor 新增 MCP 伺服器。

  2. 加一件物件，叫 Cursor 搵返佢

    1. 喺 Studio 按 Stop 結束試玩。喺 Window → Explorer 打開物件清單。
    2. 將滑鼠移到 Workspace，按旁邊嘅 ＋，搜尋並揀 Part。右擊新物件，揀 Rename，輸入 MCP_Check 再按 Enter。
    3. 返 Cursor，開右上方嘅 Agent 對話，貼上以下提示語再按 Enter。若出現工具批准提示，確認係讀取 Roblox Studio 同啱嘅 Baseplate。
    Cursor Agent 
    請用 Roblox Studio MCP 查睇而家開緊嘅 Baseplate。喺 Workspace 搵名叫 MCP_Check 嘅物件，話我知佢嘅完整路徑、ClassName 同 Position。如果讀唔到就話我知。只讀取，請勿修改任何嘢。

    確認回覆係 Workspace.MCP_Check（可能以 game. 開頭），類型係 Part，並確認 Cursor 對話有顯示用咗 Roblox Studio MCP 工具。想再核對，可以喺 Studio 揀返件物件，開 Window → Properties，對照 Position。完成後可以喺 Studio 刪除呢件測試用物件。

發布遊戲

任務 05 / 05

儲存練習遊戲

將 Baseplate 儲存到 Roblox，再喺 Creator Dashboard 搵返佢。

  1. 儲存到 Roblox，搵返你嘅遊戲

    如果試玩緊，先按 Stop，再喺 Studio 揀 File → Publish。部分版本顯示 Publish to Roblox。第一次發布就填 Name，例如 我的 Roblox 練習場，確認擁有者，再按 Save 或 Create。新遊戲預設只開放俾有權限嘅人。

    用同一個 Roblox 帳戶開 Creator Dashboard。喺 Creations → Experiences 搵返自己嘅遊戲，按縮圖開詳細頁。

    想加遊戲簡介、圖示或封面？

    喺 Publish settings → Game details 填名稱同簡介。按圖片角落嘅鉛筆更換圖示。加橫向封面時，揀 Experience Detail Page → Upload thumbnail，最後按 Save Changes。

    左邊係遊戲圖示，右邊係橫向封面。
    用 Upload thumbnail 上載封面。
  2. 選做 · 邀請同學試玩

    喺 Studio 揀 File → Invite early testers，選擇可以邀請嘅好友，再按 Invite。如果 Roblox 顯示年齡檢查或好友資格提示，跟畫面指示處理。喺 Dashboard 嘅 Overview → View on Roblox 開遊戲頁，複製網址俾同學，用自己帳戶試吓入唔入到。

    選做 · 公開俾其他玩家

    到 Publish settings → Manage audience，搵 Release publicly on Roblox，按 Continue。如果見到 Manage access，可以喺入面調整 Playtest 或 Public 設定。

    閱讀年齡限制問題同定義，按玩家實際會遇到嘅內容作答。跟畫面指示完成所需問卷，再確認公開。喺 Cursor 用 AI 幫手寫程式，屬於開發過程。問卷嘅 AI 互動項目係問玩家喺遊戲內實際遇到嘅生成式 AI 互動。

    喺 Publish settings 搵 Manage audience。
    公開時，按 Release publicly on Roblox 旁邊嘅 Continue。

    公開前先睇 Audience reach 同帳戶資格。初次公開可能只開放俾已通過年齡檢查嘅 16 歲或以上玩家。開放俾更年幼嘅玩家要符合額外要求。未符合公開資格時，可以按畫面指示設定試玩權限。查看官方要求 ↗

    如果 Dashboard 仲用舊版選單

    喺 Configure → Questionnaire 按 Start，按實際遊戲內容完成並提交。再去 Configure → Settings → Audience 揀 Public → Save Changes。

    核對公開設定，再分享連結

    返 Overview 核對 Game access 同 Audience reach。按 View on Roblox，再按遊戲頁嘅 Play。有需要就按提示安裝 Roblox 玩家程式。

    複製遊戲頁網址，俾一位符合你所設試玩或公開資格嘅學員用自己帳戶加入，確認連結同權限都正常。

    示範遊戲顯示 Public、Ages 16+ 同 View on Roblox。
常見問題

常見問題

Rojo 連唔到 Studio？

睇 Cursor 嘅 Rojo 服務仲開唔開、兩邊連接埠係咪一樣，同 Studio 插件版本係咪配對。裝咗插件而 Toolbar 未見到，可以重開 Studio。

Rojo 同步咗，但 Output 冇訊息？

確認 Studio 已連到你嘅專案，並喺 Explorer 核對 Server 同 Client 腳本。先按 Stop，再按 Play，睇 Output 有冇錯誤訊息。

MCP 顯示已啟用，但 Cursor 讀唔到？

確認 Studio 同練習場景仍然開住、Cursor 用緊同一部電腦。重新開 Studio 同 Cursor。用手動設定嘅話，核對每個括號同逗號，再用 Studio 提供嘅 JSON 檢查程式路徑。

改完遊戲，點更新同一條連結？

喺 Dashboard 開原本嘅遊戲，按 Edit in Studio。用 Cursor 改 src/ 並用 Rojo 同步，再試玩、按 Stop，最後喺 Studio 發布更新。同時核對遊戲內容有冇影響已填嘅評級答案。

同學開到連結，但入唔到遊戲？

先核對 Game access、Audience reach 同試玩名單。已公開嘅遊戲仍可能有年齡或地區限制。留意同學係咪用啱 Roblox 帳戶。