🛠️ Installation

Requirements

• FiveM Server (Latest artifacts recommended)

• Framework: Standalone (ESX/QBCore optional)

• Database: MySQL/MariaDB (optional, JSON alternative)

• Dependencies: oxmysql (if using MySQL), ox_target or qb-target (if using target)

Step 1: Download & Extract

1. Download JC Whitelist System

2. Extract to resources folder

3. Rename folder to exactly JC_Whitelist

⚠️ Resource folder MUST be named JC_Whitelist

Step 2: Database Setup

MySQL: Table created automatically. To manually import:

CREATE TABLE IF NOT EXISTS `jc_whitelist` (
  `id` int(11) NOT NULL AUTO_INCREMENT,
  `license` varchar(255) NOT NULL,
  `name` varchar(100) DEFAULT NULL,
  `whitelisted` tinyint(1) DEFAULT 0,
  `status` varchar(50) DEFAULT 'pending',
  `application_data` longtext DEFAULT NULL,
  `score` int(11) DEFAULT 0,
  `attempts` int(11) DEFAULT 0,
  `last_attempt` timestamp NULL DEFAULT NULL,
  `created_at` timestamp DEFAULT current_timestamp(),
  `updated_at` timestamp DEFAULT current_timestamp() ON UPDATE current_timestamp(),
  PRIMARY KEY (`id`),
  UNIQUE KEY `license` (`license`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4;

JSON: Files created automatically in JC_Whitelist folder.

Step 3: Server Configuration

Add to server.cfg:

ensure JC_Whitelist

Step 4: Admin Permissions

Add to server.cfg:

add_ace group.moderator jc_whitelist.moderator allow
add_ace group.admin jc_whitelist.admin allow
add_principal identifier.license:YOUR_LICENSE group.admin

Step 5: Basic Configuration

Open config.lua:

Config.Database.Type = 'json'
Config.System.InteractionMethod = 'command'
Config.System.SuccessMode = 'auto'
Config.MinimumPoints = 35

Step 6: Test

restart JC_Whitelist

• Player: /whitelist

• Admin: /reviewwhitelist