Troubleshooting

Common issues and solutions for Tommy's Radio system.

Critical IssuesAudio ProblemsConfiguration

🎤 Microphone Issues

Problem: Microphone not working in-game

Solution Steps

Open radio using your configured radio key
Access settings by pressing the "ST" button
Navigate to microphone using arrow keys (not CH up/down)
Try different microphone devices from the list
Check FiveM permissions - ensure you clicked "Allow" for microphone access

Permission Reset

If you denied microphone permission, clear FiveM cache to get the permission prompt again.

Quick Fix: Most microphone issues are solved by selecting the correct input device in radio settings.

🔌 Connection Issues

Problem: Can't connect to radio server

Checklist

fx_version is set to 'bodacious' in fxmanifest.lua
Port (default: 7777) is open in firewall
Server is running without errors
Network connection is stable

Check fxmanifest.lua

fx_version 'bodacious'

Firewall Testing

Use an online port checker to verify your configured port is accessible externally.

Common Ports

Default port is 7777. Make sure no other services are using this port.

📞 Dispatch Panel Problems

Problem: Can't talk on dispatch panel

Browser Issues

Microphone blocked - Check browser permissions
HTTP limitation - Use HTTPS or desktop app
WebRTC disabled - Enable in browser settings

Solutions

Use desktop app (recommended)
Enable Chrome flag for development: unsafely-treat-insecure-origin-as-secure
Setup HTTPS for production use

References:

🚨 Emergency Features Not Working

Problem: Panic button or Signal 100 not functioning

Common Causes

Issue	Cause	Fix
Can't activate Signal 100	NAC ID not authorized	Add NAC ID to `signalNacIds`
Panic not visible	GPS permissions missing	Check `visibleToNacs` in channel config
No emergency sounds	Audio disabled	Verify `playTransmissionEffects = true`

Signal 100 Configuration

Config.signalNacIds = {
    "100",  -- Police
    "141",  -- Dispatch
}

📡 GPS & Tracking Issues

Problem: GPS blips not showing or incorrect

Troubleshooting

Check NAC permissions in channel configuration
Verify GPS settings in radio menu
Confirm player locations are updating

GPS Configuration Example

gps = {
    color = 54,
    visibleToNacs = { "100", "200" }  -- Who can see GPS
}

🔊 Audio Problems

Problem: No voice chat or audio effects

Quick Fixes

Symptom	Solution
No voice at all	Check NAC ID channel access
No background effects	Enable `playTransmissionEffects`
Volume too low	Adjust `voiceVolume` and `sfxVolume`
Static/interference	Check `bonkingEnabled` setting

Audio Settings

Config = {
    voiceVolume = 60,                    -- Voice volume (0-100)
    sfxVolume = 20,                      -- Effects volume (0-100)
    playTransmissionEffects = true,      -- Background sounds
    analogTransmissionEffects = true,    -- Radio static
}

⚙️ Configuration Issues

Problem: Channels or zones not working correctly

Channel Access Issues

User can't connect - Check allowedNacs for their NAC ID
User can't scan - Verify scanAllowedNacs configuration
Wrong permissions - Review NAC ID assignment in framework integration

Zone Configuration

Zone Access Example

zones = {
    [1] = {
        name = "Statewide",
        nacIds = { "100", "200" },        -- Who can access zone
        Channels = {
            [1] = {
                name = "DISPATCH",
                allowedNacs = { "100" },   -- Who can connect
                scanAllowedNacs = { "200" } -- Who can scan only
            }
        }
    }
}

🐛 Debug & Testing

Enable Debug Logging

Debug Configuration

Config.logLevel = 4  -- Enable verbose logging

Debug Information

Level 0: Errors only
Level 1: Warnings
Level 2: Minimal info
Level 3: Normal operation
Level 4: Detailed debugging
Level 5: Verbose output

Performance Warning

Debug mode creates extensive console output. Disable in production.

Common Test Issues

Issue	Solution
Can't connect	Check firewall/port configuration
No microphone	Check browser permissions or use desktop app
Missing GPS	Verify NAC ID permissions in channel config
No voice	Check audio settings and NAC ID access

📋 Getting Additional Help

Before Asking for Help

Check server console for errors
Verify configuration against examples
Test on the demo server
Review this troubleshooting guide

Support Resources

Forum: FiveM Community Post
Documentation: Review setup and configuration guides
Demo Server: Test functionality on working server

When Reporting Issues

Include this information:

Error messages from server console
Configuration sections related to the problem
Steps taken to reproduce the issue
Server framework (QBCore, ESX, etc.)

🔧 Quick Reference

Essential Config Values

Security Settings

authToken = "your-secure-token"      -- Change from default!
dispatchNacId = "141"                -- Dispatch access code
serverPort = 7777                    -- Voice server port

Default Controls

Default Keybinds

talkRadioKey = "B"                   -- Push-to-talk
toggleRadioKey = "F6"                -- Open/close radio

Framework Integration

Required Functions

getUserNacId(serverId)               -- Return user's NAC ID
getPlayerName(serverId)              -- Return display name
radioAccessCheck(playerId)           -- Return access permission

Setup & Configuration

Complete installation and configuration guide for Tommy's Radio system.

API Reference

Complete API reference for Tommy's Radio exports, functions, and events.

On this page

🎤 Microphone Issues 🔌 Connection Issues 📞 Dispatch Panel Problems 🚨 Emergency Features Not Working 📡 GPS & Tracking Issues 🔊 Audio Problems ⚙️ Configuration Issues 🐛 Debug & Testing 📋 Getting Additional Help 🔧 Quick Reference Essential Config Values Default Controls Framework Integration