![[QBX / QB-Core] Citizens Journey](https://dunb17ur4ymx4.cloudfront.net/packages/images/261246a0a131be179b3442fb9290f6cc25613447.png)
Citizen's Journey
Season Pass System - 100-tier progression for FiveM QBX / QB-Core servers
Give your players a reason to log in every day. Complete quests, earn XP, and unlock Free or Premium rewards across an entire season.
Features
Season Pass
- 100 tiers per season with Free and Premium reward tracks
- Reward types: money, items (ox_inventory), bonus XP
- Rarity system: Common, Rare, Epic, Legendary
- Horizontal tier rail with instant claiming and auto-scroll
Quests
- Daily, Weekly, and Seasonal quest systems
- Job-locked quests with server-side validation
- 21 built-in quests (police, mechanic, ambulance examples)
- Fully editable Lua config system
Live UI
- Real-time XP and tier updates
- Instant tier-up notifications
- Live quest progress tracking
- Login streak system
- Job badges shown inline in UI
Premium Pass
- Cash, item, or external store payment support
- Webhook-based premium granting (
setPremium()) - Remote premium management via exports
Developer Integration
- Full XP / tier / quest export API
- Client & server event hooks
- Reusable Lua helper functions
Customisation
| File | Controls |
|---|---|
config.lua | Season settings, XP, theme, premium method |
quests.lua | All quests, XP values, job restrictions |
tiers.lua | Free & Premium reward structure |
quests_handler.lua | Client quest triggers |
quests_handler_sv.lua | Server quest logic |
Core logic is protected via CFX native escrow.
Dependencies
- ox_lib
- oxmysql
- qbx_core or qb-core
- ox_inventory or qb-inventory
Installation
- Install resource on server
- Import SQL file
- Ensure resource after dependencies
- Configure
configs/ - Restart server
Licensing
This is a single-server licensed escrowed resource. Redistribution or resale is prohibited.