⚠️ 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

📱 Menu appears broken/misaligned

UI/CSS issues:

1. Clear browser cache: Force refresh with Ctrl+F5

2. Check CSS files: Ensure nui/style.css isn't corrupted

3. Screen resolution: Test on different resolutions

4. Disable other UI mods: Temporarily disable conflicting resources

CSS reset command:

-- Add to restore default styles
RegisterCommand('resetmenu', function()
    TriggerEvent('syntax_pausemenu:client:resetStyles')
end)

---

📞 Support & Contact

Still need help?

• 💬 Discord: Syntax Store Community

---

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