Battle Pass
A free and premium reward track. Linked players earn XP from kills, scientists, challenges and playtime, then claim each level while they are online.
01What it does
Battle Pass is a Premium feature. The free row is earned by playing. The premium row unlocks only after a player buys Premium Battle Pass from your web store. Buying it lasts until the end date you set. When that pass ends, premium access ends and they buy it again for the next one.
The switch at the top turns tracking on and off. While it is off, nobody earns XP, and nothing is shown in game. While it is on, XP earned in the same 3 seconds is added together and shown once on that player, like +25 XP. That line is not part of the normal chat queue.
02Setting it up
- 1Open Features > Battle Pass.
- 2Choose how many levels the pass has, from 10 to 50. A new pass starts at 25. You can type 10 without the field jumping back to 25, and you can change XP per level while you type.
- 3Set the date and time it ends. Players see a live countdown.
- 4Set how much XP a level costs, then save. That value is stored on the live pass, so it stays after save instead of jumping back to 100. Kill, playtime and challenge XP amounts live in Features > XP System and are shared with Ranks.
- 5Search items, kits or entities and set the amount (up to 1,000,000 for entity prizes). Entities are grouped into Crates, Interactables, Vehicles, Animals and World, each with its picture. That amount shows on the level. On a phone, tap one and then tap the level it belongs on. On a computer you can drag it onto the level instead. Kits need an image link, and the picture is fitted inside the slot. The same reward can go on more than one level.
- 6Turn the switch on and save.
- 7In Store > Products, add a Battle Pass product with a name, price and image.
Changing the end date while the pass is still running keeps the same season, so people who already bought premium stay unlocked. After the end date, saving a new one starts a fresh pass. Levels, claims and premium access do not carry over. Wiping ranks does not move Battle Pass levels.
03How players use it
Only players who have linked their in-game name earn XP. The player dashboard shows the pass, their level, and how much XP they still need. My Info also shows whether they have Premium on the live pass, and how many times they have bought a Battle Pass on that server. A locked level shows a lock. An unlocked level glows. A claimed level is shaded with a check, so it is clear that reward is already taken. They click an open level and choose Deliver in game or Store in vault. Claim all asks the same choice for every unlocked reward that is still waiting. Claim in game only works while they are online. If the server slows the bot down, rewards that already went through stay claimed and the rest can be claimed again. Send all to vault keeps them in My Vault. Nothing is given out on its own. The first time they reach the last level, the page shows “You completed the Battle Pass” for 5 seconds.