PlayerGui

Show Deprecated
not creatable
player replicated

The PlayerGui object is a container that holds a player's user GUI. If a ScreenGui is a descendant of a PlayerGui, then any GuiObject inside of the ScreenGui will be drawn to the player's screen. Any LocalScript will run as soon as it is inserted into a PlayerGui.

When a player first joins a game, their PlayerGui is automatically inserted into their Player object. When the player's Player.Character spawns for the first time all of the contents of StarterGui are automatically copied into the player's PlayerGui. Note that if Players.CharacterAutoLoads is set to false the character will not spawn and StarterGui contents will not be copied until Player:LoadCharacter() is called. If StarterGui.ResetPlayerGuiOnSpawn is set to true then every time the player's character respawns all of the contents of that player's PlayerGui is cleared and replaced with the contents of StarterGui.


-- Accessing PlayerGui from a LocalScript:
game:GetService('Players').LocalPlayer:WaitForChild('PlayerGui')

Summary

Properties

Methods

Methods inherited from BasePlayerGui

Properties

CurrentScreenOrientation

read only
not replicated
read parallel

Describes the user's current screen orientation.

ScreenOrientation

read parallel

Sets the preferred screen orientation mode for this user, if the user is on a mobile device.

SelectionImageObject

read parallel

Overrides the default selection adornment (used for gamepads). For best results, this should point to a GuiObject.

Methods

Events