[FREE] JC Whitelist - Application System

JungleCode · November 14, 2025, 11:34am

JC Whitelist

A whitelist application system for FiveM servers with interactive questionnaire, admin review panel, and zone restriction.

Features

Interactive questionnaire with multiple question types
- Multiple choice questions
- Text input questions
- Number input questions
- Multiple select questions (select all that apply)
Points-based evaluation system
- Auto-whitelist mode: Instant approval if point threshold reached
- Review mode: Manual admin review required
- Configurable points per question and pass threshold
Admin review panel
- View all applications (pending, accepted, denied)
- Detailed view of player answers with point breakdown
- Bulk accept/deny actions for multiple applications
- Search and filter functionality
- Statistics dashboard
Zone restriction system
- Non-whitelisted players confined to designated spawn area
- Automatic teleport back if attempting to leave zone
- Warning system when approaching zone boundary
- Configurable spawn position and zone radius
Retry and ban system
- Configurable cooldown periods after application denial
- Maximum attempt limits
- Automatic ban after exceeding max attempts
- Temporary or permanent ban durations
- Admin can manually control retry permissions
Discord webhook integration
- New application notifications with player details
- Accept/deny logs with rich embeds
- Ban notifications with reason and duration
- Configurable webhook URLs per event type
Database flexibility
- MySQL support via oxmysql (persistent storage)
- JSON file-based storage (no database required)
- Automatic table/file creation on startup
Multiple interaction methods
- 3D Marker with customizable appearance
- NPC with scenarios and animations
- ox_target integration
- qb-target integration
- Command-based (/whitelist)
- Keypress activation (configurable key)
Configuration and customization
- 80+ configuration options
- Unlimited custom questions
- All UI text translatable via Config.Messages
- Configurable colors and styling
- All notification messages editable
Performance optimized
- Efficient database queries
- Minimal resource usage
- No unnecessary loops or timers
- Optimized for all server sizes

Installation

Download and extract to your resources folder
Add ensure JC_Whitelist to your server.cfg
Configure config.lua:
- Set database type (MySQL or JSON)
- Configure questions and point values
- Set interaction method
- Customize messages and settings
Start your server - database tables/files are created automatically
Set admin permissions in server.cfg:
add_ace group.admin jc_whitelist.admin allow

Standalone - no framework required. Works on any FiveM server.

Requirements

FiveM Modern server build recommended
oxmysql (required only if using MySQL database mode)
ox_target or qb-target (optional, only needed if using target interaction mode)

No ESX, QBCore, or other framework required.

Configuration

The script includes extensive configuration options:

Database type selection (MySQL/JSON)
Question customization (unlimited questions, each with type, text, options, points)
Interaction method (Marker/NPC/Target/Command/Keypress)
Zone restriction settings (center coordinates, radius, spawn position)
Retry system settings (cooldowns, max attempts, ban durations)
Discord webhook URLs
All UI text and messages
Admin panel permissions
And many more options