• With Config.Phone.requireItem = true the player needs the item. Its name must match Config.Phone.itemName exactly.

• The player may have changed the key. Check Settings → Key Bindings → FiveM → Open Phone. Changing openKey in the config only changes the default for players who never set it.

• The player is handcuffed. With blockWhenRestricted = true the phone is blocked; adjust framework:isPhoneRestricted() in custom/<framework>/ if your cuff script sets a flag you do not use.

• Another script called ToggleDisabled(true) (a jail or minigame) and never turned it back.

ox_inventory ships an npwd handler for the phone item. Comment it out in ox_inventory/modules/items/client.lua as shown in Installation, and restart ox_inventory.

The open key always uses the first phone in the inventory. To open the one the player clicked, add server = { export = 'qs-smartphone.useItem' } to the phone item in ox_inventory and remove the npwd handler.

The item names must match Config.Platform.androidItemName, Config.Fold.iosItemName and Config.Fold.androidItemName. The Nova item is only used when Config.Platform.mode = 'item'; in 'settings' mode the skin is chosen in Settings.

Make sure smartphone-prop is started before the phone, that the folder is named qs-smartphone, and that you uploaded the complete download from the CFX Portal. If you replaced files during an update, upload the whole qs-smartphone folder again, keeping only your config files.

The file uses JSON columns and ADD COLUMN IF NOT EXISTS, which need MariaDB 10.6 or newer. Older MySQL versions and local stacks like XAMPP fail on them. Update the database server and import again.

Import the new [sql]/database.sql again. It only adds what is missing and keeps your data.

Run /phonediag (admin) or phonediag in the console. It prints how each online player's number is found, and the inventory and framework the phone detected. Usually the inventory does not save item metadata, or Config.MetaSystem.enabled was changed on a live server.

phoneNumberPrefix must be a string ('06', not 06, which drops the zero), and the number of X in phoneNumberMask must equal the prefix length plus phoneNumberLength. Existing numbers keep their old format; only new ones change.

Voice in calls comes from your voice script. Check that pma-voice (or your Mumble-based voice) is running and that voice works outside the phone. Start the voice script before the phone.

• A TURN server is required. Without one, players see a warning and video calls stay off. Set up Cloudflare or Metered as in Installation.

• Cloudflare returns 404: you created a Realtime SFU app. Create a TURN app instead and use its TURN Token ID and API Token.

• Run phone:turn:status in the server console. With no cached servers, the keys are wrong; phone:turn:refresh tries again.

• Video only works with at least mid signal. If it works for some players only, try forceRelay = true.

The player is in a no-signal zone or the battery is at 0%. Look at the signal bars on the phone. Enable Config.Signal.debug to see the zones, and edit or remove the ones you do not want in Config.Signal.zones.

xsound must be running (or qs-3dsound / mx-surround). Also check the phone's volume and Silent Mode in Settings, and that the player is not wearing earbuds, which send all audio to them only.

Service numbers ring online players whose job is in the line's jobs list with at least minGrade. Check that the job names in Config.ServiceNumbers match your framework exactly.

No media host is set. Add your FiveManage token or FiveMesh key in server/webhooks.lua and restart. With FiveMesh, the key needs the cdn:write permission. Also check that the phone has free storage.

Online apps need mid signal by default. Lower an app's requirement in Config.Signal.policy.appMinLevel, or add it to offlineApps.

The phone did not detect your garage, billing or housing script. Start it before qs-smartphone. If you renamed the resource, add the new name to the detection table in config/main.lua (see Integrations). The Home app needs qs-housing 5.3.2 or newer.

Start it after qs-smartphone. Integrated apps also need their Quasar script running first; otherwise the console shows a missing dependency and the resource does not start.

qs-smartphone-aura is not started, or Config.Aura.enabled = false. Ensure the add-on after the phone; the console prints a warning while it is missing.

Wallet and Messages transfers need the recipient online, and the amount within the min and max in Config.Wallet or Config.Messages. If your server uses other account names, check the mapping in custom/<framework>/server.lua.

• With Config.Phone.requireItem = true the player needs the item. Its name must match Config.Phone.itemName exactly.

• The player may have changed the key. Check Settings → Key Bindings → FiveM → Open Phone. Changing openKey in the config only changes the default for players who never set it.

• The player is handcuffed. With blockWhenRestricted = true the phone is blocked; adjust framework:isPhoneRestricted() in custom/<framework>/ if your cuff script sets a flag you do not use.

• Another script called ToggleDisabled(true) (a jail or minigame) and never turned it back.

ox_inventory ships an npwd handler for the phone item. Comment it out in ox_inventory/modules/items/client.lua as shown in Installation, and restart ox_inventory.

The open key always uses the first phone in the inventory. To open the one the player clicked, add server = { export = 'qs-smartphone.useItem' } to the phone item in ox_inventory and remove the npwd handler.

The item names must match Config.Platform.androidItemName, Config.Fold.iosItemName and Config.Fold.androidItemName. The Nova item is only used when Config.Platform.mode = 'item'; in 'settings' mode the skin is chosen in Settings.

Make sure smartphone-prop is started before the phone, that the folder is named qs-smartphone, and that you uploaded the complete download from the CFX Portal. If you replaced files during an update, upload the whole qs-smartphone folder again, keeping only your config files.

The file uses JSON columns and ADD COLUMN IF NOT EXISTS, which need MariaDB 10.6 or newer. Older MySQL versions and local stacks like XAMPP fail on them. Update the database server and import again.

Import the new [sql]/database.sql again. It only adds what is missing and keeps your data.

Run /phonediag (admin) or phonediag in the console. It prints how each online player's number is found, and the inventory and framework the phone detected. Usually the inventory does not save item metadata, or Config.MetaSystem.enabled was changed on a live server.

phoneNumberPrefix must be a string ('06', not 06, which drops the zero), and the number of X in phoneNumberMask must equal the prefix length plus phoneNumberLength. Existing numbers keep their old format; only new ones change.

Voice in calls comes from your voice script. Check that pma-voice (or your Mumble-based voice) is running and that voice works outside the phone. Start the voice script before the phone.

• A TURN server is required. Without one, players see a warning and video calls stay off. Set up Cloudflare or Metered as in Installation.

• Cloudflare returns 404: you created a Realtime SFU app. Create a TURN app instead and use its TURN Token ID and API Token.

• Run phone:turn:status in the server console. With no cached servers, the keys are wrong; phone:turn:refresh tries again.

• Video only works with at least mid signal. If it works for some players only, try forceRelay = true.

The player is in a no-signal zone or the battery is at 0%. Look at the signal bars on the phone. Enable Config.Signal.debug to see the zones, and edit or remove the ones you do not want in Config.Signal.zones.

xsound must be running (or qs-3dsound / mx-surround). Also check the phone's volume and Silent Mode in Settings, and that the player is not wearing earbuds, which send all audio to them only.

Service numbers ring online players whose job is in the line's jobs list with at least minGrade. Check that the job names in Config.ServiceNumbers match your framework exactly.

No media host is set. Add your FiveManage token or FiveMesh key in server/webhooks.lua and restart. With FiveMesh, the key needs the cdn:write permission. Also check that the phone has free storage.

Online apps need mid signal by default. Lower an app's requirement in Config.Signal.policy.appMinLevel, or add it to offlineApps.

The phone did not detect your garage, billing or housing script. Start it before qs-smartphone. If you renamed the resource, add the new name to the detection table in config/main.lua (see Integrations). The Home app needs qs-housing 5.3.2 or newer.

Start it after qs-smartphone. Integrated apps also need their Quasar script running first; otherwise the console shows a missing dependency and the resource does not start.

qs-smartphone-aura is not started, or Config.Aura.enabled = false. Ensure the add-on after the phone; the console prints a warning while it is missing.

Wallet and Messages transfers need the recipient online, and the amount within the min and max in Config.Wallet or Config.Messages. If your server uses other account names, check the mapping in custom/<framework>/server.lua.