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 garage key purchases are disabled. It is hidden when Config.Settings.keys.useIdentifierAccess is enabled because access is then based on character identifiers rather than key items.

#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.keys.repayOnCleanup percentage. This setting is hidden when identifier-based access is enabled.

#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.

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.

#Vehicle Exit Procedure

Controls whether tapping or holding the vehicle exit button preserves the engine state.

This setting reverses the exit-button behavior. When it is Enabled, holding the exit button is the deliberate action used to preserve the current engine state. Changing it to Disabled swaps the actions: tapping preserves the engine state, while holding stops the engine.

Value	Tap exit	Hold exit
Disabled	Keeps the engine running.	Stops the engine.
Enabled (default)	Stops the engine.	Keeps the current engine state.

In the configuration this setting is named holdExitToKeepState. The name describes the enabled behavior; disabling it intentionally reverses that behavior.

#Auto-Start Engine

Controls whether Garages starts an initialized vehicle when the player enters the driver's seat.

Value	Behavior
Disabled	Leaves the engine in its current state.
Enabled (default)	Starts an off engine when the player enters as the driver. This happens on entry only, so the engine can still be turned off manually afterward.

#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.