Personal Settings
A complete reference for the player-specific garage settings.
Personal settings let each player adjust how Garages behaves for them without changing the experience for anyone else. Open the menu with /gsettings, or use the settings button in the garage menu.
Changes are saved immediately in the player's local resource storage and remain after reconnecting. They are not tied to a character. If the resource owner locks a setting, the menu marks it as Locked and the configured default is used instead.
The default choice for every setting is marked in the tables below. Changing a setting applies its described behavior immediately; it does not require a resource or game restart.
#Settings Reference
#Display Locked Garages
Controls whether the map displays garages the player cannot access.
| Value | Behavior |
|---|---|
| Disabled (default) | Hides inaccessible garages for a cleaner map. |
| Enabled | Displays inaccessible garages on the map. Access restrictions still apply. |
#Display Individual Access Points
Controls how a garage with multiple access points is represented on the map.
| Value | Behavior |
|---|---|
| Disabled (default) | Uses one centered blip for the garage. |
| Enabled | Displays every configured access point separately. |
#Automatically Purchase Keys
Controls what happens when the player takes out an owned vehicle without having its key.
| Value | Behavior |
|---|---|
| Disabled | The player must purchase a key manually. |
| Enabled (default) | Automatically purchases the required key while taking out the vehicle. The configured key price still applies. |
This setting has no effect when Config.Settings.keyServices.disableGaragePurchase is enabled. It is hidden when the selected key provider uses identifier access because no physical replacement key is needed.
#Key Cleanup
Controls whether owned vehicle keys are removed when the vehicle is parked.
| Value | Behavior |
|---|---|
| Disabled (default) | Keeps the player's keys. |
| Enabled | Removes all matching keys from the player's direct inventory when they park a vehicle they own. Keys for borrowed vehicles are not removed. |
Keys stored inside inventory containers are not cleaned up. Any repayment uses the server's configured Config.Settings.keyServices.repayOnCleanup percentage. This setting is hidden when the selected provider uses identifier access or garage key purchases are disabled.
#Quick Spawn
Controls the garage menu's shortcut for taking out a vehicle.
| Value | Behavior |
|---|---|
| Disabled | Expanding a vehicle only opens its details. |
| Enabled (default) | Holding Shift while expanding a vehicle immediately attempts to spawn it. Normal availability and access checks still apply. |
#Close Menu After Spawn
Controls whether the garage interface remains open after a spawn attempt.
| Value | Behavior |
|---|---|
| Disabled (default) | Keeps the menu open. |
| Enabled | Closes the menu after the vehicle has spawned successfully. A failed attempt leaves it open. |
#Quick Enter Interior
Controls the shortcut for parking directly into a supported garage interior.
| Value | Behavior |
|---|---|
| Disabled | Parks the vehicle without using the quick-enter shortcut. |
| Enabled (default) | Holding Shift while parking stores the vehicle and takes the driver and passengers into the interior. |
When this is disabled, holding Shift has no special effect. The player parks normally and must enter the interior separately.
#Quick Enter Prompt
Controls whether the parking prompt explains the quick-enter shortcut.
| Value | Behavior |
|---|---|
| Disabled | Hides the shortcut reminder. |
| Enabled (default) | Shows the key combination when the garage supports interior entry. |
The prompt is only relevant while Quick Enter Interior is enabled.
#Automatic Garage Transfers
Controls how vehicles assigned to another garage are handled.
| Value | Behavior |
|---|---|
| Disabled (default) | Requires the player to use the separate transfer action first. |
| Enabled | Taking out the vehicle automatically pays the applicable transfer price, changes its assigned garage, and attempts to spawn it. |
The server's garage-transfer availability and pricing still apply. Enabling this setting does not bypass transfer restrictions or costs.
#Public Interior Access
Controls how other players can join the player's active public garage interior session.
| Value | Behavior |
|---|---|
| Ask (default) | Allows other players to request access. The session owner can then approve or reject the request. |
| Access List | Rejects new access requests; only players who already have access can enter. |
| Block | Blocks access requests and new invitations for the active session. |
#Show Public Interior Session
Controls who can see the player's active public garage interior in the session list.
| Value | Behavior |
|---|---|
| Disabled | Hides the session from players who are not on its access list. Players with access can still see and enter it. |
| Enabled (default) | Displays the active session in the public session list. Entry still follows the selected Public Interior Access mode. |
#Batch Switch Hint
Controls the keyboard reminder shown when a public interior contains more vehicles than can be displayed at once.
| Value | Behavior |
|---|---|
| Disabled | Hides the reminder. |
| Enabled (default) | Reminds the player that the arrow keys switch between vehicle batches when batch switching is available. |
#Nearby Garages Displayed
Limits regular garage blips to the closest garages, helping reduce map clutter.
| Value | Behavior |
|---|---|
| 1, 3, 5, 10, or 25 | Displays at most that many of the closest eligible regular garages. |
| All (default) | Displays every eligible garage. |
The closest-garage selection updates as the player moves. Impound blips are always displayed and do not count toward this limit. Locked-garage visibility still follows Display Locked Garages.
#Server Configuration
Resource owners configure the menu through Config.Settings.personalSettings in shared/unlocked/config.lua.
| Value | Default | Description |
|---|---|---|
command | "gsettings" | Command registered for opening the menu. Players use it as /gsettings. |
kvp | "garage_personal_settings" | Local KVP key used to store each player's selections. Changing it makes existing selections unavailable under the new key. |
settings | Current settings list | Defines which settings appear, their choices, defaults, and whether players may change them. |
Every entry in settings supports the following values:
| Value | Description |
|---|---|
name | Internal setting name. Keep the existing names because the resource uses them to apply each behavior. |
values | Choices shown in the menu. Current settings use arrays of booleans, strings, or numbers. The UI also supports "slider", which produces a value from 0 to 1 in steps of 0.025. |
default | Initial value used when the player has no saved selection. It should match one of the configured choices. |
force | When true, locks the setting to its configured default for everyone. The player's previously saved selection is preserved and becomes active again if the lock is later removed. |
Changing a default does not replace selections that players have already saved. Use force = true when the server must enforce a value for everyone.