Give your server a branded Discord Rich Presence and keep in-game permissions perfectly in sync with your Discord roles – automatically, on every join. Ready to use out of the box – natively compatible with ESX, QBCore and Standalone.

✨ Features

• Branded Rich Presence – Custom app icon, large & small image assets and up to 2 clickable buttons (Discord invite, website).
• Live Status Line – Shows the player's current zone + server ID by default, fully replaceable with your own logic.
• Automatic Rolesync – Maps Discord roles to in-game groups and applies them the moment a player joins.
• Optional Whitelist Mode – No valid Discord role, no entry – enforced via loading-screen deferrals.
• Multi-Compatible – Auto-detects ESX, QBCore or falls back to pure ACE-based Standalone.
• Instant Resync – /syncroles command refreshes every online player's roles on demand.
• Rate-Limit Safe – Cached & request-queued Discord API calls stay reliable even during join bursts.

⚙️ Configuration

Everything is controlled centrally through the config.lua:

• Config.Framework – 'auto', 'esx', 'qbcore' or 'standalone'.
• Config.RichPresence – App ID, image assets, buttons and refresh interval.
• Config.Rolesync.RoleMap – Map your Discord role IDs to in-game groups, in priority order.
• Config.Rolesync.WhitelistOnly – Toggle whether unmapped players get rejected.

🛠️ Installation

1. Download and unpack the script.
2. Drop the nk_discord folder into your resources directory.
3. Add set discord_bot_token "YOUR_BOT_TOKEN" and ensure nk_discord to your server.cfg.
4. Fill in your Discord App ID, Guild ID and role mapping in config.lua.
5. Restart the server – done!

📦 Dependencies

A Discord application with a bot invited to your server (Server Members Intent enabled). Optional: es_extended or qb-core for framework-level group/permission syncing. Standalone requires no additional resources.