Leaderboard Prizes
Weekly and monthly competitions. Gangs score points for what they do during each period, and the top gangs are paid automatically when it ends.
📈 How gangs score
Only what a gang gains during the period counts, so every gang starts each week and month at 0.
| Gained during the period | Points (default) |
|---|---|
| Each XP | 1 |
| Hotspot capture | 50 |
| Contract completed | 20 |
| War won | 100 |
| Protection money collected | 10 |
| Tag sprayed | 2 |
| Drug sold | 1 |
Gangs created mid-period start scoring from the moment they appear.
📅 Periods
| Period | Runs |
|---|---|
| Weekly | Monday 00:00 to the next Monday 00:00 (the start day can be changed) |
| Monthly | 1st of the month 00:00 to the 1st of the next month |
Times use the server clock plus UtcOffset from shared/core.lua. Each period can be switched on or off separately.
💰 Payout
When a period ends:
- The final standings are taken.
- Prizes go to the top gangs (3 places by default, up to 10).
- Every online member of a winning gang is told "Your gang finished #1 on the weekly leaderboard!"
- The win is recorded in the gang's activity log.
- The results are saved and posted to the Discord
generalwebhook. - A new period starts right away.
Default prizes
| Place | Weekly | Monthly |
|---|---|---|
| #1 | $100,000 dirty + 1,000 XP | $500,000 clean + a Baller |
| #2 | $50,000 dirty + 500 XP | $250,000 clean |
| #3 | $25,000 dirty | $100,000 clean |
Prizes can be dirty money, clean cash (gang treasury), gang XP, or a vehicle (gang garage).
Tier limit: set a lowest tier that can win, for example Certified. Lower tiers still appear on the board, but their prize passes to the next eligible gang. Gangs with 0 points never win.
📱 In the tablet
Ranking gets Weekly and Monthly tabs with the countdown, live standings, the prizes, how to score, and past winners.
🛠️ Admin setup
Admin → Leaderboard: change the scoring, reset day, tier limit and prizes, see the current top 5, end a period early, and view past results.