Common Issues & FAQ

---

Issue 1: Phone won't open when pressing M

• Check Inventory Item: Verify your character has finals_phone in their inventory if Config.Phone.ItemRequired = true.
• Check Incapacitated State: If Config.Phone.BlockOpenWhenDead = true, unconscious or dead players cannot open their phone.
• Check Key Mapping: Open GTA V Pause Menu > Settings > Key Bindings > FiveM and verify finalsphone is bound to M.
• Check F8 Console: Verify that ox_lib and your framework are started before 5M_Phone.

---

Issue 2: "No Cellular Signal" popup appears

• Cause: The player is inside a restricted polygon dead zone defined in configuration/restrictedZone.lua.
• Solution: Open the Control Center and turn on Wi-Fi to restore Wi-Fi calling and internet access, or move out of the dead zone. You can also disable dead zones with Config.RestrictedZones.Enabled = false.

---

Issue 3: Database / SQL errors on startup

• Solution: Ensure you imported installation/sql/database.sql into your MySQL / MariaDB database.
• Verify your oxmysql database user has permissions to create tables and execute queries.

---

Issue 4: Voice calls have no audio

• Solution: Ensure your voice script (pma-voice) is started before 5M_Phone in server.cfg.
• Verify setr voice_enableSubmix 1 and setr voice_enableSpeakerSubmix 1 are set in server.cfg.

---

Issue 5: WebRTC video calls show black screen

• Solution: Ensure your Cloudflare TURN credentials in configuration/server/api.lua are valid.
• Verify FiveM client has CEF GPU acceleration enabled.