Integrations — Hunter Job | Quasar Store | Quasar Store

Integrations — Hunter Job | Quasar Store | Quasar Store

How Integrations Work#

Hunter Job looks at what is running when it starts and adapts. The framework and the inventory are detected in config/config.lua; everything framework-specific — money, items, the job, the blip, the progress bar — lives in the small bridge files under client/framework/ and server/framework/, which are left open for you to edit.

Layer	Supported	Without it
Framework	`es_extended · qb-core · qbx_core`	Required — no employer, no blip, no money.

lua

-- config/config.lua
Config.DefaultNotifications = false

function SendTextMessage(msg, type)   -- type: 'info' · 'error' · 'success'
    if type == 'info' then
        exports['okokNotify']:Alert('Hunter', msg, 5000, 'info')
    end
    if type == 'error' then
        exports['okokNotify']:Alert('Hunter', msg, 5000, 'error')
    end
    if type == 'success' then
        exports['okokNotify']:Alert('Hunter', msg, 5000, 'success')
    end
end

Gear	qs-inventory · QBCore	ox_inventory
Rifle · knife · hatchet	`weapon_sniperrifle · weapon_knife · weapon_battleaxe`	The same names — ox matches them in any case.
Sniper ammo	`snp_ammo` (shipped)	`ammo-sniper` — change the Ammo entry of `Config.BuyItems`

lua

-- config/config.lua
Config.Webhooks = {
    Enabled   = true,
    Url       = 'https://discord.com/api/webhooks/...',   -- the shared channel

    Name      = 'qs-hunter',   -- how the bot presents itself
    Avatar    = '',            -- an image URL, or '' for none
    Timestamp = true,

    Events = {
        MissionStarted   = true,
        MissionFinished  = true,
        MissionAbandoned = true,
        MoneyPaid        = 'https://discord.com/api/webhooks/...staff',   -- its own channel
        ExperienceGiven  = false,
    },
}

Event	Sent when	Shows
`MissionStarted` · blue	A leader takes a hunt.	What it asks for, the crew, the pay and the experience.
`MissionFinished` · green	The last animal is in and the crew is paid.	The crew, and the pay and experience — per member and pot on a split.
`MissionAbandoned` · red	A hunter leaves from the panel, is kicked or disconnects.	The reason and how many are left in the crew.
`MoneyPaid` · gold	A mission payout reaches a player.	The amount and the mission.
`ExperienceGiven` · purple	Any experience is granted — harvests and missions.	The gain, the level before and after, progress to the next level and the lifetime total.

lua

-- Auto, the default
Config.Framework = dependencyCheck(frameworks) or 'standalone'
Config.Inventory = dependencyCheck(inventories) or 'default'

-- Pinned
Config.Framework = 'qb'             -- 'esx' or 'qb' (Qbox counts as 'qb')
Config.Inventory = 'ox_inventory'   -- the inventory's resource name

lua

function AddMoney(source, price)
    local xPlayer = GetPlayerId(source)
    if not xPlayer then return end
    xPlayer.addAccountMoney('bank', price)      -- was 'money'
end

function RemoveMoney(price, src)
    local xPlayer = GetPlayerId(src)
    if not xPlayer then return end
    xPlayer.removeAccountMoney('bank', price)   -- was 'money'
end

function GetMoney(source)
    local xPlayer = GetPlayerId(source)
    if not xPlayer then return 0 end
    return xPlayer.getAccount('bank').money     -- was xPlayer.getMoney()
end

lua

function AddMoney(source, price)
    local xPlayer = GetPlayerId(source)
    if not xPlayer then return end
    xPlayer.Functions.AddMoney('bank', price)      -- was 'cash'
end

function RemoveMoney(price, src)
    local xPlayer = GetPlayerId(src)
    if not xPlayer then return end
    xPlayer.Functions.RemoveMoney('bank', price)   -- was 'cash'
end

function GetMoney(source)
    local xPlayer = GetPlayerId(source)
    if not xPlayer then return 0 end
    return xPlayer.PlayerData.money['bank'] or 0   -- was 'cash'
end

File	Must provide
`server/framework/<name>.lua`	`GetPlayeridentifier · GetPlayerId · GetPlayerJobName · GetItemCountFromInventory · ItemExists · AddInventoryItem · RemoveInventoryItem · AddMoney · RemoveMoney · GetMoney · GetPlayers · GetPlayerFromIdentifier · GetUserName`, and a call to `LoadPlayer` when a character loads.
`client/framework/<name>.lua`	Sets `CanInteract` from the job, calls `CreateAllPeds()` and `CheckProximity()` once loaded, calls `AbandonMission()` when the job is lost, and defines `createBlip` and `ProgressBar`.

Keys	What they are
`CURRENCY_TYPE`	The currency symbol shown with every price.
`RAT · RABBIT · BOAR · COYOTE · DEER · COW · MTLION`	Animal names on blips, mission cards and the tracker. A new animal needs its own key.
`GUIDE_INTRO · GUIDE_STEP_1–6 · GUIDE_TIP_1–4`	The Guide view. Delete a step's key and the step disappears.
`HINT_* · TEXT_3D_*`	The corner hints and 3D prompts. `~INPUT_PICKUP~` draws the key icon; `~g~` and `~w~` switch colour.
`NOTIFY_* · NOT_* · PLAYER_*`	Every refusal and confirmation — listed with their meaning in Common Errors.