XLeaderboards

If you're using the plugin in production, it's recommended to join our community on Discord for fast support and access to Dev Builds of the plugin.

Improvements & New Features

• Editable Reset Time & Dates for Weekly and Monthly Tops:
  You can now change the reset hour for daily tops and the reset day for weekly and monthly tops directly from in-game.
  These changes apply instantly without restarting the server.

• Configurable Timezone with Instant Updates:
  Players (or administrators) can now select the timezone for leaderboards.
  The system recalculates timers instantly based on the new timezone.
  If debug mode is enabled, the console will display the difference in time added or removed — useful for testing.

• Hot Commands for Real-Time Editing:
  All time-related settings (reset hour, weekday, month day, timezone, etc.) can now be updated while the server is running, without reloading or restarting.

• New Time-Based Placeholder Conversion System:
  Tops can now receive placeholders containing time formats (e.g., "1h 20m 5s") and convert them into numbers.
  You can choose the unit to convert to:

  • Hours
  • Minutes
  • Seconds

  This allows the top to properly sort and display time-based metrics.

• Custom Tops System (Fully Configurable):
  You can now create custom tops with individual parameters.
  Each custom top can have:

  • Display name
  • Start timestamp
  • End timestamp
  • Update interval
  • Active/Inactive status
  • Flag for whether rewards were already delivered
  • Last update timestamp
  • Next update timestamp

• Improved Rewards Mode with Custom Top Support:
  The rewards system was updated and now fully supports custom tops, including finished, ongoing and upcoming states.

• New Placeholders for Custom Tops:
  You can now use the following placeholders to display all relevant information of any custom top:

%xleaderboard_custom_top_<id>_status% – Shows whether the top is Active, Finished, or Upcoming
%xleaderboard_custom_top_<id>_remaining% – Time remaining until end (or time until start)
%xleaderboard_custom_top_<id>_name% – The display name of the custom top
%xleaderboard_custom_top_<id>_starttime% – Start timestamp
%xleaderboard_custom_top_<id>_endtime% – End timestamp

Improvements:

• The ability to create separate rewards for daily, weekly, and monthly leaderboards has been added. (If you already created rewards, you must move them into each time path).

• For optimization purposes, a placeholder has been added to return the full top line (editable from the language files). This avoids making two separate PlaceholderAPI calls to get both name and amount.

  %xleaderboard_top_<topName>;<timeType>;top_line;1%

• Since each top has different update times, users may get confused, so two new placeholders have been added. Their format can be edited in the configuration.

  %xleaderboard_update_cooldown_<timeType>%
%xleaderboard_reset_cooldown_<timeType>%

Fixed:

• Some additions have been made that were not compatible with Folia.

Improvements:

• The ability to create separate rewards for daily, weekly, and monthly leaderboards has been added. (If you already created rewards, you must move them into each time path).

• For optimization purposes, a placeholder has been added to return the full top line (editable from the language files). This avoids making two separate PlaceholderAPI calls to get both name and amount.

  %xleaderboard_top_<topName>;<timeType>;top_line;1%

• Since each top has different update times, users may get confused, so two new placeholders have been added. Their format can be edited in the configuration.

  %xleaderboard_update_cooldown_<timeType>%
%xleaderboard_reset_cooldown_<timeType>%

Fixed:

• Some additions have been made that were not compatible with Folia.

TOP REWARDS

• You can now give rewards to top players. If the player is online, the reward is given instantly; if offline, they receive it when they reconnect. If you update the rewards file while they're offline, they will receive the updated reward.

Improvements:

• Added a configurable message in lang.yml to translate "Loading" when a leaderboard is displayed.
• Improved the detection of leaderboard resets, which sometimes failed to execute correctly.
• Added a command to forcibly reset the top, useful for testing functionality: /xlb forcereset daily
• Leaderboards now fetch fresh data from the cache when updated, so changes appear instantly in placeholders.
• Added an option to save data of online players when the leaderboards update. This parses and saves placeholders of all connected players for instant updates.
  Recommended for servers with 50–100 players online. Not recommended for servers with 500+ players.

enabled: false
rewards:
  kills:
    top1:
      top: 1
      rewards:
        - "command: give <player> diamond_sword"
        - "message: &7   &a"
        - "center_message: &6&lTOP &e#<top> &6&lKILLS &f&l<amount>"
        - "message: &7   &d"
        - "message: &7You have received a diamond sword for staying in top!"
        - "message: &7   &a"
    top2:
      top: 2
      rewards:
        - "command: give <player> iron_sword"
        - "message: &7   &a"
        - "center_message: &6&lTOP &e#<top> &6&lKILLS &f&l<amount>"
        - "message: &7   &d"
        - "message: &7You have received a iron sword for staying in top!"
        - "message: &7   &a"
    top3:
      top: 3
      rewards:
        - "command: give <player> stone_sword"
        - "message: &7   &a"
        - "center_message: &6&lTOP &e#<top> &6&lKILLS &f&l<amount>"
        - "message: &7   &d"
        - "message: &7You have received a stone sword for staying in top!"
        - "message: &7   &a"

TOP REWARDS

• You can now give rewards to top players. If the player is online, the reward is given instantly; if offline, they receive it when they reconnect. If you update the rewards file while they're offline, they will receive the updated reward.

Improvements:

• Added a configurable message in lang.yml to translate "Loading" when a leaderboard is displayed.
• Improved the detection of leaderboard resets, which sometimes failed to execute correctly.
• Added a command to forcibly reset the top, useful for testing functionality: /xlb forcereset daily
• Leaderboards now fetch fresh data from the cache when updated, so changes appear instantly in placeholders.
• Added an option to save data of online players when the leaderboards update. This parses and saves placeholders of all connected players for instant updates.
  Recommended for servers with 50–100 players online. Not recommended for servers with 500+ players.

enabled: false
rewards:
  kills:
    top1:
      top: 1
      rewards:
        - "command: give <player> diamond_sword"
        - "message: &7   &a"
        - "center_message: &6&lTOP &e#<top> &6&lKILLS &f&l<amount>"
        - "message: &7   &d"
        - "message: &7You have received a diamond sword for staying in top!"
        - "message: &7   &a"
    top2:
      top: 2
      rewards:
        - "command: give <player> iron_sword"
        - "message: &7   &a"
        - "center_message: &6&lTOP &e#<top> &6&lKILLS &f&l<amount>"
        - "message: &7   &d"
        - "message: &7You have received a iron sword for staying in top!"
        - "message: &7   &a"
    top3:
      top: 3
      rewards:
        - "command: give <player> stone_sword"
        - "message: &7   &a"
        - "center_message: &6&lTOP &e#<top> &6&lKILLS &f&l<amount>"
        - "message: &7   &d"
        - "message: &7You have received a stone sword for staying in top!"
        - "message: &7   &a"