![Image](https://i.imgur.com/r8gOjSU.png) This plugin is designed for users seeking a fast and efficient leaderboard system, supporting time-based rankings such as daily, weekly, monthly, and permanent leaderboards. We handle everything through placeholders, eliminating the need for NPCs or menus. The key advantage is the ease with which time-based leaderboards can be created, an area where few plugins on the market currently excel. ![Image](https://i.imgur.com/P8yEx9V.png) - **Timed Tops:** Efficient and fast ranking system that supports daily, weekly, monthly, and permanent leaderboards. - **Easy Setup:** Configure new leaderboards effortlessly using placeholders. - **Unlimited Possibilities:** By using placeholders, you can create leaderboards for any plugin without needing direct compatibility. XLeaderboards handles the differences between various numbers seamlessly. - **Player Ranking:** The plugin includes a player ranking system that shows your current position in the daily, weekly, monthly, and permanent leaderboards. - **Optimizations:** You can adapt the plugin to your server's processing capacity and user base, allowing you to adjust the frequency of writes, data amounts, and time intervals. - **All Versions:** Supports all major versions; however, if it doesn't support a version you're using, feel free to reach out on Discord and request it. - **Auto Update Config:** The configuration updates automatically, so you don’t need to touch anything or worry about version compatibility. - **More Features on Request:** You can join our Discord and request any features you need. ![Image](https://i.imgur.com/H8dWxWZ.png) 1. **Download and install the plugin.** MongoDB is a mandatory requirement, and the plugin will not work without it. 2. **Start your server.** Once the plugin folder is generated, configure your MongoDB credentials. 3. **Set up your tops.** Use the placeholders of your choice to create customized tops. 4. **Integrate with DecentHolograms or your preferred plugin.** Ensure that the plugin supports PlaceholderAPI, and follow the example configuration provided below. 5. **Refer to the placeholders section.** All available formats for placeholders are listed in the dedicated section.

DecentHolograms Example Config

```yaml location: Spawnb:6.022:33.500:11.943 enabled: true display-range: 48 update-range: 48 update-interval: 20 facing: 0.0 down-origin: false pages: - lines: - content: '#ICON: PLAYER_HEAD (eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWM2ZTYwNGJkNTNkOTc4ODc1OTVhMDYyYjdjNTEyY2E0ZGJiZmU0OGJiNGFkY2VmNzEyNWQxZGIxMDNhYjdmZiJ9fX0=)' height: 0.7 - content: '#F4F149&lJ#F5F246&lU#F5F242&lG#F6F33F&lA#F7F33B&lD#F8F438&lO#F8F535&lR#F9F531&lE#FAF62E&lS #FBF727&lM#FBF727&lI#FBF727&lL#FBF727&lL#FBF727&lO#FBF727&lN#FBF727&lA#FBF727&lR#FBF727&lI#FBF727&lO#FBF727&lS' height: 0.3 - content: '&7(La riqueza y ellos son uno)' height: 0.3 - content: '' height: 0.3 - content: '#FBF727#1. &f%xleaderboard_top_coins;daily;top_name;1% &8- #FBF727%xleaderboard_top_coins;daily;top_value;1% #FAFF2E⛃' height: 0.3 - content: '#FBF727#2. &f%xleaderboard_top_coins;daily;top_name;2% &8- #FBF727%xleaderboard_top_coins;daily;top_value;2% #FAFF2E⛃' height: 0.3 - content: '#FBF727#3. &f%xleaderboard_top_coins;daily;top_name;3% &8- #FBF727%xleaderboard_top_coins;daily;top_value;3% #FAFF2E⛃' height: 0.3 - content: '#FBF727#4. &f%xleaderboard_top_coins;daily;top_name;4% &8- #FBF727%xleaderboard_top_coins;daily;top_value;4% #FAFF2E⛃' height: 0.3 - content: '#FBF727#5. &f%xleaderboard_top_coins;daily;top_name;5% &8- #FBF727%xleaderboard_top_coins;daily;top_value;5% #FAFF2E⛃' height: 0.3 - content: '&r' height: 0.3 - content: '&8► &fTu posición: #FBF727#%xleaderboard_ranking_daily_coins% &8- #FBF727%xleaderboard_amount_daily_coins% #FAFF2E⛃ &8◄' height: 0.3 - content: '&r' height: 0.3 - content: '#F4F149&l[Diario] &7[Semanal] [Mensual] [Permanente]' height: 0.3 actions: RIGHT: - NEXT_PAGE:tops_DINERO - SOUND:UI_BUTTON_CLICK:0.7:2.7 - lines: - content: '#ICON: PLAYER_HEAD (eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWM2ZTYwNGJkNTNkOTc4ODc1OTVhMDYyYjdjNTEyY2E0ZGJiZmU0OGJiNGFkY2VmNzEyNWQxZGIxMDNhYjdmZiJ9fX0=)' height: 0.7 - content: '#F4F149&lJ#F5F246&lU#F5F242&lG#F6F33F&lA#F7F33B&lD#F8F438&lO#F8F535&lR#F9F531&lE#FAF62E&lS #FBF727&lM#FBF727&lI#FBF727&lL#FBF727&lL#FBF727&lO#FBF727&lN#FBF727&lA#FBF727&lR#FBF727&lI#FBF727&lO#FBF727&lS' height: 0.3 - content: '&7(La riqueza y ellos son uno)' height: 0.3 - content: '' height: 0.3 - content: '#FBF727#1. &f%xleaderboard_top_coins;weekly;top_name;1% &8- #FBF727%xleaderboard_top_coins;weekly;top_value;1% #FAFF2E⛃' height: 0.3 - content: '#FBF727#2. &f%xleaderboard_top_coins;weekly;top_name;2% &8- #FBF727%xleaderboard_top_coins;weekly;top_value;2% #FAFF2E⛃' height: 0.3 - content: '#FBF727#3. &f%xleaderboard_top_coins;weekly;top_name;3% &8- #FBF727%xleaderboard_top_coins;weekly;top_value;3% #FAFF2E⛃' height: 0.3 - content: '#FBF727#4. &f%xleaderboard_top_coins;weekly;top_name;4% &8- #FBF727%xleaderboard_top_coins;weekly;top_value;4% #FAFF2E⛃' height: 0.3 - content: '#FBF727#5. &f%xleaderboard_top_coins;weekly;top_name;5% &8- #FBF727%xleaderboard_top_coins;weekly;top_value;5% #FAFF2E⛃' height: 0.3 - content: '&r' height: 0.3 - content: '&8► &fTu posición: #FBF727#%xleaderboard_ranking_weekly_coins% &8- #FBF727%xleaderboard_amount_weekly_coins% #FAFF2E⛃ &8◄' height: 0.3 - content: '&r' height: 0.3 - content: '&7[Diario] #F4F149&l[Semanal] &7[Mensual] [Permanente]' height: 0.3 actions: LEFT: - PREV_PAGE:tops_DINERO - SOUND:UI_BUTTON_CLICK:0.7:2.7 RIGHT: - NEXT_PAGE:tops_DINERO - SOUND:UI_BUTTON_CLICK:0.7:2.7 - lines: - content: '#ICON: PLAYER_HEAD (eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWM2ZTYwNGJkNTNkOTc4ODc1OTVhMDYyYjdjNTEyY2E0ZGJiZmU0OGJiNGFkY2VmNzEyNWQxZGIxMDNhYjdmZiJ9fX0=)' height: 0.7 - content: '#F4F149&lJ#F5F246&lU#F5F242&lG#F6F33F&lA#F7F33B&lD#F8F438&lO#F8F535&lR#F9F531&lE#FAF62E&lS #FBF727&lM#FBF727&lI#FBF727&lL#FBF727&lL#FBF727&lO#FBF727&lN#FBF727&lA#FBF727&lR#FBF727&lI#FBF727&lO#FBF727&lS' height: 0.3 - content: '&7(La riqueza y ellos son uno)' height: 0.3 - content: '' height: 0.3 - content: '#FBF727#1. &f%xleaderboard_top_coins;monthly;top_name;1% &8- #FBF727%xleaderboard_top_coins;monthly;top_value;1% #FAFF2E⛃' height: 0.3 - content: '#FBF727#2. &f%xleaderboard_top_coins;monthly;top_name;2% &8- #FBF727%xleaderboard_top_coins;monthly;top_value;2% #FAFF2E⛃' height: 0.3 - content: '#FBF727#3. &f%xleaderboard_top_coins;monthly;top_name;3% &8- #FBF727%xleaderboard_top_coins;monthly;top_value;3% #FAFF2E⛃' height: 0.3 - content: '#FBF727#4. &f%xleaderboard_top_coins;monthly;top_name;4% &8- #FBF727%xleaderboard_top_coins;monthly;top_value;4% #FAFF2E⛃' height: 0.3 - content: '#FBF727#5. &f%xleaderboard_top_coins;monthly;top_name;5% &8- #FBF727%xleaderboard_top_coins;monthly;top_value;5% #FAFF2E⛃' height: 0.3 - content: '&r' height: 0.3 - content: '&8► &fTu posición: #FBF727#%xleaderboard_ranking_monthly_coins% &8- #FBF727%xleaderboard_amount_monthly_coins% #FAFF2E⛃ &8◄' height: 0.3 - content: '&r' height: 0.3 - content: '&7[Diario] [Semanal] #F4F149&l[Mensual] &7[Permanente]' height: 0.3 actions: LEFT: - PREV_PAGE:tops_DINERO - SOUND:UI_BUTTON_CLICK:0.7:2.7 RIGHT: - NEXT_PAGE:tops_DINERO - SOUND:UI_BUTTON_CLICK:0.7:2.7 - lines: - content: '#ICON: PLAYER_HEAD (eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWM2ZTYwNGJkNTNkOTc4ODc1OTVhMDYyYjdjNTEyY2E0ZGJiZmU0OGJiNGFkY2VmNzEyNWQxZGIxMDNhYjdmZiJ9fX0=)' height: 0.7 - content: '#F4F149&lJ#F5F246&lU#F5F242&lG#F6F33F&lA#F7F33B&lD#F8F438&lO#F8F535&lR#F9F531&lE#FAF62E&lS #FBF727&lM#FBF727&lI#FBF727&lL#FBF727&lL#FBF727&lO#FBF727&lN#FBF727&lA#FBF727&lR#FBF727&lI#FBF727&lO#FBF727&lS' height: 0.3 - content: '&7(La riqueza y ellos son uno)' height: 0.3 - content: '' height: 0.3 - content: '#FBF727#1. &f%xleaderboard_top_coins;permanent;top_name;1% &8- #FBF727%xleaderboard_top_coins;permanent;top_value;1% #FAFF2E⛃' height: 0.3 - content: '#FBF727#2. &f%xleaderboard_top_coins;permanent;top_name;2% &8- #FBF727%xleaderboard_top_coins;permanent;top_value;2% #FAFF2E⛃' height: 0.3 - content: '#FBF727#3. &f%xleaderboard_top_coins;permanent;top_name;3% &8- #FBF727%xleaderboard_top_coins;permanent;top_value;3% #FAFF2E⛃' height: 0.3 - content: '#FBF727#4. &f%xleaderboard_top_coins;permanent;top_name;4% &8- #FBF727%xleaderboard_top_coins;permanent;top_value;4% #FAFF2E⛃' height: 0.3 - content: '#FBF727#5. &f%xleaderboard_top_coins;permanent;top_name;5% &8- #FBF727%xleaderboard_top_coins;permanent;top_value;5% #FAFF2E⛃' height: 0.3 - content: '&r' height: 0.3 - content: '&8► &fTu posición: #FBF727#%xleaderboard_ranking_permanent_coins% &8- #FBF727%xleaderboard_amount_permanent_coins% #FAFF2E⛃ &8◄' height: 0.3 - content: '&r' height: 0.3 - content: '&7[Diario] [Semanal] [Mensual] #F4F149&l[Permanente]' height: 0.3 actions: LEFT: - PREV_PAGE:tops_DINERO - SOUND:UI_BUTTON_CLICK:0.7:2.7 ```

config.yml

```yaml tops: kills: ## This placeholder will parse to retrieve the current count of this leaderboard. placeholder: "%statistic_player_kills%" name: "Asesinatos" databaseId: survival_top debug: false optimizations: ## Max bulk size for mongodb, if you have a lot of players, you can increase this value, ## but be careful with the memory usage. max-bulk-size: 1000 ## Max cached top entries your server loads on memory. cached-top-entries: 10 ## If you have a lot of players, you can increase this value. ticks-between-updates: 600 ## Max bulk size for resetting temporal values, this have minor size ## you can increase this value, but be careful with the memory usage. max-reset-bulk-size: 5000 topUpdates: daily: minutes: 10 weekly: minutes: 30 monthly: hours: 3 permanent: hours: 6 databases: mongodb: host: localhost port: 27017 database: leaderboards user: root password: root ```

lang.yml

```yaml tops: noPermission: "&cNo tienes permisos para usar este comando." noRanking: "&6Sin clasificar" noTop: "&6Sin registro" hologram: daily: "&6&l[Diario] &7[Semanal] [Mensual] [Permanente]" weekly: "&7[Diario] &6&l[Semanal] &7[Mensual] [Permanente]" monthly: "&7[Diario] &7[Semanal] &6&l[Mensual] &7[Permanente]" permanent: "&7[Diario] &7[Semanal] &7[Mensual] &6&l[Permanente]" daily: "Diario" weekly: "Semanal" monthly: "Mensual" permanent: "Permanente" invalidTimeType: "&cEl tiempo de top no es válido." toggleWait: "&cPor favor espera un poco para cambiar el tiempo de top." toggleTime: "&fAhora el tiempo de top es: &e" tops: |- &d &a TOPS &d &f &d &b topLine: "&b#<#> &8- &f &8- &e" ```

![Leaderboard Image](https://i.imgur.com/u8efQgL.png) **TimeType:** daily/weekly/monthly/permanent - **/xlb gettop ** » Gets the top of the day, week, month, or permanent. - **/xlb forceupdate ** » Forces the update of the top. ![Permission Image](https://i.imgur.com/LJmO1V8.png) - **xleaderboards.forceupdate** » Forces the update of the top. - **xleaderboards.gettop** » Gets the top of the day, week, month, or permanent. ![Top Name Image](https://i.imgur.com/7hKZxQf.png) **TopName:** - **name** - This is established in the `config.yml` key. For example, in `tops.coins`, "coins" is the name of the top. **TimeType:** - **daily** – Displays the top player or value for the last 24 hours. - **weekly** – Displays the top player or value for the last 7 days. - **monthly** – Displays the top player or value for the last 30 days. - **permanent** – Displays the top player or value permanently. **ValueType:** - **top_name** – Displays the player's name at this top index position. - **top_value** – Displays the value at this top index position. - **top_uuid** – Displays the player's UUID at this top index position. **Index:** - **min** – The minimum index is 1. - **max** – The maximum index is the one established in the config under `cached-top-entries`. %xleaderboard_top_;;;%

Examples

```yaml %xleaderboard_top_coins;daily;top_name;1% %xleaderboard_top_coins;weekly;top_name;2% %xleaderboard_top_coins;monthly;top_name;3% %xleaderboard_top_coins;permanent;top_name;4% %xleaderboard_top_coins;daily;top_value;1% %xleaderboard_top_coins;weekly;top_value;2% %xleaderboard_top_coins;monthly;top_value;3% %xleaderboard_top_coins;permanent;top_value;4% ```

%xleaderboard_ranking__%

Examples

```yaml %xleaderboard_ranking_daily_coins% %xleaderboard_ranking_weekly_coins% %xleaderboard_ranking_monthly_coins% %xleaderboard_ranking_permanent_coins% ```

%xleaderboard_amount__%

Examples

```yaml %xleaderboard_amount_daily_coins% %xleaderboard_amount_weekly_coins% %xleaderboard_amount_monthly_coins% %xleaderboard_amount_permanent_coins% ```

![Image 1](https://i.imgur.com/5BuQrcI.png) ![Image](https://i.imgur.com/cw5ZvjC.png) ![Image](https://i.imgur.com/9QEl0JA.png) ![Image 2](https://i.imgur.com/21fOiFQ.png) ![Image 3](https://i.imgur.com/tHNHWtI.png) ![Image 4](https://i.imgur.com/sYiYHJE.png) ![Image 5](https://i.imgur.com/aTDUKoQ.png) ![Image 6](https://i.imgur.com/3fNNuRr.png)

More Images

![Image 7](https://i.imgur.com/AX2Q14W.png) ![Image 8](https://i.imgur.com/L5jQQxc.png) ![Image 9](https://i.imgur.com/Aw6vmxy.png) ![Image 10](https://i.imgur.com/fOk6VHJ.png) ![Image 11](https://i.imgur.com/119SaNu.png) ![Image 12](https://i.imgur.com/FJcUmLk.png) ![Image 13](https://i.imgur.com/JCdX03w.png) ![Image 14](https://i.imgur.com/DqejNEX.png)

XLeaderboards

XLeaderboards 0.0.2

XLeaderboards 1.0.0

External resources

Project members

Technical information