Listeners

Client Events

Skill Unlock Event

Triggered when a player unlocks a new skill and after player is loaded first time to server. This should be used if you have skill which apply effect one time, its good for optimalization.

Lua

local moreHp = 0
RegisterNetEvent('devhub_skillTree:client:listener:skillUnlocked', function(categoryUid, skillUid, firstUnlock)
    local ped = PlayerPedId()
    local maxHp = GetEntityMaxHealth(ped)
    if categoryUid == 'personal' and skillUid == 'moreHp' then
        moreHp = moreHp + 50
    end
    SetPedMaxHealth(ped, maxHp + moreHp)
    if firstUnlock then
        print("USER UNLOCKED NEW SKILL")
    end
end)

Parameters:

categoryUid (string): Category name (e.g., 'personal')
skillUid (string): Unique identifier of the unlocked skill
firstUnlock (boolean) It will only be true on skill unlock and when synced on relog it will be nil

XP Gain Event

Triggered when a player receives new XP.

XP from the personal category is cached on the client side and refreshed every few minutes

Lua

RegisterNetEvent('devhub_skillTree:client:listener:newXp', function(categoryUid, amount)
    exports['your-hud']:ShowNotification({
        type = 'xp',
        message = string.format('+%d XP (%s)', amount, categoryUid),
        duration = 3000
    })
end)

Parameters:

categoryUid (string): Category name (e.g., 'personal')
amount (number): Amount of XP received

Skill Reset Event

Triggered when a player resets their skills in a category.

Lua

local effectApplied = true
RegisterNetEvent('devhub_skillTree:client:listener:skillReset', function(categoryUid)
    if categoryUid == 'personal' then
        effectApplied = false
    end
end)

Parameters:

categoryUid (string): Category name (e.g., 'personal')

Level Up Event

Triggered when a player levels up in a skill category.

Lua

RegisterNetEvent('devhub_skillTree:client:listener:levelUp', function(categoryUid, newLevel)
    exports['your-hud']:ShowNotification({
        type = 'level',
        message = string.format('Level up! %s reached level %d', categoryUid, newLevel),
        duration = 3000
    })
end)

Parameters:

categoryUid (string): Category name (e.g., 'personal')
newLevel (number): The new level achieved

Server Events

Skill Unlock Event

Triggered when a player unlocks a new skill. IT IS TRIGGERED ONLY ONCE ON FRIST SKILL UNLOCK

Lua

RegisterNetEvent('devhub_skillTree:server:listener:skillUnlocked', function(source, categoryUid, skillUid)
-- do your stuff
end)

Parameters:

source (number) Player Id
categoryUid (string): Category name (e.g., 'personal')
skillUid (string): Unique identifier of the unlocked skill

Skill Reset Event

Triggered when a player resets their skills in a category.

Lua

local effectApplied = true
RegisterNetEvent('devhub_skillTree:server:listener:skillReset', function(source ,categoryUid)
    if categoryUid == 'personal' then
        effectApplied = false
    end
end)

Parameters:

source (number) Player Id
categoryUid (string): Category name (e.g., 'personal')