Skip to content
On this page

Leader Board Definitions

Filename discordconnector-leaderBoards.cfg

Use this file to define custom leader board messages to be sent. Previous versions of DiscordConnector offered only a few options for leader boards, but the custom leader board configuration introduced in 2.1.0, up to 5 custom leader boards can be defined.

There is a section of this config for each custom board that can be defined. Each is named LeaderBoard.#, where # is 1-5. By default, all the boards are disabled, so you must manually enable any you wish to use.

Leader Board Configuration

Each leader board lets you set these options:

OptionDefaultDescription
EnabledfalseEnable or disable this leader board
Leader Board Time RangeAll TimeSet the time restriction of this leader board to one of the time range values
Number of Rankings3How many rankings to include in the leader board.
TypeMost to Least (Descending)Can be either "Most to Least (Descending)" or "Least to Most (Ascending)"
Sending Period600How many minutes to wait before sending the leader board. 600 minutes is the old default of 10 hours.
Death StatisticstrueInclude player death statistics in the leader board
Session StatisticstrueInclude player session statistics in the leader board (how many times they have played on the server)
Ping StatisticstrueInclude player ping statistics in the leader board
Time Online StatisticstrueInclude player total play time in the leader board
Leader Board HeadingLeaderBoard.NTitle of the leader board which is displayed when sent to discord.

Available Predefined Variables (Leader Boards)

In the "Leader Board Heading," the following variables are available:

VariableReplaced with..
%NThe value of "Number of Rankings" (by default: 3)

Leader Board Time Ranges

OptionDescription
All TimeInclude every record, as far back as the database goes.
TodayInclude only records from today.
YesterdayInclude only records from yesterday.
Past 7 DaysInclude only the past 7 days (inclusive of today)
Current Week, Sunday to SaturdayInclude all records from this week (inclusive of today)
Current Week, Monday to SundayInclude all records from this week (inclusive of today)

Active Player Announcement Configuration

These options are available:

OptionDefaultDescription
EnabledfalseEnable or disable this leader board
Sending Period600How many minutes to wait before sending the leader board. 600 minutes is the old default of 10 hours.
Include Currently Online PlayerstrueEnable or disable currently online players as part of the active players announcement
Include Unique Players for TodaytrueEnable or disable unique online players for today as part of the active players announcement
Include Unique Players for the Past WeektrueEnable or disable unique online players for the past week (including today) as part of the active players announcement
Include Unique Players from All TimetrueEnable or disable unique online players from all time as part of the active players announcement