# LeaderBoards Datapack 1.21.6+<\/p>\n
A Datapack to place LeaderBoards Ranking players of your server on a given scoreboard objective<\/p>\n
<\/p>\n
## How to use<\/p>\n
LeaderBoards Datapack 1.21.6+ uses the Dialog feature to provide an easy to use interface to create and edit Leaderboards<\/p>\n
<\/p>\n
### Add a LeaderBoard<\/p>\n
“`
\n\/function leaderboard:_dialog\/add_leaderboard_dialog
\n“`<\/p>\n
– **Scoreboard objective name** is the most important parameter, it sets the scoreboard objective to be displayed in the Leaderboard. This **MUST** match the **exact** score name.
\nExample: if you create a scoreboard with the command:
\n`\/scoreboard objectives add score_name dummy “My score”`, the _Scoreboard objective name_ to use will be `score_name` and **NOT** `My score`<\/p>\n
– **Displayed Title** is the name that will be displayed on top of the leaderboard<\/p>\n
– **time_mode** option displays the score as a time with hours, minutes, seconds and 1\/20th of a second (ticks). It requires the given score to be a time in ticks.
\nExtended, keeps ms even when value is larger than 1 hour
\nStopwatch, is more suited for the new `\/stopwatch` command release in 1.21.11. It requires the given socre to be a time in ms. To get such a time you can use the following example:
\n`\/execute store result score @p score_name run stopwatch query minecraft:foo 1000` Note that the x1000 scaling allows to get a time in ms<\/p>\n
– **reverse_order** option reverses the order of the players in the LeaderBoard. Puts the lowest score first<\/p>\n
– **no_zero** option removes players with either no score or a score that equals 0 from the LeaderBoard. This is especially useful in reverse mode to avoid having new players at the top of the LeaderBoard by default<\/p>\n
– **billboard** option sets the billboard type that the LeaderBoard will use
\nIt can be set to vertical, horizontal or fixed
\nWhen using **fixed** billboard type, the direction is set from the head direction of the player executing the command
\ntips: you can use `\/tp @s ~ ~ ~ x y`, with x and y set to the rotation if you want the leaderboard to be aligned to a specific angle<\/p>\n
– **medal_color** option adds medal like colors the the top 3 ranks<\/p>\n
– **show_heads** option adds the player heads next to it’s name **_(1.21.9+ only)_**<\/p>\n
– **always_show_closest_player** option highlights the line of the nearest player. If this player’s rank is not present in the base list (cause of max_players option), it will add an extra line under the default one with the closest player score<\/p>\n
– **bright** option sets the text_displays with constant full brigthness<\/p>\n
– **Custom player list** this is an advanced feature, leave empty to get the default list of player built by the datapack ### Remove a LeaderBoard<\/p>\n This will remove the nearest LeaderBoard<\/p>\n “` ### Edit a LeaderBoard<\/p>\n This will edit the nearest LeaderBoard<\/p>\n “` ### Uninstall<\/p>\n “` (Only keeps the storage leaderboard:namelist in case you want to re-enable it)<\/p>\n ## Back compatibility<\/p>\n Versions of the datapack prior to 1.21.6 are still available but won’t be updated anymore ## Contact<\/p>\n Feel free to join the discord for any question, bug report or feature request A Datapack to place LeaderBoards Ranking players of your server on a given scoreboard objective.<\/p>\n","protected":false},"featured_media":92308,"template":"","meta":{"_minecraft_slug":"leaderboards-datapack","_minecraft_project_id":"zyFuJ0rz","_minecraft_author":"djtgeek","_minecraft_license":"MIT","_minecraft_downloads":1499,"_minecraft_follows":21,"_minecraft_client_side":"optional","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"leaderboards-datapack.zip","_minecraft_size_bytes":288162,"_minecraft_version_count":20,"_minecraft_updated_at":"2026-05-16T03:55:04.371362Z","_minecraft_date_created":"2024-06-17T02:25:26.827952Z","_minecraft_date_modified":"2025-12-30T02:09:48.932148Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/leaderboards-datapack","_minecraft_icon_attachment_id":92308,"_minecraft_imported_at":"2026-06-05T06:40:01+00:00","_minecraft_import_hash":"9360daa45e2653f70ad82fbfc5a7fb81","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[84,126,866,867,92],"mod_loader":[86],"minecraft_version":[94,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-92307","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-datapack","mod_category-management","mod_category-minigame","mod_category-social","mod_category-utility","mod_loader-datapack","minecraft_version-1-20-4","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\nThis parameter allows to use a different storage list for a specific Leaderboard. This can be used to display scoreboard scores that aren’t directly related to a player. For example a custom objective tracking teams scores
\nThe syntax is `
\nFor example if you create your list this way:
\n`\/data modify storage my_storage:custom_namelist names set value [“Team1″,”Team2″,”Team3”]`
\nyou need to use
\n`my_storage:custom_namelist names` in the Custom player list field
\nwarning: this might have some unexpected behaviour when used with `always_show_closest_player` and a list that does not contain the nearest player<\/p>\n
\n\/function leaderboard:commands\/remove_leaderboard
\n“`<\/p>\n
\n\/function leaderboard:_dialog\/edit_leaderboard_dialog
\n“`<\/p>\n
\n\/function leaderboard:commands\/uninstall
\n“`<\/p>\n
\nYou can find tutorials on how to use legacy verisons on the Github link<\/p>\n
\nDiscord invite<\/p>\n","protected":false},"excerpt":{"rendered":"