Suty Phone
Troubleshooting
Troubleshooting
Start with the server console and F8: lines starting with [suty-phone] say what the phone found when it started and what's missing. Config.Debug = true adds more (leave it off on a live server).
Installation
| Symptom | Fix |
|---|---|
suty-phone doesn't start |
Keep the folder named exactly suty-phone (a renamed copy doesn't run), and start suty-phone-assets and suty-phone-props before it. |
SQL errors about ADD COLUMN IF NOT EXISTS |
The database must be MariaDB. MySQL is not supported. |
A command in server.cfg runs by itself, or the file stops loading halfway |
A semicolon in a comment line: FiveM runs the text after it. Remove it. |
| Using a phone item does nothing (ox_inventory) | Copy the items exactly as in install/ox_inventory/items.lua (each has its client.export) and restart ox_inventory. |
| Using a phone item does nothing (qb-style inventories) | The phone items must be useable = true and unique = true. Do a full restart after editing the item list. |
| Phones lose their number when given away (ESX) | ESX's own inventory has no item data: numbers stay on the character. Use an inventory with metadata (Compatibility). |
| The phone models are invisible | suty-phone-props isn't started, or was restarted with players online. Restart the server. |
Phone and line
| Symptom | Fix |
|---|---|
| A player can't call, text or use the internet apps | The number has no Klaro plan, or it ran out. Emergency jobs (Config.Carrier.emergencyJobs) can always be called. Plans are activated at a Klaro store and renewed in the Klaro app. |
| Nobody can activate lines | Someone needs the klaro_tablet (and a job from Config.Carrier.store.jobs, unless it's false), or the Klaro NPC must be on (npc.enabled). Staff add NPCs with /ponerklaro. |
| The phone shows Sin SIM | That number was moved to another phone (number recovery or a Klaro replacement). That item is now just a phone. |
| A player forgot their passcode | /resetcodigo <id> removes it. Nothing else on the phone changes. |
| The phone won't turn on | Dead battery (/cargartel, a MagSafe battery), water damage (rice or a repair kit), or thrown too many times (repair kit or the repair shop). |
| The update won't install | It needs Config.NubeOS.minBattery (20 %) or the phone charging. |
| Left ALT does two things | It's also ox_target's and the pma-voice radio's key. Change Config.FocusKey, or each player rebinds it in GTA settings. |
| Notifications or commands are in Spanish | Set Config.Language = 'en' and restart. Command names you changed in config.lua keep your name. A text still in Spanish is missing from locale/en/lua.lua. |
| Players can't change their phone's language | Config.LanguageChoice = false locks every phone to Config.Language. Set it to true. |
| The console says Update available | A newer version is on the Cfx portal: download it from Granted assets and replace the suty-phone folder (Installation). |
Apps
| Symptom | Fix |
|---|---|
| Photos don't save, or vanish after an update | No Fivemanage key and photos are local: never delete suty-phone/media. Better, set set suty_phone_fivemanage_key in server.cfg. |
| Video calls don't connect, or only some players can | Players behind strict NAT need a TURN server: add the Cloudflare TURN convars (Installation). Without one the call falls back to the server relay, with fewer frames. |
| No GIF button | Add a KLIPY key. A test key allows only 100 searches an hour for the whole server. |
| The Bank app shows no history or invoices | Check Config.BankSystem and Config.BillingSystem, and start the banking resource before suty-phone. |
| Garajes is empty | Check Config.GarageSystem, or start your garage script before suty-phone. |
| El Punto says it's offline | It needs suty-drugsell started. |
| Tap Pay doesn't work | It needs suty-tappay with Config.Phone = 'suty-phone' there. |
| A Store app shows "Requires NubeOS" | That app comes with a newer NubeOS: the player updates in Settings › General › Software Update. |
| Songs on Fotogram stories fail | YouTube needs Python, yt-dlp and Node.js on the server, plus the Fivemanage key. If YouTube blocks your server's IP, use the suty_phone_ytdlp_cookies or suty_phone_ytdlp_proxy convars. |
| Admin tools don't show in Maps, Negocios or TuiteL | Give the ace: add_ace group.admin command.sphoneadmin allow. |
| A custom app doesn't show in the Store | Its resource must be started (after suty-phone is fine), its id must be free and not one of the phone's own, and Config.CustomApps.enabled must be on. Apps limited to jobs only show for those jobs. See Custom apps. |
| An app made for lb-phone doesn't add itself | lb-phone itself must not be started, and Config.Compat['lb-phone'] must be on. |
Still stuck?
Open a ticket on our Discord with the [suty-phone] lines of your server console and of F8.
