Skip to content

TrapsLevelSystem

QBCore leveling, tokens, skills, civilian jobs, and the skills tablet — with server exports for other resources.

Features

  • XP, levels, tokens, and skill tiers with modifiers
  • Passive XP and civilian job selection flows
  • Tablet NUI (html/) + optional XP HUD pieces
  • Server exports for granting XP and reading level / job gates

Dependencies

  • qb-core
  • oxmysql
  • Optional ox_lib depending on notify settings (see in-repo README.md)

Notes

Folder name

Must remain TrapsLevelSystem (shared/resource_guard.lua).

  • Start order: oxmysqlqb-coreTrapsLevelSystem → resources that call exports.
  • Full API examples live in README.md inside the resource.

Installation

How to install

  1. Copy to resources/TrapsLevelSystem (exact folder name).
  2. Let the resource create DB tables on first start (see README).
  3. Tune config.lua, config/skills.lua, config/passive_xp.lua, config/themes.lua.
  4. ensure TrapsLevelSystem after core deps.
  5. Restart.

Integration

Grant XP and read gates from other resources (server-side):

local ok = exports['TrapsLevelSystem']:AddXP(source, 25, 'Quest complete')
local level = exports['TrapsLevelSystem']:GetPlayerLevel(src)
local ok, reason, extra = exports['TrapsLevelSystem']:TrySetCivilianJob(src, 'taxi')

Declare the dependency when needed:

dependencies { 'qb-core', 'TrapsLevelSystem' }

Client menus should use QBCore callbacks (see resource README.md for the exact callback names).