XLeaderboards | A simple plugin for make tops

XLeaderboards | A simple plugin for make tops | MongoDB -----

This plugin is designed for users seeking a fast and efficient leaderboard system.

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.

REQUIRED MONGODB

Improved Performance: xLeaderboards has been tested with over 2 million real records and is capable of updating them in just one minute.
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.

Download and install the plugin.
MongoDB is a mandatory requirement, and the plugin will not work without it.
Start your server.
Once the plugin folder is generated, configure your MongoDB credentials.
Set up your tops.
Use the placeholders of your choice to create customized tops.
Integrate with DecentHolograms or your preferred plugin.
Ensure that the plugin supports PlaceholderAPI, and follow the example configuration provided below.
Refer to the placeholders section.
All available formats for placeholders are listed in the dedicated section.

Code (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

Code (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

Code (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<timeType>"
tops : |-
&d &a
<center><name> TOPS
&d &f
<tops >
&d &b
topLine : "&b#<#> &8- &f<name> &8- &e<value>"

TimeType: daily/weekly/monthly/permanent

/xlb gettop <timeType> <topKey> » Gets the top of the day, week, month or permanent.
/xlb forceupdate <timeType> » Forces the update of the top.

xleaderboards.forceupdate » Forces the update of the top.
xleaderboards.gettop » Gets the top of the day, week, month or permanent.

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_<topName>;<timeType>;<valueType>;<index>%

Code (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_<timeType>_<topName>%

Code (YAML):

%xleaderboard_ranking_daily_coins%
%xleaderboard_ranking_weekly_coins%
%xleaderboard_ranking_monthly_coins%
%xleaderboard_ranking_permanent_coins%

%xleaderboard_amount_<timeType>_<topName>%

Code (YAML):

%xleaderboard_amount_daily_coins%
%xleaderboard_amount_weekly_coins%
%xleaderboard_amount_monthly_coins%
%xleaderboard_amount_permanent_coins%