⚙️ Configuration

Database Setup

Config.Database = {
    Type = 'json',  -- 'mysql' or 'json'
    TableName = 'jc_whitelist'
}

• MySQL: Requires oxmysql

• JSON: No dependencies

Core System

Config.System = {
    AutoStartOnJoin = false,
    PlayerCommand = 'whitelist',
    ModeratorPermission = 'jc_whitelist.moderator',
    AdminPermission = 'jc_whitelist.admin',
    SuccessMode = 'auto',  -- 'auto' or 'review'
}

Config.MinimumPoints = 35

• auto - Instant whitelist if points reached

• review - Admin must manually accept/deny

Attempt System

Config.System = {
    MaxAttempts = 3,
    AttemptCooldown = 30,  -- Minutes
    
    BanSystem = {
        Enabled = true,
        Type = 'temporary',
        Duration = 7 * 24 * 60,  -- 7 days in minutes
    }
}

Interaction Methods

Config.System.InteractionMethod = 'command'
-- Options: 'command', 'npc', 'marker', 'target', 'keypress'

Location Setup

Config.System.InteractionLocation = {
    Enabled = true,
    Coords = vector3(218.96, -864.26, 30.49),
    Heading = 180.0,
    Distance = 2.5,
    ShowBlip = true,
}

NPC

Config.System.NPC = {
    Model = 'a_m_m_business_01',
    Scenario = 'WORLD_HUMAN_CLIPBOARD',
}

Marker

Config.System.Marker = {
    Type = 1,
    Size = vector3(1.5, 1.5, 1.0),
    Color = {r = 0, g = 217, b = 255, a = 150},
}

Target

Config.System.Target = {
    Label = '📋 Start Whitelist',
    Icon = 'fas fa-clipboard-list',
    Resource = 'ox_target',
}

Questionnaire

Config.Questionnaire = {
    RandomOrder = false,
    TimeLimit = 10,  -- Minutes (false = unlimited)
}

Question Types

Multiple Choice (Single):

{
    enabled = true,
    type = 'multiplechoice',
    question = 'What does RDM mean?',
    multipleAnswers = false,
    options = {
        {id = 1, text = 'Random Death Match'},
        {id = 2, text = 'Role Death Match'}
    },
    correctAnswer = 1,
    points = 10
}

Multiple Choice (Multiple):

{
    type = 'multiplechoice',
    question = 'Select all important rules',
    multipleAnswers = true,
    options = {
        {id = 1, text = 'No Meta-Gaming'},
        {id = 2, text = 'No Power-Gaming'}
    },
    correctAnswer = {1, 2},
    points = 15
}

Text Input:

{
    type = 'text',
    question = 'Describe roleplay',
    minLength = 10,
    maxLength = 200,
    correctAnswers = {},  -- Empty = admin reviews
    points = 20
}

Number Input:

{
    type = 'number',
    question = 'How many warnings until ban?',
    minValue = 1,
    maxValue = 10,
    correctAnswer = 3,
    points = 10
}

Zone System

Config.WhitelistZone = {
    Enabled = true,
    Debug = false,
    
    SpawnPosition = {
        x = 218.96,
        y = -864.26,
        z = 30.49,
        heading = 160.0
    },
    
    Center = {x = 218.96, y = -864.26, z = 30.49},
    Radius = 50.0,
    WarningDistance = 10.0,
}

• Non-whitelisted players spawn at SpawnPosition

• Can only move within Radius

• Auto-teleport if leaving zone

Security & Anti-Abuse

Rate Limiting

Config.System.RateLimit = {
    Enabled = true,
    MaxApplicationsPerDay = 3,
}

Duplicate Detection

Config.System.DuplicateCheck = {
    Enabled = true,
    SimilarityThreshold = 0.8,
    Action = 'flag'  -- 'flag' or 'deny'
}

Admin Commands

Config.Commands = {
    AddWhitelist = 'addwhitelist',
    RemoveWhitelist = 'removewhitelist',
    ReviewWhitelist = 'reviewwhitelist',
    AcceptWhitelist = 'acceptwhitelist',
    DenyWhitelist = 'denywhitelist',
    ForceWhitelist = 'forcewhitelist',
    BulkAccept = 'bulkaccept',
    BulkDeny = 'bulkdeny',
    ClearLogs = 'clearlogs'
}

UI Customization

Config.UI = {
    Title = '🎯 Whitelist Questionnaire',
    WelcomeMessage = 'Welcome!',
    ButtonStart = 'Start Now',
    ButtonNext = 'Next',
    ButtonSubmit = 'Submit',
}

Discord Integration

Config.System.DiscordWebhooks = {
    Applications = '',
    AdminActions = '',
    Bans = '',
    System = ''
}

Setup:

1. Create webhook in Discord

2. Copy URL

3. Paste into config

4. Restart resource