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.
You can access this object from a LocalScript via:
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.
Muestras de código
local gameSettings = UserSettings().GameSettings
local function onGameSettingChanged(nameOfSetting)
-- Fetch the value of this setting through a pcall to make sure we can retrieve it.
-- Sometimes the event fires with properties that LocalScripts can't access.
local canGetSetting, setting = pcall(function()
return gameSettings[nameOfSetting]
end)
if canGetSetting then
print("Your " .. nameOfSetting .. " has changed to: " .. tostring(setting))
end
end
gameSettings.Changed:Connect(onGameSettingChanged)Resumen
Propiedades
- leer paralelo
- leer paralelo
- leer paralelo
The camera movement mode currently in-use by the client on desktop.
- leer paralelo
The type of controls being used by the client on desktop.
- leer paraleloobsoleto
Toggles whether or not the client can use the Mouse Lock Switch mode.
- leer paralelo
- leer paralelo
Describes how sensitive the camera is when using a gamepad.
- leer paralelo
- leer paralelo
- leer paralelo
A float between 0 and 1 representing the volume of the game's client.
- leer paralelo
- leer paralelo
A float between 0 and 4 representing the sensitivity of the client's camera sensitivity.
- leer paralelo
- leer paralelo
- leer paralelo
- leer paralelo
Controls how the client's character is rotated.
- leer paralelo
The graphics quality level set by the client.
- no replicadono programableleer paralelo
- no replicadono programableleer paralelo
- no replicadono programableleer paralelo
- leer paralelo
The camera type in-use by the client while on a mobile device.
- leer paralelo
The type of controls being used by the client on a mobile device.
- leer paralelo
- leer paralelo
- leer paralelo
- leer paralelo
- leer paralelo
- leer paralelo
Métodos
Returns the camera's Y-invert value.
Checks if onboarding has been completed.
Returns true if the user's Roblox window is in full screen mode.
Returns true if the client's game session is in Roblox Studio.
If called, Roblox toggles the menu option to invert the user's camera y axis.
If called, Roblox toggles the menu option to control the camera sensitivity with gamepads.
Sets onboarding as completed.
Eventos
Fires if the user's full screen mode is changed.
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.
Propiedades
AllTutorialsDisabled
CameraMode
ChatVisible
ComputerCameraMovementMode
The camera movement mode currently in-use by the client on desktop.
ComputerMovementMode
The type of controls being used by the client on desktop.
ControlMode
Toggles whether or not the client can use the Mouse Lock Switch mode.
Fullscreen
GamepadCameraSensitivity
Describes how sensitive the camera is when using a gamepad.
GraphicsQualityLevel
HasEverUsedVR
MasterVolume
A float between 0 and 1 representing the volume of the game's client.
MasterVolumeStudio
MouseSensitivity
A float between 0 and 4 representing the sensitivity of the client's camera sensitivity.
OnboardingsCompleted
RCCProfilerRecordFrameRate
RCCProfilerRecordTimeFrame
StartMaximized
StartScreenPosition
StartScreenSize
TouchCameraMovementMode
The camera type in-use by the client while on a mobile device.
TouchMovementMode
The type of controls being used by the client on a mobile device.
UsedCoreGuiIsVisibleToggle
UsedCustomGuiIsVisibleToggle
UsedHideHudShortcut
VREnabled
VRRotationIntensity
VRSmoothRotationEnabled
VignetteEnabled
Métodos
GetOnboardingCompleted
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:
- UserGameSettings:SetOnboardingCompleted(), sets onboarding as completed
Parámetros
The onboarding ID to inquire about.
Devuelve
Whether or not the onboarding in particular has been completed yet.
SetCameraYInvertVisible
If called, Roblox toggles the menu option to invert the user's camera y axis.
Devuelve
SetGamepadCameraSensitivityVisible
If called, Roblox toggles the menu option to control the camera sensitivity with gamepads.
Devuelve
SetOnboardingCompleted
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:
- UserGameSettings:GetOnboardingCompleted(), checks if onboarding has been completed
Parámetros
The onboarding ID to set as completed.
Devuelve
Eventos
FullscreenChanged
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.
Parámetros
Muestras de código
local gameSettings = UserSettings().GameSettings
local function checkFullScreenMode()
local inFullscreen = gameSettings:InFullScreen()
if inFullscreen then
print("Full Screen mode enabled!")
else
print("Full Screen mode disabled!")
end
end
checkFullScreenMode()
gameSettings.FullscreenChanged:Connect(checkFullScreenMode)StudioModeChanged
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.