rojo/.cursor/rules/roblox/reference/engine/classes/UserSettings.yaml
2026-02-02 12:08:47 -06:00

78 lines
2.4 KiB
YAML

# This file is automatically generated. Please don't edit it manually.
# To submit a bug report on the content, see
# https://devforum.roblox.com/c/bug-reports/documentation-issues/72
name: UserSettings
type: class
memory_category: Instances
summary: |
A singleton object that houses basic user settings, which persist across all
games on Roblox.
description: |
UserSettings is a singleton object that is used to house basic user settings,
which persist across all games. Currently, it only stores the
`Class.UserGameSettings` object.
You can retrieve a reference to this object via the
`Class.UserSettings|UserSettings()` function, which returns it.
code_samples:
- IsUserFeatureEnabled-Sample
- Full-Screen-Mode-Detection
- UserGameSettings-Listener
inherits:
- GenericSettings
descendants: []
tags:
- NotCreatable
deprecation_message: ''
properties: []
methods:
- name: UserSettings:IsUserFeatureEnabled
summary: |
Returns true if the specified user feature is enabled. This will throw an
error if the user feature does not exist.
description: |
Returns true if the specified user feature is enabled. This will throw an
error if the user feature does not exist.
This function checks against a list of FFlags, whose name starts with
"User". The function is intended to be used by Roblox-created scripts, and
functions similarly to `Class.GlobalSettings:GetFFlag()`.
code_samples:
- IsUserFeatureEnabled-Sample
parameters:
- name: name
type: string
default:
summary: ''
returns:
- type: boolean
summary: ''
tags: []
deprecation_message: ''
security: None
thread_safety: Unsafe
capabilities:
- Players
- name: UserSettings:Reset
summary: |
Erases the saved state of the UserSettings, and restores its default
values.
description: |
Erases the saved state of the UserSettings, and restores its values back
to default. This function will fail to run correctly from a LocalScript,
as it does not have permission to restore all of the properties in the
`Class.UserGameSettings` class.
code_samples: []
parameters: []
returns:
- type: ()
summary: ''
tags: []
deprecation_message: ''
security: None
thread_safety: Unsafe
capabilities:
- Players
events: []
callbacks: []