The main object responsible for creating custom Studio widgets, toolbars, buttons, and other plugin UI elements.
- Memory category
- Instances
- Own members
- 66
- Inherited members
- 75
- Subclasses
- 0
- Siblings
- 608
Properties31
Property categoryBehavior
- Determines if an
Instanceand its descendants can be cloned usingInstance:Clone(), and can be saved/published. - Deprecated: This deprecated property is a variant of
Instance.Archivablewhich should be used instead.Use Archivable instead.
Property categoryData
Property categoryPermissions
- The set of capabilities allowed to be used for scripts inside this container.
- Indicates whether the instance is inside a sandboxed container.
- When enabled, the instance can only access abilities in its
Capabilitieslist.
Defined byPlugin8
Property categoryData
Plugin.CollisionEnabled: boolean Returns whether the user has enabled Collisions in Studio's toolbar.Plugin.DisableUIDragDetectorDrags: boolean Iftrue, toolbars and buttons for the plugin will ignore dragging related to aUIDragDetectorinstance.Plugin.GridSize: number Returns the grid snapping size the user has set in Studio.Plugin.HostDataModelType: Enum.StudioDataModelType Plugin.HostDataModelTypeIsCurrent: boolean Plugin.IsDebuggable: boolean Indicates whether the plugin's scripts can be debugged in Studio.Plugin.MultipleDocumentInterfaceInstance: MultipleDocumentInterfaceInstance
No properties match the filters.
Methods92
Object:GetPropertyChangedSignal( property: string): RBXScriptSignal Get an event that fires when a given property of the object changes.Parameters Parameter Description property: stringThe property to connect to.Returns Type Description RBXScriptSignalA signal that fires whenever the property changes.- Returns true if an object's class matches or inherits from a given class.
Parameters Parameter Description className: stringThe class against which the Object's class will be checked. Case-sensitive.Returns Type Description booleanDescribes whether the Object's class matched or is a subclass of the given class. - Deprecated: This deprecated function is a variant of
Object:IsA()which should be used instead.Parameters Parameter className: stringReturns Type booleanUse IsA instead.
- Applies a tag to the instance.
Parameters Parameter Description tag: stringThe tag to apply to the instance. - This method destroys all of an instance's children.
- Create a copy of an instance and all its descendants, ignoring instances that are not
Archivable.Returns Type Description InstanceA copy of the instance, ornilif the instance is notArchivable. - Sets the
Instance.Parentproperty tonil, locks theInstance.Parentproperty, disconnects all connections, and callsDestroy()on all children. Instance:FindFirstAncestor( name: string): Instance Returns the first ancestor of theInstancewhoseInstance.Nameis equal to the given name.Parameters Parameter Description name: stringTheInstance.Nameto be looked for.Instance:FindFirstAncestorOfClass( className: string): Instance Returns the first ancestor of theInstancewhoseObject.ClassNameis equal to the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstAncestorWhichIsA( className: string): Instance Returns the first ancestor of theInstancefor whomObject:IsA()returns true for the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstChild( name: string, recursive: boolean? = false): Instance Returns the first child of theInstancefound with the given name.Parameters Parameter Description name: stringTheInstance.Nameto be searched for.recursive: boolean? = falseWhether or not the search should be conducted recursively.Instance:FindFirstChildOfClass( className: string): Instance Parameters Parameter Description className: stringTheObject.ClassNameto be looked for.Instance:FindFirstChildWhichIsA(className: string,recursive: boolean? = false,): Instance Returns the first child of theInstancefor whomObject:IsA()returns true for the given className.Parameters Parameter Description className: stringTheObject.ClassNameto be searched for.recursive: boolean? = falseWhether or not the search should be conducted recursively.Instance:FindFirstDescendant( name: string): Instance Returns the first descendant found with the givenInstance.Name.Parameters Parameter Description name: stringTheInstance.Nameto search for.- Returns the
Actorassociated with the Instance, if any. Instance:GetAttribute( attribute: string): any Returns the value which has been assigned to the given attribute name.Parameters Parameter Description attribute: stringThe name of the attribute being retrieved.Returns Type Description anyThe value which has been assigned to the given attribute name. If no attribute has been assigned,nilis returned.Instance:GetAttributeChangedSignal( attribute: string): RBXScriptSignal Returns an event that fires when the given attribute changes.Parameters Parameter Description attribute: stringThe name of the specified attribute for which the change signal is being returned.Returns Type Description RBXScriptSignalAn event that fires when the given attribute changes.- Returns a dictionary of the instance's attributes.
Returns Type Description { [string]: any }A dictionary of string → variant pairs for each attribute where the string is the name of the attribute and the variant is a non-nil value. - Returns an array containing all of the instance's children.
Returns Type Description { Instance }An array containing the instance's children. Instance:GetDebugId( scopeLength: number? = 4): string Returns a coded string of the debug ID used internally by Roblox.Parameters Parameter Description scopeLength: number? = 4The scope length.Returns Type Description stringThe Debug ID string.- Returns an array containing all of the descendants of the instance.
Returns Type Description { Instance }An array containing the instance's descendants. - Returns a string describing the instance's ancestry.
- Returns the styled or explicitly modified value of the specified property, or else the default property value if it hasn't been styled/modified.
Parameters Parameter Description name: stringName of the property to query.selector: string?Optional selector for the pseudo instance you are targeting on the instance.Returns Type Description anyThe styled or explicitly modified value of the specified property, or else the default property value if it hasn't been styled/modified. Instance:GetStyledPropertyChangedSignal( property: string): RBXScriptSignal Returns an event that fires when the given style property changes on the instance.Parameters Parameter Description property: stringName of the style property for which to listen for changes.Returns Type Description RBXScriptSignalEvent that fires when the given style property changes.- Gets an array of all tags applied to the instance.
Returns Type Description { any }An array of strings, each representing a tag applied to the instance. - Check whether the instance has a given tag.
Parameters Parameter Description tag: stringThe tag to check for on the instance.Returns Type Description booleantrueif the instance has the given tag,falseotherwise. Instance:IsAncestorOf( descendant: Instance): boolean Returns true if anInstanceis an ancestor of the given descendant.Instance:IsDescendantOf( ancestor: Instance): boolean Returnstrueif anInstanceis a descendant of the given ancestor.Instance:IsPropertyModified( property: string): boolean Returnstrueif the value stored in the specified property is not equal to the code-instantiated default.Parameters Parameter Description property: stringName of the property to query.Returns Type Description booleanBoolean indicating whether the property is modified from its code‑instantiated default.Instance:QueryDescendants( selector: string): { Instance } Returns an array containing all descendants of the instance that match theselectorstring.Parameters Parameter Description selector: stringSelector string used to filter elements.Returns Type Description { Instance }An array of instances (empty if nothing matched the selector).- Removes a tag from the instance.
Parameters Parameter Description tag: stringThe tag to remove from the instance. Instance:ResetPropertyToDefault( property: string) Resets a property to its default value.Parameters Parameter Description property: stringName of the property to reset.Instance:SetAttribute( attribute: string, value: any) Sets the attribute with the given name to the given value.Instance:WaitForChild( childName: string, timeOut: number): Instance Returns the child of theInstancewith the given name. If the child does not exist, it will yield the current thread until it does.Parameters Parameter Description childName: stringTheInstance.Nameto be looked for.timeOut: numberAn optional time out parameter.- Deprecated: This item is deprecated in favor of
Instance:Destroy()andInstance:ClearAllChildren(). If you must remove an object from the game, and wish to use the object later, set itsParentproperty tonilinstead of using this method.
Sets the object'sParenttonil, and does the same for all its descendants. - Deprecated: This item has been superseded by
Instance:GetChildren()which should be used in all new work.
Returns an array of the object's children.Returns Type Description { Instance }Array of child objects/instances.Use GetChildren instead.
- Deprecated: This deprecated function is a variant of
Instance:Clone()which should be used instead.Returns Type InstanceUse Clone instead.
- Deprecated: This deprecated function is a variant of
Instance:Destroy()which should be used instead.Use Destroy instead.
Instance:findFirstChild( name: string, recursive: boolean? = false): Instance Deprecated: This deprecated function is a variant ofInstance:FindFirstChild()which should be used instead.Returns Type InstanceUse FindFirstChild instead.
- Deprecated: This deprecated function is a variant of
Instance:GetChildren()which should be used instead.Returns Type { Instance }Use GetChildren instead.
Instance:isDescendantOf( ancestor: Instance): boolean Deprecated: This deprecated function is a variant ofInstance:IsDescendantOf()which should be used instead.Parameters Parameter ancestor: InstanceReturns Type booleanUse IsDescendantOf instead.
- Deprecated: This deprecated function is a variant of
Instance:Remove()which has also been deprecated. Neither function should be used in new work.Use Remove instead.
Defined byPlugin50
Plugin:Activate( exclusiveMouse: boolean) Sets the state of the calling plugin to activated.Parameters Parameter Description exclusiveMouse: booleanA boolean specifying whether to activate the plugin with exclusive mouse. Iftrue, aPluginMousecan be retrieved viaGetMouse().Plugin:CreateDockWidgetPluginGuiAsync(pluginGuiId: string,dockWidgetPluginGuiInfo: DockWidgetPluginGuiInfo,): DockWidgetPluginGui Creates aDockWidgetPluginGuigiven aDockWidgetPluginGuiInfo.Parameters Parameter Description pluginGuiId: stringA unique and consistent identifier used to storing the widget's dock state and other internal details.dockWidgetPluginGuiInfo: DockWidgetPluginGuiInfoDescribes theDockWidgetPluginGuito create (initial state, size, etc).Returns Type DockWidgetPluginGuiPlugin:CreatePluginAction(actionId: string,text: string,statusTip: string,iconName: string? = "",allowBinding: boolean? = true,): PluginAction Creates aPluginActionwhich represents a generic performable action in Studio with no directly‑associatedPluginToolbarButton.Parameters Parameter Description actionId: stringMust be a unique string that identifies this PluginAction from others.text: stringThe displayed name of the action.statusTip: stringThe displayed description of the action.iconName: string? = ""The name of the icon used to display the plugin.allowBinding: boolean? = trueWhether thePluginActionwill be hidden from Studio's shortcuts view. Useful for contextual actions. Defaults to true.Returns Type PluginActionPlugin:CreatePluginMenu(id: string,title: string? = "",icon: string? = "",): PluginMenu Creates a new plugin menu.Parameters Parameter Description id: stringUnique ID for the menu.title: string? = ""The text to be displayed when used as a submenu.icon: string? = ""The icon to be displayed when used as a submenu.Returns Type PluginMenuPlugin:CreateQWidgetPluginGui(pluginGuiId: string,pluginGuiOptions: { [string]: any },): QWidgetPluginGui Parameters Parameter pluginGuiId: stringpluginGuiOptions: { [string]: any }Returns Type QWidgetPluginGuiPlugin:CreateToolbar( name: string): PluginToolbar Creates a newPluginToolbarwith the given name.Parameters Parameter Description name: stringThe visible text on the toolbar, labeling the group of buttons contained within.Returns Type PluginToolbar- Deactivates the plugin.
Plugin:FinishFullLoading( payload: any) Parameters Parameter payload: anyReturns Type anyPlugin:GetJoinMode( ): Enum.JointCreationMode Returns theJointCreationModethe user has set in Studio's toolbar.Returns Type Enum.JointCreationModePlugin:GetMouse( ): PluginMouse Returns aMousethat can be used while the plugin is active.Returns Type PluginMouseParameters Parameter name: stringReturns Type anyPlugin:GetPreinitPayload( ): any Returns Type anyPlugin:GetSelectedRibbonTool( ): Enum.RibbonTool Returns the currently selectedRibbonTool.Returns Type Enum.RibbonTool- Retrieves a previously stored value with the given key, or
nilif the given key doesn't exist.Parameters Parameter Description key: stringThe string key that was previously passed toSetSetting().Returns Type any Plugin:GetUri( ): { [string]: any } Returns Type { [string]: any }- Prompts the user to open a
.fbxanimation file that can be loaded onto therigModel, then proceeds to insert the animation as aKeyframeSequencein theWorkspace.Parameters Parameter Description rigModel: InstanceThe rig model that the imported animation will be applied to.isR15: boolean? = trueWhether the animation file should be interpreted as an R15 rig. Defaults totrue.Returns Type Instance - Prompts the user to open a
.fbxfile, uploads the individual components of the model as meshes, and generates a character rig for use in animation, which is loaded into theWorkspace.Parameters Parameter Description isR15: boolean? = trueWhether the rig file should be interpreted as R15. Defaults totrue.Returns Type Instance Plugin:Intersect( objects: { Instance }): Instance Intersects the given parts and returns the resultingIntersectOperation.Parameters Parameter Description objects: { Instance }The array ofBasePartsto intersect.Returns Type InstancePlugin:IsActivated( ): boolean Returnstrueif this plugin is currently active, after having been activated via theActivate()function.Returns Type Description booleanA boolean indicating whether the plugin is currently active.Plugin:IsActivatedWithExclusiveMouse( ): boolean Returnstrueif this plugin is currently active with an exclusive mouse.Returns Type Description booleanWhether this plugin is currently active with an exclusive mouse.Plugin:IsLoadedFromProject( ): boolean Returns Type booleanPlugin:Negate( objects: { Instance }): { Instance } Negates the given parts and returns the resultingNegateOperations.Parameters Parameter Description objects: { Instance }The array ofBasePartsto negate.Returns Type { Instance }Plugin:OnInvoke( key: string, callback: (...any) -> ...any): Instance Parameters Parameter key: stringcallback: (...any) -> ...anyReturns Type InstancePlugin:OnInvokeSuspendOverride(key: string,callback: (...any) -> ...any,): Instance Parameters Parameter key: stringcallback: (...any) -> ...anyReturns Type InstancePlugin:OnSetItem( key: string, callback: (...any) -> ...any): Instance Parameters Parameter key: stringcallback: (...any) -> ...anyReturns Type InstancePlugin:OpenWikiPage( url: string) Opens the context help window to the wiki page thaturllinks to.Parameters Parameter Description url: stringThe URL of the wiki/documentation page to open.Plugin:PauseSound( sound: Instance) Parameters Parameter sound: Instance- Opens a window in Roblox Studio that prompts the user to select an existing
AssetType.Animationasset. TheassetTypeparameter must beAnimation; other values are not supported and cause an error.Parameters Parameter Description assetType: stringThe asset type to browse. OnlyAnimationis supported.Returns Type number - Opens a window in Roblox Studio that prompts the user to select an existing
AssetType.Animationasset. TheassetTypeparameter must beAnimation; other values are not supported and cause an error.Parameters Parameter Description assetType: stringThe asset type to browse. OnlyAnimationis supported.Returns Type number - Prompts the user to save their current selection with the specified file name.
Parameters Parameter Description suggestedFileName: string? = ""The default file name shown in the save dialog. Defaults to an empty string.Returns Type boolean Plugin:ResumeSound( sound: Instance) Parameters Parameter sound: Instance- Opens an upload window for the user's current selection.
Plugin:SelectRibbonTool( tool: Enum.RibbonTool, position: UDim2) Activates the specified Roblox Studio tool.Parameters Parameter Description tool: Enum.RibbonToolTheRibbonToolto activate.position: UDim2TheUDim2screen position at which to show the tool's dialog window, if applicable.Plugin:Separate( objects: { Instance }): { Instance } Separates the givenUnionOperationsand returns the resulting parts.Parameters Parameter Description objects: { Instance }The array ofUnionOperationsto separate.Returns Type { Instance }- Stores a given value for later use under the given key. The value will persist even after Studio is closed.
Plugin:StartDecalDrag( decal: Instance) Parameters Parameter decal: InstancePlugin:StartDrag( dragData: { [string]: any }) Starts a drag action given a dictionary of parameters.Parameters Parameter Description dragData: { [string]: any }A dictionary describing the drag, including fields such asSender,MimeType,Data,MouseIcon,DragIcon, andHotSpot.Plugin:Union( objects: { Instance }): Instance Unions the given parts and returns the resultingUnionOperation.Parameters Parameter Description objects: { Instance }The array ofBasePartsto union together.Returns Type InstancePlugin:CreateDockWidgetPluginGui(pluginGuiId: string,dockWidgetPluginGuiInfo: DockWidgetPluginGuiInfo,): DockWidgetPluginGui Deprecated: This method has been superseded byCreateDockWidgetPluginGuiAsync().
Creates aDockWidgetPluginGuigiven aDockWidgetPluginGuiInfo.Parameters Parameter Description pluginGuiId: stringA unique and consistent identifier used to storing the widget's dock state and other internal details.dockWidgetPluginGuiInfo: DockWidgetPluginGuiInfoDescribes theDockWidgetPluginGuito create (initial state, size, etc).Returns Type DockWidgetPluginGuiUse CreateDockWidgetPluginGuiAsync instead.
Plugin:GetStudioUserId( ): number Deprecated:
Returns the Studio user's userId if they're logged in, otherwise returns 0.Returns Type number- Deprecated:
Prompts the user to open a.fbxanimation file that can be loaded onto therigModel, then proceeds to insert the animation as aKeyframeSequencein theWorkspace.Parameters Parameter Description rigModel: InstanceThe rig model that the imported animation will be applied to.isR15: boolean? = trueWhether the animation file should be interpreted as an R15 rig. Defaults totrue.Returns Type InstanceUse ImportFbxAnimationAsync instead.
- Deprecated: This method has been superseded by
ImportFbxRigAsync().
Prompts the user to open a.fbxfile, uploads the individual components of the model as meshes, and generates a character rig for use in animation, which is loaded into theWorkspace.Parameters Parameter Description isR15: boolean? = trueWhether the rig file should be interpreted as R15. Defaults totrue.Returns Type InstanceUse ImportFbxRigAsync instead.
Plugin:OpenScript( script: LuaSourceContainer, lineNumber: number? = 1) Deprecated:
Used to open the given script instance in an editor window, in Roblox studio, at the given line. If no line is given as an argument it will default to 1.Parameters Parameter Description script: LuaSourceContainerTheLuaSourceContainerscript instance to open.lineNumber: number? = 1The line number to navigate to in the editor. Defaults to1.- Deprecated: This method has been superseded by
PromptSaveSelectionAsync().
Prompts the user to save their current selection with the specified file name.Parameters Parameter Description suggestedFileName: string? = ""The default file name shown in the save dialog. Defaults to an empty string.Returns Type booleanUse PromptSaveSelectionAsync instead.
No methods match the filters.
Events16
Object.Changed: RBXScriptSignal<( property: string)> Fires immediately after a property of the object changes, with some limitations.Parameters Parameter property: string
Instance.AncestryChanged: RBXScriptSignal<( child: Instance, parent: Instance)> Fires when theInstance.Parentproperty of this object or one of its ancestors is changed.Instance.AttributeChanged: RBXScriptSignal<( attribute: string)> Fires whenever an attribute is changed on theInstance.Parameters Parameter attribute: stringInstance.ChildAdded: RBXScriptSignal<( child: Instance)> Fires after an object is parented to thisInstance.Parameters Parameter child: InstanceInstance.ChildRemoved: RBXScriptSignal<( child: Instance)> Fires after a child is removed from thisInstance.Parameters Parameter child: InstanceInstance.DescendantAdded: RBXScriptSignal<( descendant: Instance)> Fires after a descendant is added to theInstance.Parameters Parameter descendant: InstanceInstance.DescendantRemoving: RBXScriptSignal<( descendant: Instance)> Fires immediately before a descendant of theInstanceis removed.Parameters Parameter descendant: Instance- Fires immediately before (or is deferred until after) the instance is destroyed via
Instance:Destroy(). - Fires whenever any style property is changed on the instance, including when a property is set to
nil. Instance.childAdded: RBXScriptSignal<( child: Instance)> Deprecated: This deprecated event is a variant ofInstance.ChildAddedwhich should be used instead.Parameters Parameter child: InstanceUse ChildAdded instead.
Defined byPlugin6
Plugin.Deactivation: RBXScriptSignal<( )> Fired when the plugin is deactivated.Plugin.Ready: RBXScriptSignal<( )> Plugin.Unloading: RBXScriptSignal<( )> Fires immediately before thePluginstops running.Plugin.ViewportDragDropped: RBXScriptSignal<( dragData: { [string]: any })> Parameters Parameter dragData: { [string]: any }Plugin.ViewportDragEntered: RBXScriptSignal<( dragData: { [string]: any })> Parameters Parameter dragData: { [string]: any }Plugin.ViewportDragLeft: RBXScriptSignal<( )>
No events match the filters.
Callbacks2
Defined byPlugin2
Plugin.ProcessAssetInsertionDrag: (assetId: string,assetTypeId: number,instances: { Instance },) -> { Instance } Parameters Parameter assetId: stringassetTypeId: numberinstances: { Instance }Returns Type { Instance }Plugin.ProcessAssetInsertionDrop: ( ) -> ()
No callbacks match the filters.