Reference API Roblox

Engine API

Website

Related

Reference API Roblox

UserGameSettings

The UserGameSettings is a singleton class found inside of the UserSettings singleton. It holds various persistent settings relating to how the user wants to control their camera, and their character.

This class is not creatable. Instances of this class cannot be created with Instance.new.
Tags: [NotCreatable, UserSettings]

Member index 82

HistoryMember
553AllTutorialsDisabled: bool
553CameraMode: CustomCameraMode
553ChatVisible: bool
553ComputerCameraMovementMode: ComputerCameraMovementMode
553ComputerMovementMode: ComputerMovementMode
578ControlMode: ControlMode
553Fullscreen: bool
553GamepadCameraSensitivity: float
640GraphicsOptimizationMode: GraphicsOptimizationMode
553GraphicsQualityLevel: int
553HasEverUsedVR: bool
553MasterVolume: float
619MasterVolumeStudio: float
640MaxQualityEnabled: bool
553MouseSensitivity: float
553OnboardingsCompleted: string
645PartyVoiceVolume: float
553RCCProfilerRecordFrameRate: int
553RCCProfilerRecordTimeFrame: int
553RotationType: RotationType
553SavedQualityLevel: SavedQualitySetting
553StartMaximized: bool
553StartScreenPosition: Vector2
553StartScreenSize: Vector2
553TouchCameraMovementMode: TouchCameraMovementMode
553TouchMovementMode: TouchMovementMode
553UsedCoreGuiIsVisibleToggle: bool
553UsedCustomGuiIsVisibleToggle: bool
553UsedHideHudShortcut: bool
553VREnabled: bool
553VRRotationIntensity: int
553VRSmoothRotationEnabled: bool
553VignetteEnabled: bool
462GetCameraYInvertValue(): int
623GetDefaultFramerateCap(): int
462GetOnboardingCompleted(onboardingId: string): bool
462GetTutorialState(tutorialId: string): bool
462InFullScreen(): bool
462InStudioMode(): bool
573ResetOnboardingCompleted(onboardingId: string): null
573SetCameraYInvertVisible(): null
573SetGamepadCameraSensitivityVisible(): null
573SetOnboardingCompleted(onboardingId: string): null
573SetTutorialState(tutorialId: string, value: bool): null
462FullscreenChanged(isFullscreen: bool)
462PerformanceStatsVisibleChanged(isPerformanceStatsVisible: bool)
462StudioModeChanged(isStudioMode: bool)
inherited from Instance
553Archivable: bool
635Capabilities: SecurityCapabilities
553Name: string
553Parent: Instance
635Sandboxed: bool
616UniqueId: UniqueId
576AddTag(tag: string): null
573ClearAllChildren(): null
462Clone(): Instance
573Destroy(): null
486FindFirstAncestor(name: string): Instance
486FindFirstAncestorOfClass(className: string): Instance
486FindFirstAncestorWhichIsA(className: string): Instance
486FindFirstChild(name: string, recursive: bool = false): Instance
486FindFirstChildOfClass(className: string): Instance
486FindFirstChildWhichIsA(className: string, recursive: bool = false): Instance
486FindFirstDescendant(name: string): Instance
563GetActor(): Actor
486GetAttribute(attribute: string): Variant
462GetAttributeChangedSignal(attribute: string): RBXScriptSignal
631GetAttributes(): Dictionary
648GetChildren(): Instances
462GetDebugId(scopeLength: int = 4): string
486GetDescendants(): Array
486GetFullName(): string
641GetStyled(name: string): Variant
576GetTags(): Array
576HasTag(tag: string): bool
486IsAncestorOf(descendant: Instance): bool
486IsDescendantOf(ancestor: Instance): bool
580IsPropertyModified(name: string): bool
573Remove(): null
576RemoveTag(tag: string): null
580ResetPropertyToDefault(name: string): null
573SetAttribute(attribute: string, value: Variant): null
462WaitForChild(childName: string, timeOut: double): Instance
648children(): Instances
553clone(): Instance
573destroy(): null
553findFirstChild(name: string, recursive: bool = false): Instance
648getChildren(): Instances
553isDescendantOf(ancestor: Instance): bool
573remove(): null
462AncestryChanged(child: Instance, parent: Instance)
462AttributeChanged(attribute: string)
462ChildAdded(child: Instance)
462ChildRemoved(child: Instance)
462DescendantAdded(descendant: Instance)
462DescendantRemoving(descendant: Instance)
500Destroying()
553childAdded(child: Instance)
inherited from Object
647ClassName: string
647className: string
647GetPropertyChangedSignal(property: string): RBXScriptSignal
647IsA(className: string): bool
650isA(className: string): bool
647Changed(property: string)

Removed member index 5

HistoryMember
304ImageUploadPromptBehavior: UploadSetting
304VideoUploadPromptBehavior: UploadSetting

Description

The UserGameSettings is a singleton class found inside of the UserSettings singleton. It holds various persistent settings relating to how the user wants to control their camera, and their character.

You can access this object from a LocalScript via:

1
UserSettings():GetService("UserGameSettings")

This object is intended to be used on the client only, as it serves no purpose on the server. It will also reflect your own settings when testing in Roblox Studio.

History 268

Members 82

AllTutorialsDisabled

TypeDefault
bool

History 6

CameraMode

TypeDefault
CustomCameraMode

History 7

ChatVisible

TypeDefault
bool

History 4

ComputerCameraMovementMode

TypeDefault
ComputerCameraMovementMode

The camera movement mode currently in-use by the client on desktop.

History 4

ComputerMovementMode

TypeDefault
ComputerMovementMode

The type of controls being used by the client on desktop.

History 4

ControlMode

TypeDefault
ControlMode

Toggles whether or not the client can use the Mouse Lock Switch mode.

History 14

Fullscreen

TypeDefault
bool

History 6

FullscreenChanged

Parameters (1)
isFullscreenbool

Fires if the user's full screen mode is changed. The event will only fire on desktop devices that can toggle full screen mode. The game will always be in full screen on mobile devices and consoles.

History 2

GamepadCameraSensitivity

TypeDefault
float

Describes how sensitive the camera is when using a gamepad.

History 6

GetCameraYInvertValue

Parameters (0)
No parameters.
Returns (1)
int

Returns the camera's Y-invert value.

History 2

GetDefaultFramerateCap

Parameters (0)
No parameters.
Returns (1)
int

History 1

GetOnboardingCompleted

Parameters (1)
onboardingIdstring
Returns (1)
bool

Checks whether or not the given onboarding has been completed yet, which is useful for avoiding showing the onboarding animation again.

If onboardingId is not one of the accepted IDs, an error is thrown.

The onboarding process is one-way. This means that, as a developer, you can force the onboarding process to completion but cannot reset it.

See also:

History 2

GetTutorialState

Parameters (1)
tutorialIdstring
Returns (1)
bool

History 2

GraphicsOptimizationMode

TypeDefault
GraphicsOptimizationMode

History 1

GraphicsQualityLevel

TypeDefault
int

History 4

HasEverUsedVR

TypeDefault
bool

History 4

InFullScreen

Parameters (0)
No parameters.
Returns (1)
bool

Returns true if the user's Roblox window is in full screen mode.

History 2

InStudioMode

Parameters (0)
No parameters.
Returns (1)
bool

Returns true if the client's game session is in Roblox Studio.

History 2

MasterVolume

TypeDefault
float

A float between 0 and 1 representing the volume of the game's client.

History 8

MasterVolumeStudio

TypeDefault
float

History 1

MaxQualityEnabled

TypeDefault
bool

History 1

MouseSensitivity

TypeDefault
float

A float between 0 and 4 representing the sensitivity of the client's camera sensitivity.

History 4

OnboardingsCompleted

TypeDefault
string

History 4

PartyVoiceVolume

TypeDefault
float

History 1

PerformanceStatsVisibleChanged

Parameters (1)
isPerformanceStatsVisiblebool

History 2

RCCProfilerRecordFrameRate

TypeDefault
int

History 4

RCCProfilerRecordTimeFrame

TypeDefault
int

History 4

ResetOnboardingCompleted

Parameters (1)
onboardingIdstring
Returns (1)
null

History 3

RotationType

TypeDefault
RotationType

Controls how the client's character is rotated.

History 4

SavedQualityLevel

TypeDefault
SavedQualitySetting

The graphics quality level set by the client.

History 8

SetCameraYInvertVisible

Parameters (0)
No parameters.
Returns (1)
null

If called, Roblox toggles the menu option to invert the user's camera y axis.

History 3

SetGamepadCameraSensitivityVisible

Parameters (0)
No parameters.
Returns (1)
null

If called, Roblox toggles the menu option to control the camera sensitivity with gamepads.

History 5

SetOnboardingCompleted

Parameters (1)
onboardingIdstring
Returns (1)
null

Sets the given onboarding as completed, so it won't be shown again to the user the next time they play.

Currently, this function only accepts DynamicThumbstick, and it is used to persistently track whether or not the player has finished the tutorial for the Dynamic Thumbstick control scheme. If onboardingId is not one of the accepted IDs, an error is thrown.

The onboarding process is one-way. This means that, as a developer, you can force the onboarding process to completion but cannot reset it.

See also:

History 3

SetTutorialState

Parameters (2)
tutorialIdstring
valuebool
Returns (1)
null

History 3

StartMaximized

TypeDefault
bool
This property is not scriptable. It cannot be accessed by script code.
This property is not replicated. Its interface does not cross the network boundary.

History 4

Tags: [NotReplicated, NotScriptable]

StartScreenPosition

TypeDefault
Vector2
This property is not scriptable. It cannot be accessed by script code.
This property is not replicated. Its interface does not cross the network boundary.

History 4

Tags: [NotReplicated, NotScriptable]

StartScreenSize

TypeDefault
Vector2
This property is not scriptable. It cannot be accessed by script code.
This property is not replicated. Its interface does not cross the network boundary.

History 4

Tags: [NotReplicated, NotScriptable]

StudioModeChanged

Parameters (1)
isStudioModebool

Fired when the user's client switches between studio mode and in-game mode. This gets fired periodically in Roblox Studio when a session starts.

History 2

TouchCameraMovementMode

TypeDefault
TouchCameraMovementMode

The camera type in-use by the client while on a mobile device.

History 4

TouchMovementMode

TypeDefault
TouchMovementMode

The type of controls being used by the client on a mobile device.

History 4

UsedCoreGuiIsVisibleToggle

TypeDefault
bool

History 4

UsedCustomGuiIsVisibleToggle

TypeDefault
bool

History 4

UsedHideHudShortcut

TypeDefault
bool

History 4

VREnabled

TypeDefault
bool

History 4

VRRotationIntensity

TypeDefault
int

History 6

VRSmoothRotationEnabled

TypeDefault
bool

History 2

VignetteEnabled

TypeDefault
bool

History 4

Removed members 5

ImageUploadPromptBehavior

TypeDefault
UploadSetting

History 4

VideoUploadPromptBehavior

TypeDefault
UploadSetting

History 4

Settings