Citizen’s Journey - Season Pass System [QBX / QB-Core]
hb_citizensjourney is a full-featured, 0-100 tier seasonal battle pass for FiveM QBX / QB-Core servers. Players earn XP by completing daily, weekly, and seasonal quests - including job-restricted quests that only progress when the player is on the correct job - advance through 100 tiers, and claim free or premium rewards through a clean, real-time UI.
Showcase Video
Features
- 100-tier season pass with separate Free and Premium reward tracks
- Three quest categories - Daily, Weekly, and Seasonal, each supporting optional job restrictions (validated server-side against qbx_core / qb-core)
- Live UI - XP bar, tier-up notifications, and quest progress update in real time without reopening the menu. Job-required quests show a job badge inline next to the category tag
- Login streak tracking - consecutive daily logins rewarded
- Full server export API - any resource can award XP, track quest progress, grant premium, and more
- Fully configurable per season - swap quests, tiers, and rewards in plain Lua config files; no touching encrypted logic
- Custom Quests - add your own quests to other scripts via the provided exports
Screenshots
What You Can Edit
The following files are open and fully editable:
| File | Purpose |
|---|---|
configs/config.lua |
Season name, end date, XP per tier, theme, passive XP, premium purchase method/price |
configs/quests.lua |
All quest definitions, XP values, job restrictions, tier name thresholds |
configs/tiers.lua |
All tier rewards (free + premium, money/item/XP) |
configs/quests_handler.lua |
Client-side quest progress detection (driving distance, sprinting, etc.) |
configs/quests_handler_sv.lua |
Server-side quest progress detection (arrests made, vehicles repaired, etc.) |
Dependencies
- ox_lib
- oxmysql
- qbx_core or qb-core
- ox_inventory or qb-inventory
Player UI
Open with F7 (rebindable via keybind settings — command hb_cj_toggle).
Three tabs:
- Pass — horizontal tier track with Free/Premium reward cards, claimable in one click
- Quests — daily, weekly, and seasonal quests with live progress bars; job-restricted quests display a coloured job badge next to the type tag
- Rewards — full claimed reward history
Server Exports
All exports are server-side. Any resource can call:
-- Award XP (triggers tier-up + UI push)
exports['hb_citizensjourney']:addXP(src, 500)
-- Track quest progress (server validates job restriction automatically)
exports['hb_citizensjourney']:trackProgress(citizenid, 'd_police_arrest')
-- Grant premium (e.g. after Tebex payment webhook)
exports['hb_citizensjourney']:setPremium(citizenid, true)
Full API documented in the resource README.
Installation
- Drop
hb_citizensjourneyinto your resources folder - Import
sql/cj_tables.sql - Add
ensure hb_citizensjourneytoserver.cfgafter all dependencies - Configure season, quests, and tier rewards in
configs/ - Start the resource
Documentation | Tebex - $10.00 | Discord
Pricing & Licensing
This resource is sold as a protected release through Tebex using CFX’s native escrow system. Config files remain open and fully editable. Redistribution and resale are not permitted.
| Code is accessible | No |
| Subscription-based | No |
| Lines (approximately) | 1000+ |
| Requirements | ox_lib, qbx_core or qb-core, ox_inventory or qb-inventory |
| Support | Yes |
