General Configuration

Core configuration options for hsJobQuest V2.

Framework Settings

Config.Framework

Specifies which framework your server uses.

Config.Framework = 'QBCORE'

Value

Framework

'QBCORE'

QBCore Framework

'QBOX'

QBOX Framework

'ESX'

ESX Framework

Config.TargetSystem

Your server's targeting system for interactions.

Config.TargetSystem = 'qb-target'

Value

System

'qb-target'

QB-Target

'ox_target'

Ox Target

Config.InventorySystem

Inventory system for item management.

Config.InventorySystem = 'qb-inventory'

Value

System

'qb-inventory'

QBCore Inventory

'ox_inventory'

Ox Inventory

'qs-inventory'

Quasar Inventory

'ps-inventory'

Project Sloth Inventory

Config.NotifySystem

Notification system for alerts.

Config.NotifySystem = 'ox_lib'

Value

System

'ox_lib'

Ox Lib Notifications

'qb-core'

QBCore Notifications

'esx'

ESX Notifications

Debug & Development

Config.EnableDebug

Enables verbose console logging for troubleshooting.

Config.EnableDebug = false  -- Set to true for development

When enabled, you'll see messages like:

[hsJobQuest] Player initialized: ABC123
[hsJobQuest] Mission started for ABC123: food_delivery
[hsJobQuest] Distance bonus calculated: 5.23 km, $26 money, 10 XP

Disable debug mode in production to improve performance.

Feature Toggles

Core Features

-- Progression System
Config.EnablePrestige = true        -- Allow prestige after max rank
Config.EnableAchievements = true    -- Achievement system
Config.AchievementRewardsXP = true  -- Award XP for achievements
Config.AchievementRewardsMoney = true -- Award money for achievements

-- Gameplay Features
Config.EnableRandomEvents = true    -- Random events during missions
Config.EventChance = 15             -- % chance for random events
Config.EnableBonusObjectives = true -- Bonus objectives in missions
Config.BonusObjectiveChance = 30    -- % chance for bonus objectives

-- Economy Features
Config.EnableDistanceBonus = true   -- Distance-based rewards
Config.EnableBuiltInATM = true      -- Built-in ATM system

Progression Settings

Ranking System

Config.MaxRank = 10           -- Maximum player rank
Config.RankUpXP = 1000        -- XP required per rank level
Config.SkillPointsPerRank = 1 -- Skill points awarded per rank up

Rank Progression Example:

Rank

Total XP Required

Skill Points

1,000

2,000

4,000

9,000

Prestige System

Config.EnablePrestige = true
Config.MaxPrestige = 5
Config.SkillPointsPerPrestige = 5

Prestige Levels:

Prestige

Name

Permanent Bonus

Bronze Star

1.10x

Silver Star

1.20x

Gold Star

1.30x

Platinum Star

1.40x

Diamond Star

1.50x

Mission Settings

Delivery Configuration

Config.MinDeliveries = 1  -- Minimum stops per mission
Config.MaxDeliveries = 3  -- Maximum stops per mission

Mission Type Chances

Controls how often each mission type spawns:

Config.MissionTypeChances = {
    standard = 50,  -- 50% chance
    timed = 20,     -- 20% chance
    fragile = 15,   -- 15% chance
    urgent = 10,    -- 10% chance
    vip = 5         -- 5% chance
}

Values are relative weights, not percentages. They don't need to sum to 100.

Location Settings

Job Hub

Config.JobStartLocation = vec4(154.17, -3075.09, 5.9, 86.59)

The postal worker NPC spawns here.

Vehicle Spawn

Config.DefaultVehicleSpawn = vec4(140.61, -3084.76, 5.9, 81.27)

Where job vehicles spawn.

ATM Location

Config.ATMLocation = vec4(120.07, -3078.27, 6.02, 98.44)

The built-in ATM NPC location.

Blip Configuration

Job Hub Blip

Config.JobBlip = {
    sprite = 67,      -- Truck icon
    color = 5,        -- Yellow
    scale = 0.8,
    display = 4,      -- Always visible
    name = 'Delivery Jobs'
}

ATM Blip

Config.ATMBlip = {
    sprite = 108,     -- Dollar sign
    color = 2,        -- Green
    scale = 0.7,
    display = 4,
    name = 'Delivery ATM'
}

Phone Integration

Config.PhoneSystem

Auto-detects or specify your phone system:

Config.PhoneSystem = 'auto'

Value

System

'auto'

Auto-detect

'yseries'

YSeries Phone

'qs-smartphone'

Quasar Smartphone

'gks-phone'

GKS Phone

'qb-phone'

QB Phone

'okokPhone'

OKOK Phone

'high_phone'

High Phone

'roadphone'

Road Phone

'none'

Disable phone notifications

Fuel Integration

Config.FuelSystem

Auto-detects or specify your fuel system:

Config.FuelSystem = 'auto'

Value

System

'auto'

Auto-detect

'LegacyFuel'

Legacy Fuel

'cdn-fuel'

CDN Fuel

'ox_fuel'

Ox Fuel

'lc_fuel'

LC Fuel

'none'

Disable fuel tracking

Custom Fuel System

For custom fuel systems:

Config.FuelSystem = 'custom'
Config.CustomFuelSystem = {
    GetFuel = function(vehicle)
        return exports['your_fuel']:GetFuel(vehicle)
    end,
    SetFuel = function(vehicle, amount)
        exports['your_fuel']:SetFuel(vehicle, amount)
    end
}

PreviousConfiguration NextEconomy Configuration