Leaderboards
Purpose
A leaderboard is a table where players are ranked by their scores. This page lists the leaderboards in your environment as cards: name, reset interval, whether it is visible in the game, the player count this season, the leader and the time left until the next reset. You also set up a new leaderboard from here. Your game server sends the scores; the panel does not write scores.
When to use
- To set up a leaderboard before your game server sends scores.
- To see which leaderboard is visible, when it will reset and who leads it.
- To move to a leaderboard’s detail (ranking, past seasons, settings).
Step by step
Set up a new leaderboard
- Press Yeni tablo (New leaderboard). Only admins with the leaderboard management permission see the button.
- Write a name in the Tablonun adı (Leaderboard name) field; the key fills in automatically. If you wish, change the key yourself.
- Choose Hangi puan önde? (Which score comes first?) and Ne zaman sıfırlansın? (When should it reset?). If you choose “Özel aralık” (Custom interval), write days and hours.
- Choose Puan nasıl gösterilsin? (How should the score be shown?); write a unit suffix if needed.
- If you want players to see the leaderboard in the game, turn on the Oyunda görünsün (Show in game) switch.
- Check how the score will look in the preview row below and press Tabloyu oluştur (Create leaderboard). On success the leaderboard’s detail page opens.
Warning
The key, sort direction and reset interval cannot be changed after the leaderboard is set up. To change them you need to set up a new leaderboard; so choose carefully before setting it up.
Open a leaderboard
Click the card’s name; the detail page opens (Leaderboard detail).
Fields and options
| Field | Required | Description |
|---|---|---|
| Leaderboard name | Yes | 1-400 characters |
| Key | Yes | Starts with a lowercase letter or digit; lowercase letters, digits, dots, hyphens, underscores; at most 200 characters |
| Which score comes first? | Yes | High score or low score |
| When should it reset? | Yes | Never, every day, every week (Monday), every month or custom interval |
| Days, Hours | Only for a custom interval | At least one of days or hours; total at least 1 hour, whole numbers |
| How should the score be shown? | Yes | Number, money or time |
| Unit suffix | No | At most 8 characters; not available for the time unit |
| Show in game | No | Off by default |
Common situations
| Situation | What to do |
|---|---|
| “Bu anahtar kullanılıyor ya da bir eklentiye ayrılmış” (This key is in use or reserved for a plugin) | Choose another key. Some key prefixes are reserved for the game’s plugin. |
| There is no leaderboard in the list and it says “package-ride eklentisi ‘Günlük kazanç’ tablosunu ilk teslimatta kendiliğinden kurar” (the package-ride plugin sets up the ‘Daily earnings’ leaderboard by itself at the first delivery) | The plugin sets the leaderboard up at the first delivery; no delivery has happened yet. You only need to wait. |
| “Sıralama (Competition) modülü bu ortamda kapalı” (The Leaderboard (Competition) module is off in this environment) | Turn the module on from Game settings › Modules. |
| The “Yeni tablo” button is missing | You do not have the leaderboard management permission; ask an admin. |
| I see only the first leaderboards | The list shows at most a certain number of leaderboards; when the limit is reached the page says so. More is not listed in this version. |
| The card says “Kaynak: … eklentisi (otomatik)” (Source: … plugin (automatic)) | A plugin set the leaderboard up and only that plugin writes scores. |