FAQ

Common questions and answers about hsJobQuest V2.

---

General Questions

What frameworks are supported?

hsJobQuest V2 supports:

• QBCore (Primary)

• QBOX

• ESX

Set your framework in shared/config.lua:

Config.Framework = 'QBCORE'  -- or 'QBOX', 'ESX'

What are the dependencies?

Required:

• ox_lib

• oxmysql

Optional (auto-detected):

• Phone systems (yseries, qs-smartphone, etc.)

• Fuel systems (LegacyFuel, cdn-fuel, etc.)

• Target systems (qb-target, ox_target)

How do I access the job hub?

The default job hub is located at:

• Coordinates: 154.17, -3075.09, 5.9

• Blip: Truck icon on the map

You can customize this in Config.JobStartLocation.

---

Progression Questions

How do I rank up?

Earn XP by completing deliveries. Default settings:

• XP per rank: 1,000

• Max rank: 10

Rank	XP Required
2	1,000
5	4,000
10	9,000

What is Prestige?

Prestige is an optional reset system:

Reach max rankReach max rank (10).Reset rankReset rank to 1.Gain permanent bonusGain permanent payout bonus.Receive skill pointsReceive bonus skill points.

Prestige	Bonus
1	1.10x
2	1.20x
3	1.30x
4	1.40x
5	1.50x

How do I get skill points?

• 1 point per rank-up

• 5 points per prestige level

Maximum possible: 34 points (Rank 10, Prestige 5)

---

Money Questions

Where does my money go?

Mission earnings go to your ATM balance, not directly to your wallet.

How do I withdraw money?

Go to delivery ATMGo to the delivery ATM.Interact with the NPCInteract with the NPC.Select withdrawSelect "Withdraw".Enter amountEnter amount.

Is there a withdrawal fee?

Depends on server configuration:

Config.ATMWithdrawalFee = 5  -- 5% fee (set to 0 for no fee)

---

Mission Questions

Why can't I start a mission?

Possible reasons:

• You already have an active mission

• Your rank is too low for that job

• Cooldown from recent illegal run

How do I cancel a mission?

Use the job hub menu and select "Cancel Mission".

Cancelling loses all progress and rewards.

What are bonus objectives?

Random challenges that appear during missions:

• Complete without vehicle damage

• Finish under time limit

• Stay undetected

Completing them gives 25% bonus rewards.

---

Illegal Runs Questions

How do I unlock illegal runs?

Requirements:

• Minimum Rank 5

• Find the Black Market Hub

Where is the Black Market Hub?

• Location: Vespucci area

• Coordinates: 1383.99, -2079.58, 52.0

• Blip: Skull icon (hidden until nearby)

What is Heat?

Heat tracks police attention:

• Gained from illegal runs

• Higher heat = higher police chance

• Decays 1 point per minute

How do I reduce Heat?

• Wait for natural decay (1/min)

• Build criminal faction rep (provides reduction)

• Do legal jobs while heat cools down

---

Technical Questions

The script won't start, what do I check?

Dependencies loaded firstensure ox_libensure oxmysqlensure hsJobQuestV2Database importedRun install.sqlCheck for errorsEnable debug modeConfig.EnableDebug = true

Players can't see the job NPC

• Check Config.JobStartLocation coordinates

• Verify the NPC model is valid

• Check for other scripts conflicting

Achievements aren't unlocking

• Verify Config.EnableAchievements = true

• Check database for hsjobquest_achievements table

• Enable debug mode to see achievement checks

---

Customization Questions

Can I add custom jobs?

Yes! Add to Config.Jobs in shared/config.lua:

Config.Jobs.my_custom_job = {
    name = "Custom Job",
    xp = 100,
    basePayment = 75,
    vehicle = "boxville",
    -- ... more config
}

See Job Configuration for full details.

Can I change the ATM location?

Yes, edit Config.ATMLocation:

Config.ATMLocation = vec4(x, y, z, heading)

Can I disable features?

Most features have toggles:

Config.EnablePrestige = false      -- Disable prestige
Config.EnableAchievements = false  -- Disable achievements
Config.EnableRandomEvents = false  -- Disable events
Config.EnableDistanceBonus = false -- Disable distance bonus
Config.EnableBuiltInATM = false    -- Disable ATM

---

Performance Questions

Does this script affect performance?

hsJobQuest V2 is optimized:

• Server-side calculations

• Minimal client-side loops

• Database caching

• Efficient queries

How many players can use it?

Designed for servers of any size. Database operations are async and cached.

---

Support

Where do I get help?

• Discord: HyperScripts Discord

• Documentation: This GitBook

• Debug Mode: Enable for troubleshooting

How do I report bugs?

Enable debug modeEnable debug mode.Reproduce the issueReproduce the issue.Collect console errorsCollect console errors.Report on TicketChannel on Discord with details.