Start
Start order
The order resources must start in, and what FX Phone detects by itself when it starts.
#The order in server.cfg
FX Phone looks for the framework, inventory, voice, sound and bank resources once, when it starts. A resource that starts later is not seen. Start FX Phone after all of them, and start the bundled apps after FX Phone.
cfgensure oxmysql
ensure qb-core # or qbx_core / es_extended
ensure ox_inventory # or qb-inventory
ensure pma-voice # or mumble-voip / saltychat
ensure tgiann-bank # optional: or qb-management / Renewed-Banking / esx_society + esx_addonaccount
ensure fx-sound # optional: or xsound
ensure Renewed-Weathersync # optional: or qb-weathersync / cd_easytime
ensure fx-phone-assets # optional
ensure fx-phone
ensure [fx-apps] # optional: always after fx-phone
oxmysql is the only dependency in the manifest, so FiveM does not enforce the rest of the order for you.
#What is detected by itself
Each of these settings is 'auto' by default. Set a name only to force one.
| Setting | 'auto' picks |
|---|---|
Config.Framework |
The first running one of: custom (only when named), Qbox, QBCore, ESX, standalone |
Config.Inventory |
ox_inventory if it is installed, otherwise qb-inventory on QBCore or Qbox, otherwise standalone |
Config.Voice |
pma-voice, then mumble-voip, then SaltyChat |
Config.Sound.Resource |
fx-sound, then xsound, otherwise sounds play for the owner only |
Config.Bank.Adapter |
tgiann-bank, qb-management, Renewed-Banking, esx_society, then the framework |
Config.Weather.Sync |
A running weather sync resource, otherwise the game's own weather |
Config.Screenshot |
screenshot-basic or utk_render, used only as a camera fallback |
If you name a framework that is not running, FX Phone says so in the console and detects one itself.
With the standalone inventory every player counts as holding the phone item. ESX without ox_inventory ends up there.
#Signs of a wrong order
| Console line or symptom | Meaning |
|---|---|
qb-core is installed but not started yet. Ensure fx-phone after your framework. |
The framework starts after FX Phone |
framework: standalone on a framework server |
Same |
Config.Framework is "esx" but it is not running, detecting automatically. |
Wrong value, or wrong order |
Config.Bank.Adapter is "x" but it is not available |
The bank resource is not running yet |
| Calls connect but nobody hears anything | The voice resource starts after FX Phone |
| A bundled app is missing from the phone | The app started before FX Phone, or is switched off in Config.BundledApps |
#Bundled apps
Config.BundledApps in configs/config_apps.lua lists the Fixitfy app resources. An app set to false there never starts: FX Phone cancels its start, and stops it if it was already running when FX Phone started. An app that is not installed is ignored.
#What needs a restart
| You changed | Do this |
|---|---|
config.lua or a file in configs/ |
Restart fx-phone. They are read once on start, by the server and by every player |
config_server.lua |
Restart fx-phone |
| A locale file | Restart fx-phone |
| An item in your inventory | Restart the inventory, or the server |
| The start order, or a new framework, inventory, voice or bank resource | Restart the server |
fx-phone-assets started while players were online |
Those players reconnect to see the phone model |
| A setting on the admin tablet | Nothing. Tablet settings apply at once and are kept in the database |
After a restart of fx-phone alone, players with a loaded character get their phone back without reconnecting.
A value set on the admin tablet wins over the config files. Once a setting has been changed on the tablet, editing the same option in the config no longer has an effect. See Admin tablet.