Creating leaderboard
To add a leaderboard in the game, you need to create the leaderboard in the BACKND console.
Pre-process
You need to be able to set the standard for what value will be used as the basis for calculating ranks.
Create a table so that this value can be stored in the game information (user data table).
- Create a table in the game information menu.
- Set the field as a numeric type.
Creating leaderboard
Upon clicking the button ‘Create Leaderboard’ on the top, the following modal is opened,
and you can create your desired form of leaderboard through configuration.
Group categorization
By using Group, you can create a leaderboard based on a group.
| Category | By Group | None |
|---|---|---|
| Ranking calculation range | Ranking calculation is done within each group. | Regardless of the group, calculation is done based on all users (or guild). |
| Number of leaderboards | Number of participated group during the calculation period | x1 |
Reset cycle
You can set both the reset cycle and the time.
You can select the reset time between 00:00 to 23:00.
| Type | Description |
|---|---|
| Every day | The leaderboard is reset on a daily basis. |
| Every Monday | The leaderboard is reset on a weekly basis. |
| Every 1st of N Month | The leaderboard is reset on a N monthly basis (if N is set 2, it is reset every 2 months). |
| None | The leaderboard does not reset, and it is accumulated. Since the leaderboard does not reset, reward based on final ranking cannot be sent. |
| Custom Date | You can select the start and end date, and it will not repeat. Leaderboard resets one day after it ends. |
For more information on resetting, please refer to the About Leaderboard documentation.
Collection target
- You can select the target from either users or guilds.
| Category | User Target | Guild Target |
|---|---|---|
| Rank Collection Target | User | Guild |
| Participable Tagets | All Users | All Users in Guilds |
| Additional Fields Supported | Supported | Not supported |
Collection field
User target
- You can calculate rankings based on specific user data.
- Specify the game information table and fields to be used for ranking calculation. Only private tables and numeric fields can be selected. The most recent 100 data entries from the selected table will be collected to display the fields.
- In addition to the calculation field, you can configure additional fields that you want to display on the leaderboard.
Guild target
- Rankings can be calculated based on the guild's metadata or goods (currency) information. Detailed fields will be displayed based on the most recently created guild.
- For leaderboards based on the guild's metadata, only numeric fields can be selected, and all users who are part of the guild can modify the data. Create the guild's metadata through the SDK.
- For leaderboards based on the guild's goods (currency) information, all users who are part of the guild can donate currency to the guild, but only the guild master has the permission to use it.
Field reset
- When the leaderboard rankings are reset, the field values used for calculations can be reset to 0.
- Additional fields are not reset.
If there are multiple rows for a single user in the game information table used for the leaderboard, the data from the most recently created row will reset.
In this case, data from rows that are unrelated to the leaderboard may be reset, therefore the table used for the leaderboard must be managed to ensure that there is only one row of data per user.
Sort
Can either select descending or ascending.
Reward
Reward table
When the leaderboard is reset, rewards can be provided to participants based on their final ranking.
Rewards are sent via BACKND Mail.
Select the reward table where rewards have been set for each ranking tier.
Reward mail title
The reward mail title can be set differently for each language.