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