495 的發布說明

體驗

虛擬人偶

素材

範例與專案

引擎 API

開放式雲端 API

Studio

分析

平台

教學

創作者計畫

教育

課程

學習

此方法不同步且會傳回一個「Operation」，代表該操作的目前狀態。其中包含一個端點路徑，您可以輪詢以獲得實際回應和適用的中繼資料。詳情請參閱關於長期執行操作的[說明文件]({longRunningOperationsLink})。
            
以下部分描述操作完成時提供的回應和中繼資料物件。

Beta 測試終點已準備好公開使用。可能出現導致功能無法正常運作的變更，但機率不高。

這些開放式雲端文件頁面將於 2026 年 3 月 31 日移除。屆時，系統會自動將你重新導向至新版開放式雲端文件。{linkStart}瞭解詳情{linkEnd}

這些舊版開放式雲端頁面將於 2026 年 3 月 31 日移除，並重新導向至新頁面。{linkStart}瞭解詳情{linkEnd}

實驗端點已可供公開使用，但隨著 API 合約結束，可能會偶爾發生重大變更。

此終點可在體驗內透過 {httpServiceLinkStart}HttpService{httpServiceLinkEnd} 使用 API 金鑰呼叫。

建立資源時可設定此欄位，但可能無法在後續請求中修改。

建立資源時可設定這些欄位，但可能無法在後續請求中修改。

此欄位可在請求中提供，但永遠不會包含在回應中。

舊版本驗證方法。可用時，請務必使用 API 金鑰或 OAuth 2.0。

每個 API 金鑰：每個 IP 位址每 {periodInSeconds} 秒 {maxInPeriod} 個請求

無需驗證即可呼叫。通常會大幅降低速率限制。可用時，請務必使用 API 金鑰或 OAuth 2.0。

對於每個群組，只需提供架構中下列任一欄位，其餘可省略。

你隨時可以重新加入。{linkStart}歡迎提供回饋。{linkEnd}

你正在檢視舊版文件。{linkStart}歡迎提供回饋。{linkEnd}

你可以隨時選擇退出，並重新導向回舊版參考頁面。{linkStart}歡迎提供任何回饋。{linkEnd}

你正在檢視新版文件。{linkStart}歡迎提供回饋。{linkEnd}

此欄位可在回應中設定，但將在請求中被忽略。

注意：在高流量期間，速率限制可能會降低。部分端點有額外的速率限制。[深入瞭解速率限制]({link})。

使用者或群組所有 API 金鑰每日 {limit} 次要求數

使用者或群組所有 API 金鑰每小時 {limit} 次要求數

使用者或群組所有 API 金鑰每分鐘 {limit} 次要求數

使用者或群組所有 API 金鑰每秒 {limit} 次要求數

每位 API 金鑰擁有者每分鐘 {limit} 次要求數

每位應用程式使用者每日 {limit} 次要求數

每位應用程式使用者每小時 {limit} 次要求數

每位應用程式使用者每分鐘 {limit} 次要求數

每位應用程式使用者每秒 {limit} 次要求數

每位 API 金鑰擁有者每秒 {limit} 次要求數

範圍控制憑證的權限。憑證只能存取你選取的範圍所支援的端點。

穩定終點已準備好投入正式環境，在其生命週期中幾乎不會發生破壞性變更。

此目標可讓你將金鑰存取權限制為所選的{requiredParts}

此目標可讓你將金鑰存取權限制為所選的{requiredParts}和{optionalParts}

目標類型是用來限制憑證對於資源的權限。即使你的帳戶擁有其他資源的權限，也只能對所選資源執行操作。某些操作範圍不包含特定目標部分。在這種情況下，所有相關資源皆可操作。

對於使用者擁有的 API 金鑰，無需選擇宇宙的頂層部分。在這種情況下，你的 API 金鑰將可存取你所擁有的使用者體驗內容，以及你具備正確群組權限的所有群組體驗內容。

「立即試試」功能尚未支援需要 API 金鑰或 OAuth 2.0 驗證的端點

為了安全起見，Cookie 驗證在高風險操作中已停用。

關鍵風險端點極為敏感，為了安全起見，已停用「立即試試」功能

注意：此程式碼範例中不包含驗證標頭資訊。你可能需要為此指令新增驗證標頭，才能正常運作。

這是一個高風險端點，用以修改或刪除關鍵資料。測試時請格外小心。

此 API 端點已被歸類為高風險，且可能會影響即時資料或使用者帳號。

對於高風險 API 的驗證請求，可能會造成無法撤銷的變更。請在繼續之前仔細檢查請求參數。

這是一個低風險端點，用以擷取資料。測試這個端點通常是安全的。

這是一個中等風險端點，用以修改資料。請謹慎地使用非關鍵帳戶測試，因為變更可能是永久性的。

為了確保帳號安全，切勿從其他來源貼上文字，或將此頁面的資訊傳送給其他人。

你即將使用實際帳號憑證來測試已發布的 API 端點。

除非你了解即將進行的 API 呼叫可能涉及的後果，方可繼續操作。在測試之前，請仔細閱讀 API 文件。

API 呼叫將透過你已驗證的工作階段進行

這些皆為實際 API 呼叫，可能會影響你的帳號或資料

部分操作可能會修改或刪除資料

此終點已被這些建議的替代終點取代：

需要以下範圍才能呼叫此端點。若要了解更多
關於產生正確金鑰的資訊，請參閱[管理 API 金鑰]({apiKeyReferenceDocLink})。

若要了解更多關於產生金鑰的資訊，請參閱[管理 API 金鑰]({apiKeyReferenceDocLink})。

根據相對基本網址的路徑，可使用下列終點。

此字串的格式為 [FieldMask](/cloud/reference/types#fieldmask)。

JSON 值可為「null」、「boolean」、「string」、「number」、「array」或「object」。

若想使用此端點，您的 OAuth 2.0 應用程式需要以下範圍。有關如何註冊 OAuth 2.0 應用程式的更多資訊，請查看[應用程式註冊和審查]({oauth2ReferenceDocLink})。

若要了解更多關於如何註冊 OAuth 2.0 應用程式的資訊，請參閱[App 註冊與審核]({oauth2ReferenceDocLink})。

以下物件描述被接受或退回的負載。若要獲得更多關於物件使用時機的資訊，請查看個別終點。

需要以下範圍才能呼叫此端點。

資源路徑

此字串的格式為 [Timestamp](/cloud/reference/types#timestamp)。

若想使用此端點，您的 OAuth 2.0 應用程式需要以下範圍。有關如何註冊 OAuth 2.0 應用程式的更多資訊，請查看 [應用程式註冊和審查]（{oauth2ReferenceDocLink}）。

不推薦

你正在檢視新版 Open Cloud 參考資料。

你已選擇退出新版 Open Cloud 參考資料。

建立、更新並管理你的廣告活動。

這可以查看有關您資產的資訊。

這可以上傳和更新 Roblox 的資產。

這項操作可讓你查看主體（包括群組和體驗）的素材權限，以及帳號可存取的素材。

這會允許授予素材權限給您的帳號可存取的任何對象（包含群組和體驗）及素材。

這項操作可讓你代為檢視虛擬人偶自動設定工作的狀態和結果。

這項操作可讓你代為建立和管理虛擬人偶自動設定工作。

授予更新使用者所擁有之徽章的能力。

這會允許查看您商品的相關資訊。

這麼做可對已同步的商品進行變更。

此操作可讓你檢視商務聯絡對象的資訊。

這會允許對您的商務商家連結進行編輯。

這能讓您檢視您創作者商店商品的相關資訊。

這能讓您修改您創作者商店商品的相關資訊。

這項操作可以讓你查看創作者商店儲存項目的相關資訊。

這項操作可讓你修改創作者商店儲存項目的相關資訊。

授予代為建立資料存儲的存取權。

授予代為刪除資料存儲的權限。

授予讀取資料存儲清單的存取權。

授予為資料存儲拍攝快照的存取權。

授予在資料存儲中建立條目的存取權。

授予標記指定條目以進行刪除的存取權。

授予可列出資料存儲項目的存取權。

授予在資料存儲中讀取指定條目的存取權。

授予更新項目值、屬性和使用者的存取權。

授予可刪除資料存儲條目修訂版的存取權。

授予可列出資料存儲條目修訂版的存取權。

授予可讀取資料存儲條目修訂版的存取權。

授予檢視授權使用者開發者產品設定詳細資訊的權限。

授予編輯授權使用者開發者產品的權限。

這會允許查看您宇宙環境的相關資訊。

授予檢視授權使用者遊戲通行證設定詳細資訊的權限。

授予編輯授權使用者遊戲通行證的權限。

授予檢視帳號社群論壇資訊的權限。

授予管理帳號社群論壇資訊的權限。

這會允許查看您社群的相關資訊。

這能讓您管理自己帳號的社群加入申請和低階社群成員的角色更新。

允許你修改個體的屬性資料（目前僅支援指令碼）。

這可以查看有關您道具欄的資訊。

授予管理使用者資產的存取權。

授予管理您徽章和花費 Robux 的權限。

授予更新授權使用者徽章的權限。

授予管理您開發者產品的權限。

授予存取權限，以讀取你已開啟通知的體驗相關資訊。

授予存取權限，代你開啟或關閉體驗通知。

授予讀取與寫入您在地化表格的權限。

授予管理您擁有之所有體驗的團隊協作權限。

授予管理您的體驗及部分體驗相關資訊（例如：在地化資訊）的權限。

授予讀取您體驗之在地化資訊的權限。

授予修改您體驗在地化偏好的權限。

授予管理您使用者帳號的權限。

授予修改使用者在地化偏好的權限。

允許你檢視關聯地點的 Luau 執行任務狀態、紀錄和結果。

允許你為關聯地點建立新的 Luau 執行任務。

授予非同步清除宇宙中所有資料結構的存取權。

授予建立新佇列項目的存取權。

授予從佇列前端捨棄讀取項目的存取權。

授予從佇列前端讀取項目的權限。

授予讀取記憶存儲項目的存取權。

授予建立、更新和刪除地圖項目的存取權。

給予代替使用者發布訊息的能力。

這能讓您的體驗向使用者傳送通知。

（棄用）授予在已排序資料存儲中讀取條目清單的存取權。

（棄用）授予在已排序資料存儲中建立新條目的存取權。

授予從已排序資料存儲中列出條目的存取權。

授予在已排序資料存儲中建立條目的存取權。

此將允許列出與您的體驗相關的機密資料。

此將允許建立並更新與您的體驗相關的機密資料。

此權限可讓你提交評估工作，並檢視工作結果。

授予讀取您訂閱產品相關資訊的權限。

這項操作可讓你代為讀取縮圖資訊。

授予發佈新版本體驗到 Roblox 的權限。

授予編輯授權使用者體驗的權限。

讓您檢視體驗中的使用者限制。

讓您在體驗中編輯使用者限制。

這項操作將允許檢視傳送至你帳號的通知。

授予讀取權限，查看授權使用者的高級會員與驗證狀態。

此舉可以讓你查看授權使用者的社群帳號。

這將授予讀取您個人檔案資訊的權限。

此函式將允許時將會立刻傳回，但在能傳回值之前可以暫停呼叫自己的執行緒。

深入瞭解{linkStart}功能{linkEnd}。

Roblox 已不再支援或維護 {nameStart}name{nameEnd}。

Roblox 已不再支援或維護這項數學運算。

此成員未在物件瀏覽器出現，不應廣泛使用。

此成員只能透過指令列存取。從指令碼存取此成員將會導致錯誤。

此函式無法暫停呼叫自己的 Lua 執行緒。

在指令碼存取此成員將會導致錯誤。您可能可以從 Roblox Studio 的屬性視窗存取此成員。

此成員不再 Roblox Studio 的物件瀏覽器中。

您無法使用 Instance.new 建構式建立此類別的個體。

Roblox 不會跨越伺服器與用戶端界限而複製此成員。

Lua 程式碼無法存取此成員。您可能可以從 Roblox Studio 的屬性視窗變更其值。

此成員可從 OpenCloud Luau 執行任務存取。

此物件的複製行為取決於擁有的玩家。

此成員能透過指令列和外掛程式存取。從指令碼存取此成員將會導致錯誤。

此為唯讀成員。寫入此成員將會導致錯誤。

此為唯讀屬性，可以在未同步的執行緒讀取。嘗試寫入將會導致錯誤。

只有 Roblox CoreScript 可以存取此成員，Player 不可使用。

您可以安全地從多個執行緒對此屬性讀寫。

此類別為頂層 Singleton。使用 GetService 函式取得此類別的個體。

可在透過 {link1Start}RunService:BindToSimulation(){link1End} 綁定的回調中存取。支援回滾機制。請參閱{link2Start}伺服器授權{link2End}。

多個執行緒可以寫入此屬性，從未同步的執行緒讀取將有風險。

此函式在傳回結果前將會暫停呼叫自己的執行緒。此操作不會中斷其他指令碼。

在同個地方集中管理和分析您的所有體驗。

透過為所有創作者準備的文件和資源來學習。

透過各種指南、教學和程式碼範本，學習如何打造 Roblox 體驗。

在我們全方位的整合開發環境 Studio 中打造您的體驗，並將其部署到多種裝置上。

一位工程經理分享 AI 時代的遊戲開發思維。

將 Studio MCP 伺服器連接到你喜愛的 AI 程式設計工具。

為您的受眾長期提供價值的可靠方法

使用廣告管理工具，選擇目標受眾、控管預算並衡量成效。

自 3 月以來，大多數使用新廣告管理工具的創作者，每次遊玩花費減少了 44%，高品質遊戲完成率提高了 89%。

使用廣告管理工具，為體驗尋找使用者！

為遊戲尋找首批玩家的好方法！

使用「重啟使用者」目標，讓使用者回流

了解如何建立成功的廣告，帶動您作品的流量

使用文字聊天訊號和自訂配對功能，讓體驗保持社交互動。

將您體驗的成長率繪製成圖表，並發掘可改進之處

了解如何對角色和環境套用動作

此次 2026 年 4 月的更新推出新工具以加速開發。

團隊回答受眾對最新功能的問題。

與 Hal_Apenyo 一起學習如何為第一人稱射擊建立素材庫。

了解如何上傳或在創作中使用商店素材

使用自動設定加速流程，打造時尚靴子！

瞭解如何在 5 分鐘內將模型轉換為虛擬人偶。

建立虛擬人偶項目並將其發佈至市集

了解您可以製作並在市集銷售的內容

虛擬人偶是用來代表每一位 Roblox 使用者的可自訂角色

從頭開始打造時尚的包包與吊飾！

從創作者中心管理永久和臨時停權功能。

學習 Blender 中的基本模型化技術

尋找其他創作者製作的模型、指令碼和外掛程式

我們推出兩項全新計畫，透過行銷支援、實務合作夥伴，以及與 Roblox 團隊直接溝通的管道，協助你將構想轉化為可正式推出的遊戲。

跟 Roblox 內部的 3D 美術設計師學習如何為虛擬人偶道具建立圍籠

瞭解劇情畫面、攝影機搖晃，甚至是自訂攝影機系統。

了解如何設定角色以確保所有虛擬人偶功能運作正常

了解如何建立能與世界或其他使用者互動的物件

瞭解低階裝置上用戶端記憶體使用量的最佳作法。

如果你曾使用過其他引擎，建議先熟悉一下在 Roblox 上的開發方式。

在 Roblox 上創作並銷售您的第一件基本服裝

瞭解程式碼應該放在哪裡，以及如何依類型或功能加以整理。

您可使用 Studio 的協作工具與團隊同時進行作業

參與其他創作者舉辦的社群活動

尋找由創作者社群撰寫的教學課程

瞭解如何執行聯絡對象邀請獎勵系統

透過內容更新讓玩家持續投入並從中營利

運用令人愉悅的遊戲循環吸引受眾

透過具重複性的有趣遊玩方式，提升互動和進度

建立你的第一個空間，開啟創作者之旅。

了解如何不寫程式碼就創造出滑門

創作你的第一個體驗，或取得 Roblox Studio 以解鎖完整的創作工具組。

Alex 分享創作熱門體驗《越獄》的第一手經驗

Blake 對製作逼真獨特的嘉年華遊戲充滿熱情

Clemens 一家是《別不信，哥們》等熱門遊戲的幕後推手，他們是由家族成員組成的工作室

Jasmine 是市集中一些最受歡迎虛擬人偶道具背後的設計師

Jessica 是 Alo Yoga 等新穎獨創環境的幕後設計師

Jenni 是許多熱門合作項目幕後的 UGC 創作者及設計師

Morphist 的獨特風格結合了可愛和 Emo 系的美學

《暴動》的幕後創作者們四處旅行，尋找沉浸式環境的靈感

Stephen 和大家分享他對程式設計工具的熱愛

Sam 分享自己是如何開始設計那些他希望現實中存在但找不到的時尚物件

所有用於建立 3D 世界的物件，例如零件和照明

使用資料存儲功能來儲存玩家進度並處理玩家位置。

了解 Studio 提供了哪些偵錯工具

在測試時運用開發人員控制台為您的體驗偵錯

為您的體驗新增訂閱功能可幫助您打造與使用者群體的長久關係。在 2023 年 12 月 15 日前啟用訂閱功能，可享受 3 個月的較低費率。

了解 Roblox 的創作引擎──Studio

新增幾行程式碼來解鎖新的主控板，了解您的新玩家入門狀況和其他漏斗，並追蹤遊戲內的經濟系統。

Minty 教 Enyu 有關構造實體幾何的內容。

依結構化的順序打造即時的跨伺服器事件和過場動畫

了解如何為您的體驗打造時間型事件

建立時間型事件來提高您的體驗在 Roblox 上的可探索性。宣布您的最新更新、分享重點活動，或與玩家們一同慶祝您達成的里程碑！

了解如何透過體驗指引鎖定適合您創作的年齡層

直接從 Roblox 團隊身上學習專業知識

以三線設計開始下一個第一人稱射擊遊戲。

了解如何實施好友邀請獎勵系統

了解您能如何控制自己的資料被用來訓練 AI 的方式。{linkStart}閱讀更多{linkEnd}

使用我們的 AI 工具輕鬆建立自訂紋理

使用我們全方位的創作引擎打造您所能想像的一切

PolarCub 分享製作 UGC 物品的所有祕訣技巧

利用 Guilded 為您的作品建立社群

來和 voguebrunette 一起製作有頭巾的髮型！

加入我們出色的創作者行列，一起參加萬聖節 Game Jam（合作創作活動）

瞭解硬體測試對開發過程的重要性。

使用頭部來建立臉部動畫或觸發表情

運用指標數據了解遊戲可改進的地方

了解如何讓玩家持續回來玩您的遊戲

使用者輸入可讓使用者與您的體驗環境互動

透過個案研究瞭解如何建立易於擴展的控制方案。

引導第一次遊玩您體驗的玩家如何進行遊戲

製作會配合虛擬人偶身材調整尺寸的服裝

Roblox認為該從做中學。請選擇一項指南，了解平台內容。

取得撰寫程式碼的協助以及關於您創作疑問的解答

您可透過照明和聲音服務控制環境效果

深入瞭解如何為環境提供照明並新增地形。

了解如何針對不同語言和文化規範調整您的內容

Roblox 的細節等級設定，可提升體驗的畫面品質並改善執行效能。

Luau 中的物件導向程式設計。何時才有意義？

這個逐步說明影片涵蓋了附件、光束，還有一些指令碼化的基礎概念，示範如何在玩家碰觸到某些物品時將其生命值設為 0

培養活躍的玩家群體才能營造出成功且歷久不衰的遊戲。

瞭解如何使用 LuauHeap 工具來監控記憶體使用情況。

開始使用表現最佳化功能和疑難排解工具

微型分析工具可為工作排程器提供詳細時間資訊

深入研究影格顏色、火焰圖等等

瞭解模組指令碼的運作方式和使用時機。

了解如何使用指標數據更上層樓

提高運算密集型 Luau 指令碼的效能

查看您的每日指標、 洞察報告和即時數據，讓「{boldStart}{experienceName}{boldEnd}」更上層樓。

請在 5 月底前確認是否符合發佈資格。

了解如何在您的體驗中使用 NPC（非玩家角色）

@minty 利用聊天室中的建議從零開始打造一個障礙賽體驗

我們的平台能提供絕佳的創作環境，開始探索創作者中心、Roblox Studio和活躍的創作者社群吧。

我們的平台能提供絕佳的創作機會。

申請我們的加速和培育計畫，在 Roblox 上打造下一款爆紅遊戲。

探索並觸及全球知名智慧財產的粉絲群。

在我們全新的人才中心應徵頂尖 Studio 的全職或兼職工作。

我們社群中履獲殊榮的工作室和自學創作者都是由此開始，就和您一樣。

Roblox 的環境美術主設計師分享如何使用套件，以及使用套件的原因

了解如何處理最常出現的效能問題。

關於重力、材質屬性和限制式的工作人員直播

了解使用者加入體驗後會發生的情況

外掛程式可為您的創作增加額外功能

快來逛逛 PolarCub 的 UGC Homestore 吧！Temprist 也會出現喔。

完成素材、修飾地形、新增效果，真是太棒了。

了解如何帶動您作品的流量和知名度

透過專家的見解來了解如何銷售與宣傳虛擬人偶道具。

了解在 Blender 中製作虛擬人偶道具的有效工作流程。

Madison_Hatter2 展示如何加入紋理並發佈簡單的虛擬人偶道具。

使用推薦服務來呈現個人化內容。

使用全新的重新匯入功能，更輕鬆地對模型進行迭代。

瞭解如何在體驗中執行獎勵影片廣告。

聽聽《Dead Rails》創作者分享經營工作室的種種心得。

了解如何建立 R15 人形角色模型的骨架

在 Roblox 上創作並銷售您的第一個基本固定飾品

預覽 Roblox 即將推出的一些新的特色和功能

Studio 是您可在 Roblox 上建立體驗的工具

DucksAreYellow 與 Rush Bogin 對談，討論 UGC 的最佳做法和常見陷阱。

了解如何使用 Studio 中的指令碼編輯器建立自訂指令碼

Andrew 示範應在何處放置您的指令碼，使其正常能執行。

您可以運用指令碼在體驗中為使用者加入沉浸式互動

現在，你可以運用新的廣告管理工具，在首頁和搜尋中投放廣告。{learnMoreLinkStart}瞭解詳情{learnMoreLinkEnd}

瞭解樂觀和時空旅行，如何為伺服器權限 Beta 測試提供支援。

在 Roblox 上創作並銷售您的第一雙鞋。

了解可幫助您更快速進行建造的 Studio 捷徑和主要指令

即使目標值有所變動，也能使轉場保持平穩。

了解如何整合可讓玩家和好友一起遊玩的功能

瞭解如何整合功能，讓玩家可以與聯絡對象一起玩

建立贊助廣告，讓更多創作者看見您的作品

瞭解如何使用有限狀態機器編寫 NPC AI。

何時應該考慮使用 UnreliableRemoteEvent？

與團隊合作，或透過留言記錄你的想法。

深入了解如何在 Roblox Studio 中偵錯程式碼。

Studio 是在 Roblox 上用來建立創作的全方位工具。立刻試試發揮創意吧！

了解如何為玩家提供按月付費的定期福利

在其他創作者的幫助下增長您的體驗

使用地形編輯器在 Studio 中生成並修改地形

與「{boldStart}{experienceName}{boldEnd}」相似的體驗在個人化後，合格遊玩率平均提升了 8.5%。

了解在 Roblox 體驗中顯示時間的所有最佳方法。

翻譯可以讓更多不同的受眾接觸到您的作品

與 Minty 和 SCHLEEMPH 一起瀏覽新的 UGC Homestore 範本

探索 GUI 物件的陰影和各個角落的圓角。

使用新的樣式管理工具來建立、管理和套用 UI 樣式。

了解如何為 Roblox 的獨特受眾打造內容

介紹拖曳偵測器以及如何用此工具來建造

瞭解 Roblox 如何驗證虛擬人偶 UGC 頭部和其他實用提示。

了解所有關於地點版本、套件和指令碼紀錄的資訊。

觀看有關如何在 Roblox 上開始創作的快速介紹，然後立即進入 Studio 體驗

在體驗頁面上新增遊戲遊玩預覽影片！

閱讀 Roblox 工作人員的最新公告

使用此按鈕即可再次展開更新側邊欄。

集中管理和拓展你的作品，方便又輕鬆

追蹤任何創作的成效指標和使用者參與度

現在你可以監控每個所屬群組的體驗

您希望引擎在專案中渲染成像的物件會置於工作區

這場工作人員直播涵蓋了關於零件、網格、地形和照明的資訊

繼續創作你的體驗，或取得 Roblox Studio 以解鎖完整的創作工具組。

介紹 UGC 紋理，來賓 Madison_Hatter2

按一下此處以查看更新

每個公開體驗都必須有成年適宜內容標籤，才能供使用者遊玩。