Docs
Sit Anywhere
Configuration

Configuration

All options are in config.lua.

#General

Option	Default	Description
`Config.Locale`	`'en'`	Interface language: `'en'` or `'tr'`.
`Config.Target`	`'qb-target'`	`'qb-target'`, `'qtarget'` or `'ox_target'`.
`Config.ControlMode`	`'target'`	`'target'`, `'commands'` or `'both'`.
`Config.MaxInteractionDist`	`2.0`	How far the target eye reaches.
`Config.AddChatSuggestions`	`false`	Chat suggestions for `/sit` and `/lay`.

#Free placement

Config.FreePlace:

Option	Default	Description
`enabled`	`true`	Turns free placement off completely.
`command`, `key`	`'perch'`, `'U'`	Command and default key.
`maxDistance`	`3.0`	How far from the player the spot can be.
`minSitHeight`, `maxSitHeight`	`-1.0`, `1.5`	Lowest and highest surface the player can use, measured from their feet.
`chairMinDrop`	`0.38`	Below this drop a spot counts as the ground and uses the ground animations.
`minSitNormalZ`	`0.7`	Steepest usable slope: 1.0 is flat, 0.7 is about 45 degrees.
`maxTilt`	`30.0`	How far the body tilts with a slope, in degrees.
`returnAboveHeight`	`0.35`	Getting up from a spot higher than this above the feet returns the player to where they stood.
`maxLeanNormalZ`	`0.5`	How tilted a wall may be (0 = perfectly vertical).
`minLeanWallHeight`	`0.35`	Lowest wall that can be leaned on.
`leanBackDepth`	`0.22`	Distance between the player's centre and the wall. Raise it if the back goes into a wall.
`leanRootHeight`	`1.0`	Height of the player's centre while leaning.
`allowSitOnVehicles`	`true`	Sit or lie on parked vehicles. The action ends when the vehicle moves.
`allowLeanOnVehicles`	`true`	Lean on vehicles.
`autoFit`	`true`	Turn and nudge the player out of walls after sitting or lying.
`debug`	`false`	Prints placement details to the F8 console.

#Abuse protection

Option	Default	Description
`cooldown`	`1500`	Milliseconds between two confirmed actions.
`cancelOnDamage`	`true`	Taking damage cancels the action.
`maxActionRadius`	`8.0`	The action ends if the player ends up farther than this from where it began.

#Position editor

Config.PositionAdjust:

Option	Default	Description
`useKeys`	`false`	`true` brings back the classic arrow-key adjusting.
`adjustControl`	`47`	Control that opens the editor (47 = G). Update the locale text if you change it.
`gizmoMaxMove`	`3.0`	How far (m) the editor can move the seat sideways or forward.
`gizmoMaxUp`, `gizmoMaxDown`	`1.5`, `1.0`	How far up and down (m).

#Animations

Config.SitAnimations and Config.LayAnimations: the animations players can pick in the editor. Each entry has an id, an animation dict and name, and an offset that places the player on the seat.
Config.FreePlace.leanPoses: the leaning poses. Each has a base animation, an optional overlay (upper-body animation) and an optional prop (held item and its position in the hand).

Note

Add a new entry to a list and give it a name in locales/en.lua and locales/tr.lua under Animations or FreePlace.Poses. Animations that do not exist in the game build are hidden or refused automatically.

#Translations

Interface texts are in locales/en.lua and locales/tr.lua. Text such as [E] Sit here | [Backspace] Cancel becomes one key badge per part, keep the [key] label format when you translate.