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.4.0
Released
Pasted content
Major Features
Staff Voice Broadcaster (`/announce_voice`)
- Premium neural voice announcements with configurable Google Cloud TTS API integration
- Admin permission: `announcement.send`
- Usage: `/announce_voice Server maintenance in 10 minutes. Save progress and park vehicles.`
AutoMod Auditory Warnings
- Private TTS warning plays locally to player when triggering chat filters or toxic behavior limits
- System Warning message with mute duration shown on trigger
- 520Hz alert tone (square wave oscillator) precedes warning voice
- Lower volume/pitch for non-intrusive notification
- Works seamlessly with existing AutoMod module
Staff Activity Weekly Tracking
- `weekly_commands`, `weekly_mod_actions`, `weekly_duty_time` columns auto-reset each week
- `week_start` timestamp and `updated_at` for tracking
- Weekly stats included in staff leaderboard (limit 15 staff)
- Milestone badges for duty hours, mod actions, commands reached
- No cron jobs needed — IF() SQL conditionals auto-reset on week boundary
Collateral Alt Account Ban Detection
- Queries `nd_bans` table for linked alt accounts when alt detected
- Drops player immediately if any linked alt has active permanent or unexpired temp ban
- Sends COLLATERAL BAN alert to staff webhook with details
- Prevents ban evasion via alt accounts
Bug Fixes
ND_Framework `/report` Command Conflict
- Added `chatMessage` event handler with priority (fires before RegisterCommand)
- Intercepts `/report` before ND_Framework can override it
- Uses `CancelEvent()` to prevent command duplication
- Full command parsing and permission check in ND_DiscordUnified handler
DevMode Self-Report Option
- Self-reporting now allowed when `Config.DevMode = true` for testing
- Gated with: `if targetId == src and not Config.DevMode`
- Disabled in production (DevMode = false)
Report Player Enhancements
- Minimum description length enforced (Config.ReportPlayer.Enhanced.MinDescriptionLength)
- PingRoles validation filters invalid IDs with regex: `roleId:match("^%d+$")`
- Removed dead webhook variable code
- Improved error handling for Discord role pings
UI / NUI Improvements
Voice Broadcast Widget Styling
- Matches existing ND_DiscordUnified design language
- Background: `rgba(6, 11, 25, 0.93)` aligned with welcome card
- Border color: `rgba(90, 141, 238, 0.3)` using `--welcome-accent` (#5A8DEE)
- Border radius: `12px` matching restart countdown widget
- Icon: translucent gradient bg with colored border, glowing text
- EQ bars: animated pulse with staggered timing
- No black border in FiveM NUI (transparent html/body + `pointer-events: none`)
- Fixed top positioning (20px) with smooth slide-in/out animations
Teleprompter Word Highlighting
- Default: dim white `rgba(255, 255, 255, 0.35)`
- Spoken: bright white with subtle blue glow
- Active (currently speaking): bright blue `#5A8DEE` with stronger glow + bold weight
- Progress bar: gradient `#5A8DEE` → `#7BA8F5`
- Smooth 250ms cubic-bezier transitions
Announcement Text Display
- Server-wide TTS speaks full preamble: "Server Announcement from Admin [Name]: [message]"
- Teleprompter shows only the user's message content (no redundant preamble)
- Reduces visual clutter while maintaining professional spoken announcement
- Boundary event word tracking offsets by preamble word count for sync
Module Versions
Core: 0.4.0
AltDetection: 0.3.0
ReportPlayer: 0.3.0
StaffActivity: 0.3.0
Announcements: 0.2.0
AutoMod: 0.2.0
⚠️ MANDATORY SYSTEM DEPENDENCY WARNING
To utilize the Staff Voice Broadcaster (`/announce_voice`) and AutoMod Auditory Warnings modules, you must set up and configure the Google Cloud Text-to-Speech (TTS) API.
> Note: This requires the Google Cloud TTS API, not the standard Google Voice phone service. Without this API configuration, both auditory systems will fail to function.
Official Links
* Setup Console: https://console.cloud.google.com/apis/library/texttospeech.googleapis.com
* Pricing Guide: Google Cloud TTS Pricing
Requirements (What They Need)
1. Google Cloud Account:*An active project with a valid credit card on file for billing activation.
2. Enabled API: The `texttospeech.googleapis.com` service must be enabled in your project dashboard.
3. Credentials: An API Key or a JSON Service Account Key** added to your system's configuration.
Price Range (Monthly)
Google bills based on the number of characters processed each month. For a typical server layout, expect **$0.00 to $5.00 / month**.
Recommended Comments
Create an account or sign in to comment