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	0	0
2	1,000	1
3	2,000	2
5	4,000	4
10	9,000	9

Prestige System

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

Prestige Levels:

Prestige	Name	Permanent Bonus
1	Bronze Star	1.10x
2	Silver Star	1.20x
3	Gold Star	1.30x
4	Platinum Star	1.40x
5	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
}