Configuration

All configuration files are in script/shared/config/:

File	Purpose
`main.lua`	Core settings (max characters, accent color, delete toggle, etc.)
`locations.lua`	Interior locations, seat positions, camera settings
`animations.lua`	Sitting animations and ghost ped clothing

Main Config (main.lua)

return {
  framework = 'auto',              -- 'auto', 'esx', 'qbcore', 'qbox', 'ox_core'
  maxCharacters = 5,               -- max character slots (1-5)
  appearanceResource = 'auto',     -- 'auto' or specific resource name
  enableDelete = true,             -- allow character deletion
  deleteConfirmText = 'DELETE',    -- text user must type to confirm deletion
  accentColor = '#f0fb29',         -- UI accent color (hex)
  debugHitboxes = false,           -- show seat hitbox outlines for tuning
  defaultSpawn = vector4(-269.4459, -955.3174, 31.2231, 203.7947),
  defaultMaleModel = `mp_m_freemode_01`,
  defaultFemaleModel = `mp_f_freemode_01`,
  ghostAlpha = 100,                -- transparency of unselected character peds (0-255)
}

Setting	Default	Description
`framework`	`'auto'`	Framework to use — auto-detects if set to `'auto'`
`maxCharacters`	`5`	Maximum character slots (1–5)
`appearanceResource`	`'auto'`	Appearance resource — auto-detects if set to `'auto'`
`enableDelete`	`true`	Allow character deletion
`deleteConfirmText`	`'DELETE'`	Text the player must type to confirm deletion
`accentColor`	`'#f0fb29'`	UI accent color (hex color)
`debugHitboxes`	`false`	Show seat hitbox outlines for position tuning
`defaultSpawn`	vector4	Default spawn coordinates after character select
`defaultMaleModel`	`mp_m_freemode_01`	Default male ped model
`defaultFemaleModel`	`mp_f_freemode_01`	Default female ped model
`ghostAlpha`	`100`	Transparency of unselected character peds (0–255)

Multiple Locations

Add additional entries to config/locations.lua for random location selection on join. Each location can specify a gamebuild requirement — locations requiring a higher gamebuild than the client's will be skipped.

Installation