PluginGuiService

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/PluginGuiService.yaml

一个服务，用于将 `Class.PluginGui` 对象存储在 Roblox Studio 中显示。

Class.Actor 是一个可以安全分离为其自己线程的代码容器。

Class

Actor

Luau

Array

Dictionary

Data Type

RBXScriptSignal

Variant

bool

number

字母、数字和符号等的字符串。

string

void

概览

指南

教程

参考

资源

艺术

设计

引擎

虚拟形象

旧版本

云端

此方法是异步的，会返回一个`Operation`对象，该对象表示操作的当前状态。它包含一个端点路径，您可以轮询该路径以获取实际响应和相关的元数据。有关长时间运行操作的更多信息，请参阅[文档]({longRunningOperationsLink})。

以下部分描述了操作完成时提供的响应和元数据对象。

Beta 测试终点已准备好公开使用。可能出现导致功能无法正常运作的更改，但几率极低。

此字段可能在创建资源时被设置，但可能无法在后续请求中修改。

此字段可以在请求中提供，但永远不会包括在答复中。

每个 API 密钥：每个 IP 地址每 {periodInSeconds} 秒有 {maxInPeriod} 次请求

此字段可能被设置为响应，但在请求中将被忽略。

调用此端点需要以下 API 密钥权限。关于生成正确密钥的更多信息，请查看 【管理 API 密钥】({apiKeyReferenceDocLink})。

相对于基础 URL 的路径，下列端点是可用的。

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

JSON 值可以是 “null”、“boolean”、“string”、“number”、“array” 或 “object”。

若要使用此端点，你的 OAuth 2.0 应用程序需要以下范围。关于如何注册 OAuth 2.0 应用程序的更多信息，请查看【应用程序注册及评价】({oauth2ReferenceDocLink})。

下列对象描述了接受或返回的有效载荷。请参阅每个单独的端点，以了解更多关于这些对象用途的信息。

这将允许查看关于你素材的信息。

这将允许在 Roblox 上传或更新素材。

Grants the ability to update badges owned by the user.

This allows viewing information about your commerce items.

This allows editing of your commerce merchant connections.

This allows you to view information about your Creator Store products.

This allows you to modify information about your Creator Store products.

This allows you to manage community join requests and role updates for your account.

这将允许查看你的道具栏信息。

Grants access to mange your badges and spend robux.

Grants access to manage your developer products.

Grants access to read information about the experiences you follow.

Grants access to follow and unfollow experiences on your behalf.

Grants access to manage your communities.

Grants permission to read community information.

Grants access to read and write your localization tables

Grants access to manage team collaboration for all experiences you own.

Grants access to manage your experiences and certain information associated with your experiences (e.g. localization information).

Grants access to read your experiences' localization information.

Grants access to modify your experiences' localization preferences.

Grants access to manage your user account.

Grants access to modify user localization preferences.

授予代替用户发布信息的权力。

This allows sending notifications from your experience to users.

这将允许列出与你的作品相关联的密钥。

这将允许创作和更新与你的作品相关联的密钥。

Grants access to read about your subscription products.

Grants the ability to read place information.

Grants the ability to edit place information.

此操作将会允许发布作品的新版本至 Roblox。

Grants the ability to read experience information.

Grants the ability to edit experience information.

Allows you to view user restrictions in the experience.

Allows you to edit user restrictions in the experience.

Grants the ability to read user's premium and verified status.

This allows you to view a user's social accounts.

默认值：{defaultValueStart}{defaultValueEnd}

数组是一个有序的数值列表。数组有助于存储数据集。

一组键值对，键值可以是任意数字、字符串或对象。

正如{tuples}一样，是一系列的值。

此函数将在可能是立即返回，但在返回值之前可以暂停调用自己的线程。

Roblox 已不再支持或维护{nameStart}名称{nameEnd}。

Roblox 已不再支持或维护这项数学运算。

此成员未在对象浏览器中出现，不应广泛使用。

此成员只能通过命令行访问。从脚本尝试访问此成员将导致错误。

此函数无法暂停调用自己的 Lua 线程。

从脚本尝试访问此成员将导致错误。你可能可以从 Roblox Studio 的属性窗口访问。

此成员不在 Roblox Studio 的对象浏览器中。

你无法使用 Instance.new 构造器创建此类别的实例。

Roblox 不会在跨服务器与客户机界限而复制此成员。

Lua 编程码无法访问此成员。你可能可以从 Roblox Studio 的属性窗口更改其值。

此会员可以从 OpenCloud Luau 执行任务访问。

此对象的复制行为取决于拥有它的玩家。

此成员可以通过命令行和插件访问。从脚本尝试访问此成员将导致错误。

此成员为只读。尝试写入此成员将会导致错误。

此属性为只读，可以从未同步的线程读取。尝试写入可能会导致错误。

只有 Roblox CoreScript 可以访问此成员，Players 不可用。

你可以安全地从多线程对此属性进行读写。

此类别为顶级类单例。使用 GetService 函数获取此类别的实例。

多线程可以写入此属性，所以从未同步的线程读取将会有风险。

此函数在返回借过前将会暂停调用自己的的线程。此操作不会中断其他脚本。

在一处集中并方便地管理并分析你的全部体验。

使用为全部创作者设计的学习文档和资源

通过指南、教程和代码示例学习如何打造 Roblox 体验。

使用我们一体化的集成开发环境 Studio，打造你的专属体验并部署至多种设备。

Dependable ways to offer value over time to your audience

在 Roblox 上发行广告可以吸引全球观众，为你的内容带来更多流量的机会。

Chart your experience's growth and discover opportunities to improve

动画是将动作和动作应用于角色、对象和环境的过程，以创造一种吸引人的动态体验。

Roblox 上几乎所有内容都是以云为基础的素材，拥有独特的 ID。

创建虚拟形象道具并发布至商城

Sorted by highest revenue over the last 7 days

Learn about what you can make and sell on the marketplace

每个 Roblox 用户都由一个可自定义的角色来代表，这个角色叫做虚拟形象。

Learn basic modeling techniques in blender

Find models, scripts, and plugins made by other creators

角色模型需要一组特定的组件和配置标准，以确保所有虚拟形象功能都能正常运行。

角色通常是指与世界或其他用户互动的任何模型对象。

Make and sell your first basic clothing item on Roblox

要创造出高质量的游戏体验，你需要具备很多技能，例如建模、脚本编程、用户界面设计和音频制作。

Check out what's trending on the Creator Store

参加其他创作者举办的社区活动

Keep players engaged and monetized with content updates

Captivate your audience with an enjoyable gameplay cycle

Drive engagement and progress with fun, repetitive gameplay

Learn how to create a sliding door without writing any code

Alex shares first-hand experience behind creating the hit experience, JailBreak

Blake found a passion in making realistic, quirky carnival games

The Clemens are the family-owned studio behind hits like The Survival Game

Jasmine is the artist behind some of the most popular avatar items on Marketplace

Jessica is the designer behind imaginative environments like in Alo Yoga

Jenni is the UGC creator and artist behind many popular collaborations

Morphist’s unique style combines cutesy and emo aesthetics

The Riotfall creators travel to find inspiration for their immersive environments

Stephen shares their love of programming tools

Sam shares how they got started designing fashion items that they wish existed

所有用于创建 3D 世界的对象，例如零件和照明

Roblox Studio 提供了集成开发环境（IDE）中常见的许多调试工具。

开发者控制台是在 Studio 中测试或在生产环境中运行时调试经验的工具。

Adding subscriptions to your experience helps build long term relationships with your user base. Enable subscriptions before December 15, 2023, and enjoy 3 months of lower rates.

开始使用 Studio，Roblox 的创作引擎

Add a few lines of code to unlock new dashboards to understand your onboarding and other funnels and track your in-game economy.

EventSequencer 是一个强大的框架，可以让你在一系列有组织的动作和触发器上，实时生成跨服务器的事件和过场动画。

了解如何为你的体验打造时间型事件

Create time-based events for increased discoverability across Roblox. Announce your latest update, highlight an activity, or celebrate a milestone with your players!

了解如果通过体验准则来针对适合你创作的年龄群体。

Gain knowledge and expertise directly from Roblox

Learn how to implement a friend invite reward system

Learn how you can control how your data is used to train AI. {linkStart}Read More{linkEnd}

Easily create custom textures using our AI tools

Use our all-in-one creation engine to build anything you can imagine

PolarCub shares all the tips tricks to make UGC items

Join our incredible cast of creators for a Halloween game jam

支持面部动画的头部部分是一个专门带皮肤的头部网格部件。

Using metrics to understand where you can improve your gameplay

Figure out how to keep them coming back to your game

每个体验都需要以某种方式接收用户输入，以便用户进行交互并查看其环境。

Guide players through their first time playing your experience

“层叠服饰“是一种装扮配件，可以自然地伸展并贴合任何外形和现有的层叠道具。

在 Roblox ，我们相信实践是最好的学习方式。从我们的指南中选择一个，进一步了解平台提供的更多内容。

Get help writing code and answers to your creation questions

借助"照明与音响服务"容器服务，你可以控制和自定义环境效果。

Roblox 用户来自全世界的各种文化背景，说着不同的语言。

This walkthrough covers attachments, beams, and some basic scripting concepts that shows you how to set player health to 0 if they touch something

培养活跃的玩家基础是开发一款成功且经久不衰的游戏的重要部分。

Get started with the performance optimization and troubleshooting tool

MicroProfiler 是 Roblox Studio 和 Roblox Client 中的一种优化工具，可为任务计划程序进程提供详细的时间信息。

Dive deep into frame colors, flame graphs, and more

了解如何使用指标取得更大的成功

Improve the performance of computationally intensive Luau scripts

View your daily benchmarks, insights, and real-time metrics to take {boldStart}{experienceName}{boldEnd} to the next level.

NPC（非玩家角色）可以为体验增加很多深度。

@minty creates an obby live from scratch using suggestions from chat

我们的平台为你提供无以伦比的创作机会。现在就开始探索创作者中心、Roblox Studio 和我们充满活力的创作者社区吧！

我们的平台为你提供无以伦比的创作机会。

Our community of award-winning studios and self-taught creators all started here, just like you. 

A principal environment artist at Roblox covers how and why to use packages

Staff stream about gravity, material properties, and constraints

当用户加入体验时，Roblox 会在数据模型中将其表示为玩家。

插件是一种可以为 Studio 添加额外功能或特性的扩展。

Let's tour PolarCub's UGC Homestore! Also, Temprist shows up.

Roblox 上的促销活动可以吸引全球观众，为你的体验、虚拟形象道具和社交媒体带来客流量和体验感。

Catch up on all the highlights from this year's RDC

了解我们的创作引擎能实现的可能性

R15 人形角色模型（例如构成用户角色的角色）由 15 个单独的网格对象组成。

Make and sell your first basic rigid accessory on Roblox

预览 Roblox 上即将推出的全新功能和产品。

Roblox Studio 是一个一体化集成开发环境，让你创作在 Roblox 上运行的体验。

Studio 的脚本编辑器是 Roblox 编程的主要工具。

脚本可以让你在体验中添加自定义动态行为，为你的用户提供更具有吸引力和沉浸式的互动。

Studio 有许多默认的快捷方式和按键命令，可以让你更快、更轻松地进行开发。

社交功能为玩家提供了与朋友一起游戏以及与其他玩家互动的方式。

创建赞助广告，让你的创作触达更多创作者

Studio 是在 Roblox 上用来创作的全方位工具。立刻试试，发挥你的创意！

Learn how to offer players recurring benefits for a monthly fee

与其他创作者合作，共同发展你的创作体验

地形编辑器让你可以轻松地通过创建、区域和编辑工具来生成和改变地形。

Experiences like {boldStart}{experienceName}{boldEnd} saw an average +8.5% lift in qualified play through rate with personalization.

翻译可以帮助你的创作触达更多样的用户

Tour the new UGC Homestore template with Minty and SCHLEEMPH

Roblox 的用户群在人口统计数据和预期方面都与其他平台不同。

What are they and how you can use them to build

 请先观看一个在 Roblox 上创作的简介视频，并前往 Studio

一站式简便管理和发展你的作品

工作区是一个容器服务，容纳你想要 Roblox 引擎在三维世界渲染的物体。

Staff stream covering parts, meshes, terrain, and lighting

PluginGuiService

概要

属性

方法

活动

属性

方法

活动