⚠️ FAQ

❓ FAQ - Syntax PauseMenu

📄 Page Description (Optional)

Here are the most common questions and answers about Syntax PauseMenu. If your issue isn't listed here, feel free to reach out via Discord.


🤔 Frequently Asked Questions

❓ What frameworks are supported?

Syntax PauseMenu supports the following frameworks:

  • ESX Legacy (Latest versions)

  • QBCore (Latest versions)

  • Auto-detection mode that automatically identifies your framework

The script uses Config.Framework = 'auto' by default, which will automatically detect your framework. You can also manually set it to 'esx' or 'qbcore' if needed.

❓ How do I open the configuration menu?

The pause menu can be opened in several ways:

  1. Default Key: Press ESCAPE (configurable in Config.OpenKey)

  2. Programmatically: Use the client event:

    TriggerEvent('syntax_pausemenu:client:openMenu')
  3. Command: You can add a custom command in your server resources

To change the open key, modify Config.OpenKey in the configuration file.

❓ Do notifications save after a server restart?

No, the pause menu data is session-based and does not persist after server restarts. This includes:

  • Player information cache

  • Menu state

  • Announcement rotation position

However, all configuration settings persist since they're stored in the config file. The menu will reload with your configured settings on each server restart.

❓ Is it possible to customize themes or colors?

Yes! The pause menu is highly customizable:

CSS Customization:

  • Edit nui/style.css to change colors, fonts, and layouts

  • Modify announcement colors in the config:

    color = "#FFD700",
    backgroundColor = "rgba(255, 215, 0, 0.1)"

Logo Customization:

  • Replace nui/assets/logo.png with your custom logo

  • Configure in Config.Logo settings

Audio Customization:

  • Replace sound files in nui/assets/

  • Configure in Config.Sounds settings

❓ Does this work with OneSync Infinity?

Yes! Syntax PauseMenu is fully compatible with OneSync Infinity and includes several optimizations:

  • Optimized for high player counts

  • Efficient data synchronization

  • Minimal server performance impact

  • Built-in performance controls

For servers with high player counts, consider adjusting:

Config.Performance = {
    updateInterval = 2000  -- Update every 2 seconds instead of 1
}
❓ How do I add custom sounds?

To add custom sounds to your pause menu:

  1. Add MP3 files to nui/assets/ folder

  2. Update the config:

    Config.Sounds = {
        enabled = true,
        customSound = {
            file = 'my_custom_sound.mp3',
            volume = 0.5
        }
    }
  3. Call the sound in your code:

    -- From client-side
    TriggerEvent('syntax_pausemenu:client:playSound', 'customSound')

Supported formats: Only MP3 files are supported for maximum compatibility.

❓ Can I add custom buttons to the menu?

Absolutely! You can add custom buttons to the side menu:

Config.SideButtons = {
    -- Existing buttons...
    {
        name = 'teleport',
        label = 'teleport',
        icon = 'fas fa-map-marker-alt',
        enabled = true,
        action = 'teleport',
        confirmDialog = false
    }
}

Then handle the action in your client script:

RegisterNetEvent('syntax_pausemenu:client:buttonAction')
AddEventHandler('syntax_pausemenu:client:buttonAction', function(action)
    if action == 'teleport' then
        -- Your custom teleport code here
    end
end)
❓ How do I configure Discord webhooks?

To set up Discord logging:

  1. Create a webhook in your Discord channel

  2. Copy the webhook URL

  3. Configure in the script:

    Config.Discord = {
        enabled = true,
        webhookURL = 'https://discord.com/api/webhooks/YOUR_WEBHOOK_URL',
        botName = 'Pause Menu Logger',
        logActions = {
            buttonClick = true,
            disconnect = true
        }
    }

What gets logged:

  • Player disconnections

  • Button clicks (optional)

  • Menu usage statistics


🔧 Common Issues & Solutions

🚨 The menu doesn't open/appear

Possible solutions:

  1. Check server.cfg: Ensure ensure Syntax_PauseMenu is added

  2. Verify framework: Make sure ESX/QBCore is properly installed

  3. Check console errors: Look for any error messages

  4. Test with default key: Try pressing ESCAPE

  5. Restart resource: Use /refresh and /ensure Syntax_PauseMenu

Debug steps:

-- Add to client script for testing
RegisterCommand('testmenu', function()
    TriggerEvent('syntax_pausemenu:client:openMenu')
end)
🔇 Audio/sounds not working

Check these settings:

  1. Enable sounds in config:

    Config.Sounds = {
        enabled = true,  -- Make sure this is true
    }
  2. Verify file paths: Check that MP3 files exist in nui/assets/

  3. Browser audio: Ensure your browser/game allows audio autoplay

  4. File format: Only MP3 files are supported

  5. Volume settings: Check volume levels in config (0.0 - 1.0)

💰 Player money/info not displaying

Framework-specific solutions:

For ESX:

  • Ensure ESX is properly loaded before the menu

  • Check es_extended is started first

For QBCore:

  • Verify QBCore player data is available

  • Ensure qb-core is started first

General fixes:

-- Add dependency in fxmanifest.lua
dependency 'es_extended'  -- or 'qb-core'
🗺️ Map not showing/loading

Map troubleshooting:

  1. Enable map in config:

    Config.Map = {
        enabled = true,
    }
  2. Check map assets: Ensure map files are in nui/assets/

  3. Browser compatibility: Some browsers may block map loading

  4. Performance settings: Try adjusting map opacity and zoom


📞 Support & Contact

Still need help?


Before asking for help, please:

  1. ✅ Check this FAQ first

  2. ✅ Verify your server console for errors

  3. ✅ Test with default configuration

  4. ✅ Ensure you have the latest version


Last updated: October 2025 - Syntax PauseMenu v2.1

Last updated