ScriptService

Demonstrates detecting changes to an instance's ancestry by connecting to the `Class.Instance.AncestryChanged` event.

The ChangingPart's Parent is set to different values overtime. The parent of the part is the part's ancestor, so the `Class.Instance.AncestryChanged` event will fire whenever it changes.


Instance.AncestryChanged

child

parent

Instance.AttributeChanged

attribute

This snippet prints the names of objects as they are added to the Workspace:


Instance.ChildAdded

This snippet prints the names of objects as they are removed from the
Workspace:


Instance.ChildRemoved

This following example will print the name of any object that is added to the
Workspace:


Instance.DescendantAdded

descendant

The following example prints the name of any descendant as it is being removed
from the Workspace:


Instance.DescendantRemoving

This sample demonstrates how, when using Immediate signal behavior, an Instance being destroyed remains in place until the connected function yields.


This sample demonstrates how, when using Deferred signal behavior,
an Instance is destroyed before the signal fires.


Instance.Destroying

Instance.childAdded

Instance:AddTag

This example creates a Part and adds a few sparkle objects to the part. Then
it calls Part:ClearAllChildren() to remove all of the children.


Instance:ClearAllChildren

Demonstrates cloning a model using `Class.Instance:Clone()`.

Instance:Clone

Demonstrates destroying a Part using the `Class.Instance:Destroy()` function.

This function is the correct way to dispose of objects that are no longer required.


Instance:Destroy

Instance:FindFirstAncestor

name

Instance:FindFirstAncestorOfClass

className

Instance:FindFirstAncestorWhichIsA

The below would look in Workspace for an object name "Brick". If found, it
will change the name of the object to "Foo".


Instance:FindFirstChild

recursive

Instance:FindFirstChildOfClass

Instance:FindFirstChildWhichIsA

Instance:FindFirstDescendant

Instance:GetActor

Instance:GetAttribute

Instance:GetAttributeChangedSignal

Instance:GetAttributes

The below would print the name of all objects currently in Workspace when ran.


Instance:GetChildren

Instance:GetDebugId

scopeLength

GetDescendants is often used to do something to all the descendants that are a
particular type of object. The code in this example uses GetDescendants and
`Class.Instance:IsA()` to find all of the parts in the workspace and turns
them green.


Instance:GetDescendants

This code sample demonstrates the behavior of `Class.Instance:GetFullName()`.
It shows how the function behaves when called on an object not in the
`DataModel` hierarchy, and it also shows how the return value does not escape
special characters.


This code sample re-implements the `Class.Instance:GetFullName()` function in
Lua.


Instance:GetFullName

Instance:GetStyled

Instance:GetTags

Instance:HasTag

Demonstrates determining if one instance is the ancestor of another using `Class.Instance:IsAncestorOf()`

Workspace and SpawnLocation are ancestors of the SpawnLocation's decal.
Workspace is an ancestor of SpawnLocation.

SpawnLocation and its decal are descendants of Workspace, not ancenstors.
Decal is a descendant to SpawnLocation, not an ancestor.


Instance:IsAncestorOf

Instance:IsDescendantOf

ancestor

The following code demonstrates how a part can be re-added to the DataModel
after being removed:


Instance:Remove

Instance:RemoveTag

Instance:SetAttribute

value

The following code waits for an instance named "Part" to be added to
Workspace.


Instance:WaitForChild

childName

timeOut

Instance:children

Instance:clone

Instance:destroy

Instance:findFirstChild

Instance:getChildren

Instance:isDescendantOf

Instance:remove

Instance

Instance.Archivable

Instance.Capabilities

Instance.Name

Instance.Parent

Instance.RobloxLocked

Instance.Sandboxed

Instance.UniqueId

Instance.archivable

This sample demonstrates the subtleties of the Changed event on normal objects
and "-Value" objects.


This code sample demonstrates the Changed event firing within a parent object.


Object.Changed

property

This code sample demonstrates how to save a value before a changed event fires
on it in order to get more information about a change.


This code sample demonstrates the equivalence of the `Changed` event and event
returned by `GetPropertyChangedSignal`.


Object:GetPropertyChangedSignal

Demonstrates determining the class of Workspace using `Class.Instance:IsA()`

Workspace is of class 'Workspace', so the first statement is true.
Workspace is not of class 'BasePart', so the second statement is false.
Workspace inherits from Instance and therefore is of class 'Instance', so the third statement is true.


Object:IsA

Object:isA

Object

Object.ClassName

Object.className

/reference/engine/classes/ScriptService.yaml

一個未實現的服務，功能與 `LocalWorkspace` 服務相似。

Class.Actor 是一個可以安全分離在自己的子線程中的代碼。

Class

Actor

Luau

Array

Dictionary

Data Type

連接到特定發生時執行的對象。

RBXScriptSignal

Variant

bool

number

字母、數字和符號等的一系列字符。

string

void

概覽

指南

教學

參考

資源

美術

設計

引擎

虛擬人偶

舊版本

雲端

此方式不同步且返回「操作」，這代表操作的目前狀態。它包含終點路徑，您可以取用以獲得實際回應和適用的中繼資料。詳情請參閱長期執行操作上的 [文件]({longRunningOperationsLink})。
            
以下部分描述操作完成時提供的回應和中繼資料物件。

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

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

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

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

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

調用此端點需要以下 API 金鑰權限。有關
產生正確金鑰的更多資訊，請查看 [管理 API 金鑰]（{apiKeyReferenceDocLink}）。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

這能讓您管理社群加入申請和您帳號的角色更新。

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

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

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

授予讀取您所追蹤體驗之相關資訊的權限。

授予代您追蹤體驗和取消追蹤的權限。

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

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

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

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

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

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

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

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

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

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

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

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

此操作將會允許發布新版本的體驗到 Roblox。

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

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

授予讀取使用者高級會員狀態與驗證狀態的能力。

這能讓您檢視使用者的社群帳號。

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

預設值：{defaultValueStart}{defaultValueEnd}

陣列是值的有序列表。陣列在儲存資料組合時很實用。

一組鍵值對，鍵可以是任何數字、字串或物件。

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

了解 Roblox 的創作引擎──Studio

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ScriptService

概要

屬性

方法

活動

屬性

方法

活動