Events / Export List

Give XP (server-sided)

local success = exports['ak4y-multicharacter-v3']:GiveXp(source, amount) --return true of false

Parameter	Type	Description
source	number	The player id
amount	number	The amount you want to add

Get Level (server-sided)

local playerLevel = exports['ak4y-multicharacter-v3']:GetLevel(source)

Parameter	Type	Description
source	number	The player id

Example Usage;

print("Player is level: " .. playerLevel)

Client-side Events Triggered

ak4y-multicharacter-v3:LevelUp (newLevel, oldLevel) - When player levels up

ak4y-multicharacter-v3:XpIncrease (xpGained, totalXp, currentLevel) - When XP increases

Notes;

- The system automatically handles database creation if a player doesn't have an XP record
- Level is calculated as: floor(XP / Config.NeedXpForLevel) + 1
- Minimum level is always 1
- XP can be negative, but this is not recommended
- The system works with both QB and ESX frameworks
- All XP operations are automatically saved to the database