Overview
ND_VehicleWhitelist is a comprehensive Discord role-based vehicle permission system for FiveM servers. This script allows server administrators to restrict vehicle usage based on Discord roles, ensuring that only authorized players can use specific vehicles.
Key Features
- Role-Based Vehicle Permissions
- Restrict vehicles to specific Discord roles (police, EMS, tow, admin, etc.)
- Automatic ejection of unauthorized players from restricted vehicles
- Support for Discord role mapping to simplify configuration
- Admin override for full access to all vehicles
Vehicle Handling Options
- Configurable immediate vehicle deletion for unauthorized access
- Delayed vehicle deletion with customizable timer (default: 25 seconds)
- Smart cancellation of deletion timers when authorized players enter vehicles
- Visual effects when vehicles are deleted (smoke grenade effect)
Player Experience Improvements
- Players are moved to the driver's side when ejected from vehicles
- Clear notifications when players are ejected from unauthorized vehicles
- Warning notifications for delayed vehicle deletion
- Success notifications when deletion timers are cancelled
Discord Webhook Integration
- Comprehensive webhook logging for all vehicle permission events
- Detailed player information including identifiers (steam, license, discord)
- User-friendly vehicle names in webhook messages
- Configurable webhook events (ejections, deletions, timer cancellations, admin overrides)
- Test command to verify webhook functionality
Performance Optimizations
- Configurable check intervals for player and world vehicles
- Debug message throttling to reduce console spam
- Vehicle distance checking to ignore distant vehicles
- Role check caching to reduce API calls
Configuration Options
- Separate configuration files for core settings, vehicle lists, and performance options
- Customizable notification messages and types
- Adjustable deletion delay times
- Toggle options for immediate or delayed deletion
- Debug mode for troubleshooting
Commands
- /checkvehicle [model] - Check if you can use a specific vehicle
- /myvehicles - List all vehicles you have access to
- /refreshvehicles - Force update your vehicle permissions
Future Plans
- UI for in-game vehicle management
- Support for temporary vehicle permissions
- Vehicle class-based permissions
- Enhanced logging and analytics
- Expanded vehicle lookup database
ND_VehicleWhitelist is a comprehensive Discord role-based vehicle permission system for FiveM servers. This script allows server administrators to restrict vehicle usage based on Discord roles, ensuring that only authorized players can use specific vehicles.
Key Features
- Role-Based Vehicle Permissions
- Restrict vehicles to specific Discord roles (police, EMS, tow, admin, etc.)
- Automatic ejection of unauthorized players from restricted vehicles
- Support for Discord role mapping to simplify configuration
- Admin override for full access to all vehicles
Vehicle Handling Options
- Configurable immediate vehicle deletion for unauthorized access
- Delayed vehicle deletion with customizable timer (default: 25 seconds)
- Smart cancellation of deletion timers when authorized players enter vehicles
- Visual effects when vehicles are deleted (smoke grenade effect)
Player Experience Improvements
- Players are moved to the driver's side when ejected from vehicles
- Clear notifications when players are ejected from unauthorized vehicles
- Warning notifications for delayed vehicle deletion
- Success notifications when deletion timers are cancelled
Discord Webhook Integration
- Comprehensive webhook logging for all vehicle permission events
- Detailed player information including identifiers (steam, license, discord)
- User-friendly vehicle names in webhook messages
- Configurable webhook events (ejections, deletions, timer cancellations, admin overrides)
- Test command to verify webhook functionality
Performance Optimizations
- Configurable check intervals for player and world vehicles
- Debug message throttling to reduce console spam
- Vehicle distance checking to ignore distant vehicles
- Role check caching to reduce API calls
Configuration Options
- Separate configuration files for core settings, vehicle lists, and performance options
- Customizable notification messages and types
- Adjustable deletion delay times
- Toggle options for immediate or delayed deletion
- Debug mode for troubleshooting
Commands
- /checkvehicle [model] - Check if you can use a specific vehicle
- /myvehicles - List all vehicles you have access to
- /refreshvehicles - Force update your vehicle permissions
Future Plans
- UI for in-game vehicle management
- Support for temporary vehicle permissions
- Vehicle class-based permissions
- Enhanced logging and analytics
- Expanded vehicle lookup database
