Start

Troubleshooting

Common console messages and symptoms, their causes and fixes, and how FX Phone handles load.

Read the server console first. Setup problems are printed with the [fx-phone:<area>] prefix and name what is missing.

#Console messages and symptoms

Console message or symptom Cause Fix
qb-core is installed but not started yet. Ensure fx-phone after your framework. Start order See Start order
framework: standalone on a framework server The framework started after fx-phone Fix the order
Config.Framework is "esx" but it is not running, detecting automatically. Wrong value or order Set 'auto' or fix the order
[fx-phone:schema] statement failed: CREATE TABLE ... The database user cannot create tables Grant CREATE, ALTER, INDEX, or import install.sql by hand
[fx-phone:schema] setup/install.sql is missing Incomplete copy Copy the whole folder again
Phone does not open, a notice says you need a phone No phone item See Item setup, or set Config.Item = false
"You need a phone" on ESX ESX without ox_inventory has no inventory adapter Install ox_inventory, or set Config.Item = false
Phone does not open, nothing happens The character is not loaded yet, or another resource refuses it with AddCheck Wait for the character. Turn on Config.Debug and look for open refused in the F8 console
uploads are off: ServerConfig.Upload.Provider "x" is not available Provider name misspelt See Upload
fivemanage presign failed: no API key in ServerConfig.Upload.Fivemanage Key missing Add the key
fivemanage presign failed: presigned URL request answered 401 Wrong or revoked key Create a new key
relay enrolment answered 403, retrying in 360 minutes The relay refused this server Contact Fixitfy. Uploads stay off until then
Photos are taken but never appear Upload provider is 'none', misspelt, or has no key The server console says which
No call audio Voice resource missing, or started after fx-phone Check Config.Voice and the start order
Nearby players do not hear ringtones Neither fx-sound nor xsound runs, or the player switched 3D sounds off in Settings Install one
Config.Bank.Adapter is "x" but it is not available Resource not running Fix the order or use 'auto'
Paying a company invoice fails No job account for that job Use a bank adapter with job accounts, or set cutSender to 0
CoinGecko prices unavailable (...) Outbound HTTP blocked or rate limited Raise RefreshMinutes, add an API key, or set ServerConfig.Crypto.CoinGecko = false
webhook#123: log dropped (HTTP 404) Webhook deleted Replace the URL
Config.CustomApps entry x skipped: invalid_ui ui is not an https URL or resource/path See Custom apps
no free number or IBAN left for ... Number.Length too short for your player count Raise it
Version check failed: GitHub could not be reached Outbound HTTP blocked Harmless. Config.VersionCheck = false silences it
payload for ... is ... bytes, over the 16384 byte budget A very large home layout or settings Harmless. Report it with the identifier
video calls are off: ServerConfig.Video has no TURN server, Hosted is false and AllowDirect is false No relay configured See Video relay
<resource> is switched off in Config.BundledApps, not starting it. The app is set to false Set it to true in configs/config_apps.lua
The tablet says no access No role See Admin. fxphone:admin <id> in the console tells you whether the player has one
The character runs on by itself with the phone open The game missed a key release Leave Config.MovementGuard on
Esc no longer opens the pause menu The phone is open While the phone is open, Esc closes it
A line mentioning Content Security Policy in F8 The page tried to load something the policy does not allow The line names the directive and the address. See Installation

#Performance

How FX Phone keeps its load down:

  • With the phone closed FX Phone runs no loop on the client. While it is open, one thread checks the look-around key, the pause menu and the prop every 100 ms. Calls add a 200 ms talking check only while a call is active.
  • No net event is larger than 8 KB. Bigger answers are split into numbered parts. Joining sends one small bootstrap; contacts, chats, photos and feeds are loaded by the app that shows them, one page at a time.
  • Server pushes carry the change, not the list. Marketplace, News and Services push live updates only to players who have that app open.
  • Uploads go from the player's game to the provider. The game server only signs the request.
  • Requests that move money accept an optional requestId (8 to 64 characters): bank transfers, crypto buy, sell and transfer, invoice payments and new Marketplace listings. A repeat with the same id within 60 seconds gets the first answer instead of running again, so a retry after a slow answer never moves the money twice. Every money move also holds a per-character lock, so two moves for the same character never overlap.
  • Crypto prices are fetched once per interval for the whole server. GIF searches are cached for 10 minutes.
  • Webhooks are queued and spaced. A slow Discord never blocks a player's request.
  • The daily clean-up and the snapshot run at 04:00 and 04:30 server time and yield between pages.

#Asking for support

When you contact Fixitfy, include the version, your framework, the console lines tagged fx-phone, and the day's file from logs/ if the problem involves a logged action. Do not send config_server.lua.