Events Reference

This guide covers all events you can listen to or trigger.

---

Server Events

cas:server:onHuntingAnimalKilled

Triggered when a player kills an animal during an active hunt.

RegisterNetEvent("cas:server:onHuntingAnimalKilled", function()
    local src = source
    -- Player killed a mission animal
end)

Use Cases:

• Track kill statistics

• Add custom rewards

• Trigger achievements

---

cas:server:deliverHuntingLoot

Triggered when a player delivers hunting loot.

RegisterNetEvent("cas:server:deliverHuntingLoot", function(deliveredList)
    local src = source
    -- deliveredList = array of delivered items
    -- Each item: { species = hash, quality = hash, isPerfect = bool }
end)

Example:

AddEventHandler("cas:server:deliverHuntingLoot", function(deliveredList)
    local src = source
    print(string.format("Player %d delivered %d items", src, #deliveredList))
end)

---

cas:server:onHuntingPlayerDied

Triggered when a player dies during an active hunt.

RegisterNetEvent("cas:server:onHuntingPlayerDied", function()
    local src = source
    -- Player died, contract may be cancelled
end)

---

cas:server:onHuntingAbandoned

Triggered when a player abandons their hunting contract.

RegisterNetEvent("cas:server:onHuntingAbandoned", function()
    local src = source
    -- Player manually cancelled their contract
end)

---

cas:server:analyzeTracks

Triggered when a player analyzes animal tracks.

RegisterNetEvent("cas:server:analyzeTracks", function(data)
    local src = source
    --[[
    data = {
        found = boolean,
        model = number (animal hash),
        distance = number,
        direction = string ("North", "South", etc.),
        health = number,
        maxHealth = number
    }
    ]]
end)

---

cas:server:onTrackFound

Triggered when a player discovers a track.

RegisterNetEvent("cas:server:onTrackFound", function(trackType, qualityScore)
    local src = source
    -- trackType = "FOOTPRINT", etc.
    -- qualityScore = 1 (poor), 2 (good), or 3 (perfect)
end)

---

cas:server:setLanguage

Triggered when a player changes their language preference.

RegisterNetEvent("cas:server:setLanguage", function(language)
    local src = source
    -- language = "en", "tr", "fr", "de", etc.
end)

---

cas:server:giveHuntingMap

Triggered when a player accepts a hunting contract.

RegisterNetEvent("cas:server:giveHuntingMap", function(data)
    local src = source
    -- data.tier = "simple", "advanced", "epic", "legendary"
    -- data.id = specific contract ID (optional)
end)

---

Client Events

cas:client:huntingMissionEnded

Triggered when a hunting mission ends (success or cancel).

RegisterNetEvent("cas:client:huntingMissionEnded", function()
    -- Mission ended, cleanup
end)

---

cas:client:spawnAnimalsOnRadius

Triggered to spawn mission animals.

RegisterNetEvent("cas:client:spawnAnimalsOnRadius", function(mission)
    --[[
    mission = {
        radiusCoords = { x, y, z },
        radius = number,
        animals = { ... }
    }
    ]]
end)

---

cas:client:updateclientxp

Triggered when hunting XP is updated.

RegisterNetEvent("cas:client:updateclientxp", function(xp)
    -- xp = current total hunting XP
end)

---

cas:client:updateTraceXp

Triggered when trace/tracking XP is updated.

RegisterNetEvent("cas:client:updateTraceXp", function(xp, level)
    -- xp = current trace XP
    -- level = current trace level (0-5)
end)

---

cas:client:setLanguage

Triggered when language is changed.

RegisterNetEvent("cas:client:setLanguage", function(language, selected)
    -- language = language code
    -- selected = player explicitly chose this language
end)

---

cas:client:trackingPulse

Trigger to start hunter vision for a duration.

-- Trigger hunter vision for 5 seconds
TriggerEvent("cas:client:trackingPulse", 5000)

---

cas:client:showHuntingMap

Triggered to display the hunting map UI.

RegisterNetEvent("cas:client:showHuntingMap", function(metadata)
    --[[
    metadata = {
        missionCoords = { x, y, z },
        missionRadius = number
    }
    ]]
end)

---

cas:client:finishHunting

Triggered when hunting is fully completed.

RegisterNetEvent("cas:client:finishHunting", function()
    -- Contract completed and rewards given
end)

---

Bait System Events

cas-hunting:client:beginBaitShop

Open the bait shop UI.

TriggerEvent("cas-hunting:client:beginBaitShop", npcPed)

---

cas-hunting:client:openBaitShop

Triggered when bait shop data is ready.

RegisterNetEvent("cas-hunting:client:openBaitShop", function(shopData)
    --[[
    shopData = {
        categories = { ... },
        items = { ... },
        playerBaits = { ... },
        money = number
    }
    ]]
end)

---

cas-hunting:client:baitPlaced

Triggered when bait is successfully placed.

RegisterNetEvent("cas-hunting:client:baitPlaced", function(baitCoords)
    -- baitCoords = { x, y, z }
end)

---

cas-hunting:client:attractAnimal

Triggered to attract nearby animals to bait.

RegisterNetEvent("cas-hunting:client:attractAnimal", function(baitCoords)
    -- Nearest animal will approach baitCoords
end)

---

cas-hunting:client:useBaitItem

Triggered when using a bait item.

RegisterNetEvent("cas-hunting:client:useBaitItem", function(itemName)
    -- itemName = "bait_corn", etc.
end)

---

Integration Examples

Custom Achievement System

-- Server-side
local playerKills = {}

AddEventHandler("cas:server:onHuntingAnimalKilled", function()
    local src = source
    playerKills[src] = (playerKills[src] or 0) + 1

    if playerKills[src] == 100 then
        TriggerClientEvent("achievements:unlock", src, "master_hunter")
    end
end)

Logging System

-- Server-side
AddEventHandler("cas:server:deliverHuntingLoot", function(deliveredList)
    local src = source
    local playerName = GetPlayerName(src)

    for _, item in ipairs(deliveredList) do
        print(string.format("[HUNTING LOG] %s delivered species %d (Perfect: %s)",
            playerName, item.species, tostring(item.isPerfect)))
    end
end)

Custom Death Handling

-- Server-side
AddEventHandler("cas:server:onHuntingPlayerDied", function()
    local src = source

    -- Custom punishment
    exports["myMoney"]:removeMoney(src, 50)

    -- Notify
    TriggerClientEvent("notify", src, "You lost $50 for dying during the hunt!")
end)

Track Discovery Rewards

-- Server-side
AddEventHandler("cas:server:onTrackFound", function(trackType, qualityScore)
    local src = source

    if qualityScore == 3 then -- Perfect track
        TriggerClientEvent("notify", src, "Perfect track found! +5 bonus XP")
        exports["cas-hunting"]:addTraceXp(src, 5)
    end
end)

---

NUI Callbacks

These are internal NUI callbacks:

Callback	Description
loadConfig	Load initial config data
closeHuntingMenu	Close the hunting menu
startHunting	Start a hunting contract
setLanguage	Change language preference
closeHuntingMap	Close the map UI
closeBaitShop	Close bait shop
purchaseBait	Purchase bait item

---