Two reward tracks sit on one screen: a free one every player levels through, and a premium one that stays locked until it’s bought. Players open it with /battlepass (you can rename the command), earn XP by playing, and claim what each level gives.
The preview video shows both tracks, buying XP and the reset.
Down the left side are the daily missions for extra XP. You choose how many there are, when they reset and what they ask for, and you can write your own missions with the events described in the docs.
Set in the config
- Season length, for example 30 days, after which progress resets
- How much play time earns how much XP
- As many levels as you want, each with its own XP requirement and its own rewards on both tracks: items, money or vehicles. Leave a reward empty to hand out something custom
- Premium: bought from the menu at a price you set, given by command, or granted from another script
- Buying XP and resetting your own battlepass for a fee, each with its own price, and each can be turned off
Admin commands
| Command | What it does |
|---|---|
| /battlepass_addpremium | Gives a player premium |
| /battlepass_removepremium | Takes premium away |
| /battlepass_wipe | Resets one player’s level and rewards |
| /battlepass_wipeall | Resets everyone |
Hooking it into your scripts
Server exports let your other FiveM scripts (jobs, events, shops) feed into it: AddXpToSource, AddMissionProgress, GetPlayerMissions, AddPlayerPremium, RemovePlayerPremium and HasPlayerPremium.
Works with ESX, QBCore and Qbox, and with ox_inventory. Other frameworks can be connected through the editable functions. Needs oxmysql or mysql-async. See the installation and configuration guide.
