Season Pass
"Season settings and reward tracks": run seasons and choose the rewards.
1. Season settings
The status on the right shows "Ends in …", "No end date" or "Ended".
| Field | Meaning |
|---|---|
| Season name | 1–48 characters |
| Ends at | End date and time. Leave empty for no end |
| Premium price | Cost to unlock premium |
Press Save. Players' pass pages update straight away.
2. Rewards grid
- The header shows the total, free and premium reward counts, and the max level.
- One row per level (8 per page), with a Free and a Premium slot.
- Filled slot: image, name, type, amount and rarity. Hover it for ✏️ Edit and 🗑️ Delete.
- Empty slot: press + Add free or + Add premium.
➕ Adding or editing a reward
Press Add reward, or click an empty slot.
| Field | Meaning |
|---|---|
| Level | Gang level needed |
| Track | Free or Premium |
| Kind | Item, Weapon, Clean cash (treasury), Dirty cash (treasury), Vehicle (gang garage), Gang XP |
| Rarity | Card colour |
| Name | Item name, weapon name (e.g. WEAPON_PISTOL) or vehicle model (e.g. sultan). Must exist on your server |
| Amount | How many. Vehicles are always 1 |
| Label | Optional custom name |
| Image URL | Optional. Items use the inventory image |
A live preview shows the card. Press Create or Save.
Each level can have one free and one premium reward.
📥 Syncing rewards from the config
Changed the rewards in shared/pass.lua and want them in game without wiping the database?
- Press Sync from config in the Season settings card.
- Optionally turn on Remove rewards that are not in the config.
- Press Sync from config (and confirm if you chose to remove rewards).
What happens:
- Every reward in
shared/pass.luais added. A reward already on the same level and track is replaced by the one from the config. - Rewards you added here that are not in the config are kept, unless you turned on the remove option.
- Gang levels, premium status and claimed rewards are not touched.
- Players' pass pages update straight away, and the sync is recorded in Logs.
🔄 Starting a new season
- Press Start new season.
- Check the New season name (suggested automatically, e.g. Season 2).
- Set Ends at (defaults to 60 days from now).
- Choose whether to also reset gang levels and XP.
- Press Start season and confirm.
What happens:
- Every gang loses premium, with no refund.
- All claimed rewards reset, so gangs can claim again.
- If you chose it, every gang goes back to level 1.
- The reward tracks stay the same. Edit them afterwards if you want new rewards.
Starting a new season can't be undone, especially with a level reset.
⚠️ Good to know
- The season name, end date and premium price saved here override the config.
- Rewards from the config are added automatically only on first install. After that, manage them here, or press Sync from config to pull in changes from
shared/pass.lua. - By default, gangs can't claim after the season ends until you set a new end date or start a new season.