ND_DiscordUnified combines 30+ powerful modules into a single, unified resource. Built for RP servers that demand seamless Discord integration, real-time role syncing, and comprehensive server management.
What's Included
Core Systems
| Module | Description |
|--------|-------------|
| Discord API | Real-time role syncing with intelligent caching & rate limiting |
| Permissions | ACE permissions automatically granted via Discord roles with group inheritance |
| Whitelist | Role-based server access control with priority queue |
| Priority Queue | VIP/Staff queue priority system |
| Moderation | Full kick/ban/warn system with Discord DMs & database integration |
| Admin Roles | Global admin role configuration shared across all modules |
Player Systems
| Module | Description |
|--------|-------------|
| Chat Roles | Custom prefixes & colors by Discord role |
| Tag IDs | 3D overhead name tags with role-based styling |
| Weapon Perms | Restrict weapons by Discord role |
| Vehicle Whitelist | Role-based vehicle restrictions |
| TrustScore | Player trust & reputation scoring system |
| Player Profiles | In-game profile cards with stats, reputation & moderation history |
| Reputation | Community-driven player upvote/downvote system |
| Welcome | Customizable player welcome experience |
Security & Monitoring
| Module | Description |
|--------|-------------|
| Alt Detection | Automatic alt account detection via HWID/Discord/IP |
| IP Reputation | VPN/Proxy/Tor detection & blocking |
| Auto-Moderation | Chat filter, spam detection & caps detection with configurable actions |
| Link Verification | Require Discord account linking before joining |
| Session Tracker | Playtime tracking with leaderboards & player stats |
| Staff Activity | Staff action logging & duty tracking |
Communication & Events
| Module | Description |
|--------|-------------|
| Notifications | Beautiful in-game NUI notifications |
| 911 Emergency | Custom dispatch system with configurable blip duration |
| Report Player | In-game player report system |
| Announcements | Scheduled server announcements via Discord & in-game |
| Advanced Logging | 13+ log categories with Discord webhooks & rate limiting |
Server Management
| Module | Description |
|--------|-------------|
| Restart Scheduler | Automated restart warnings with Discord notifications |
| Maintenance Mode | Maintenance mode with role-based bypass |
| Role Sync | Two-way Discord role synchronization |
| Event Scheduler | In-game event scheduling with RSVP system |
| Custom Commands | Create custom commands with Discord slash command sync |
| Multi-Server | Cross-server player data sync (advanced) |
Rich Integration
| Module | Description |
|--------|-------------|
| Discord Rich Presence | Custom Discord status with live player count & buttons |
| Voice Sync | Discord voice channel sync with in-game proximity |
| Appeals | In-game ban appeal system with Discord integration |
Key Features
- Single Resource — One `ensure`, all features
- 30+ Modules — Every module toggleable independently
- Real-time Sync — Discord roles update instantly in-game
- Smart Caching — Reduces API calls with configurable expiry & deduplication
- Database Integration — MySQL support (oxmysql & mysql-async) for bans, warnings, sessions, reputation & more
- Comprehensive Logging — Joins, deaths, chat, commands, explosions, teleports, noclip, vehicles & more
- Discord DM Notifications — Players receive ban/warn/appeal notifications via Discord
- Webhook Rate Limiting — Built-in queue with backoff to prevent Discord 429 errors
- Auto-Moderation — Chat filtering, spam & caps detection with mute/warn/kick actions
- Modular Config — Per-module config files with validation & secret masking
- Module Guards — Disabled modules have zero performance overhead
- Admin Dashboard — NUI-based admin panel for server management
Support
Need help with setup or configuration?
Join our Discord: https://discord.gg/UpJKHT3hUN
Built by Nightz Development
Version: 0.3.3 | Last Updated: March 16, 2026
Edited by Nightz Development
What's New in Version 0.3.3
Released
ND_DiscordUnified 0.3.3
Release Date: March 16, 2026
Bug Fixes
Config.AdminRoles Never Loaded (Critical)
- config/modules/adminroles.lua existed and was listed in files {}, but was never loaded by the config auto-loader because there was no matching Config.Modules toggle
- 7 modules relied on Config.AdminRoles for admin permission fallback checks RestartScheduler, Events, Notifications, VoiceSync, WeaponPerms, Appeals, Announcements) — all silently fell through to {}, meaning Discord role-based admin checks never passed
- AdminRoles is now explicitly loaded as a core config in config_utils.lua alongside Permissions
Discord API — GetPlayerRoles Race Condition
- GetPlayerRoles export used a hardcoded Wait(100) after firing an async fetchDiscordRoles call — if the Discord API took longer than 100ms (common), callers received an empty roles table
- GetMultipleDiscordRoles had the same issue with Wait(200)
- Both exports now use proper sync-wait with a 5-second timeout, matching the existing playerHasRole pattern
SQL Schema — Missing player_name Column
- sql/sql.sql was missing the player_name column on nd_player_stats that SessionTracker references at runtime
- This was noted as fixed in v0.3.1 patch notes but the shipped SQL file was never updated
- Column now included in the shipped schema
Config README — Wrong Filename References
- config/README.md referenced config/master.lua in 10 places — this file does not exist
- All references corrected to config/main_config.lua
# Improvements
Shared Admin Permission Helper
- Extracted duplicated hasAdminPermission function (identical 15-line pattern copy-pasted across 7 modules) into a single shared ND.HasAdminPermission(src, acePermission, modulePermissionRoles) helper in shared/utils.lua
- Server-side only (guarded by IsDuplicityVersion())
- Checks ACE permission → optional module-specific PermissionRoles → global Config.AdminRoles fallback
- Updated modules: announcements, restart_scheduler, events, notifications, appeals, voicesync, weapon_perms
Pasted content
ND_DiscordUnified Beta 0.3.2
Release Date: March 7, 2026
New Modules
# Player Portal
- Full in-game NUI portal accessible via **F7** keybind (`/portal` command)
- Statistics Tab — playtime, sessions, kills, deaths, K/D ratio, Discord activity, voice time, reputation
- Warnings Tab — view active warnings with built-in appeal system
- Achievements Tab — configurable achievement tracking (playtime, kills, K/D milestones) with Discord role rewards
- Staff Panel — admin-only tab for moderation actions (warn, kick, ban) with permission tiers
- Settings Tab — per-player notification, privacy, and display preferences saved to database
- Help Tab — configurable FAQ, server rules list, and support ticket creation
- Performance Tab — real-time FPS, ping, and packet loss monitoring with optimization tips
- Auto-framework detection (QBCore, ESX, ox, standalone) for economy/job stats
- Discord avatar caching, rate limiting, and security permissions built in
- 8 new SQL tables (`nd_player_settings`, `nd_player_achievements`, `nd_warnings`, `nd_support_tickets`, `nd_performance_cache`, `nd_kicks`, `nd_player_statistics`, `nd_discord_cache`)
Player Profiles
- `/profile [id]` — view any player's profile card (NUI overlay)
- `/myprofile` — view your own profile
- Aggregates data from TrustScore, SessionTracker, Reputation, and Moderation modules
- Ped headshot capture rendered in profile card
- Live stats updating for admins viewing online players
- Reputation voting directly from the profile card (upvote/downvote)
- Privacy controls — admin-only fields for warnings, identifiers, and Discord ID
- Configurable ACE permissions for viewing others and admin-only data
Auto-Moderation
- Chat Filter — blocked words/phrases with Lua pattern matching (IP addresses, Discord invite links)
- Spam Detection — configurable message rate limit per time window, auto-mute on trigger
- Caps Detection — excessive caps warning with min length and percentage thresholds
- Configurable actions per feature: `warn`, `mute`, `kick`, or `log`
- Whitelist system for false-positive prevention (e.g. "grass", "class", "assassin")
- Discord role and ACE bypass support
- All actions logged to Discord webhook
- New server exports: `IsPlayerMuted`, `MutePlayer`, `UnmutePlayer`
Link Verification
- Require Discord account linking before players can join
- Configurable kick message with Discord invite link and instructions
- Grace period option (delay before kicking unlinked players)
- Bypass via specific identifiers or ACE permission (`nd.linkverification.bypass`)
- Unlinked connection attempts logged to Discord
- Non-conflicting with whitelist module (avoids duplicate deferrals)
Discord Rich Presence
- Custom Discord Rich Presence for all connected players
- Configurable Discord Application ID, large/small image assets with hover text
- Dynamic status line with server name and live player count
- Up to 2 profile buttons (e.g. "Join Discord", "Website")
- Configurable update interval (default 30s)
![[Non-ELS/DLSv2] CHP BMW R1200RT-P [Addon/FiveM]](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/resize/500/-/monthly_2026_04/1.Thumbnail.thumb.png.27cfb560319fde49d84f8b97a7587c1d.png)
![Ambulance Protection Civile Algérienne [ELS]](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/resize/500/-/monthly_2026_04/Screenshot(150).thumb.png.8aceb0d0a35ebc9abb6c32ce785a5e27.png)
![Camion de la Protection Civile Algérienne [ELS]](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/resize/500/-/monthly_2026_04/Screenshot(157).thumb.png.472fd871730c95e9b4cfbb9e927b26e5.png)
![FHP Style Belts [FIVEM Ready]](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/resize/500/-/monthly_2026_04/Screenshot2026-04-24114558.thumb.png.0e174437327be7c07aba2e9e0676a6aa.png)
![Los Santos Police Department Package [EUP][FiveM Ready][Addon]](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/resize/500/-/monthly_2026_04/Screenshot(335).thumb.png.5a33d323a9f17c6db2e357f4eaa74482.png)
![[Non-ELS] [DLS] Pomona Police Dept. Pack](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/monthly_2026_04/GrandTheftAutoV4_1_20268_56_27PM.thumb.png.6d5aa40219aa8dbd1bab207d7af3260f.png)
![[DLS/Add-on] 2018 Dodge Charger PPV - Chumash Police Dept.](http://s3-screenshots.int-cdn.lcpdfrusercontent.com/monthly_2026_04/1.thumb.png.63c922010e6594423917655ad39d5cd5.png)
Recommended Comments
Create an account or sign in to comment