General settings
The main configuration file is shared/Config.lua. This page covers the top-level general settings. See the sidebar for framework, battery, signal and other system-specific sections.
Only files listed in the
escrow_ignore block of fxmanifest.lua are editable. Never edit escrow-protected files.Debug & Dev mode
lua
Config.DevMode = false -- verbose server/client logging
Config.Debug = false -- extra debug output
Config.DebugKeyPress = true -- log key press events (client)| Key | Default | Description |
|---|---|---|
| Config.DevMode | false | Enables verbose logging on both client and server |
| Config.Debug | false | Extra debug output for development |
| Config.DebugKeyPress | true | Logs key press events on the client side |
Locale & time
lua
Config.DefaultLocale = "pt-BR" -- "pt-BR" | "en-US"
Config.DateLocale = "pt-BR" -- date formatting locale
Config.DateFormat = "auto" -- "auto" or custom format string
Config.PhoneTimeMode = "game" -- "game" | "real"
Config.PhoneAudioLanguage = "pt-BR" -- "pt-BR" | "en"| Key | Options | Description |
|---|---|---|
| Config.DefaultLocale | "pt-BR" | "en-US" | Language shown in the phone UI |
| Config.DateLocale | locale string | Locale used for date/time formatting (e.g. day names) |
| Config.DateFormat | "auto" or format | Custom date format; auto uses the locale default |
| Config.PhoneTimeMode | "game" | "real" | Whether the clock shows GTA time or real-world time |
| Config.PhoneAudioLanguage | "pt-BR" | "en" | Language for TTS (text-to-speech) audio |
Keybind
lua
Config.OpenPhone = "k" -- key to open/close the phoneAny FiveM key name is valid (e.g. F1, k, BACK). Players can also rebind it in their GTA V key bindings menu after first use.
Spawn & preload
lua
Config.Preload = true -- pre-load player data on join
Config.Spawn.ServerSide = false -- server-side phone spawn control| Key | Default | Description |
|---|---|---|
| Config.Preload | true | Pre-loads phone data when the player joins, reducing first-open delay |
| Config.Spawn.ServerSide | false | When true, the server controls when the phone is given to the player |
Editable files
Files available for customization (in the escrow_ignore block):
- shared/Config.lua
- server/apiKeys.lua
- server/custom/
- client/custom/
- web/public/locales/