XLeaderboards

插件

· 作者 InsiderAnh

此插件专为寻求快速高效的排行榜系统的用户而设计。

0 本站下载 0 关注 更新于 1 周前

最新 1.4.1 · 26.3 · Bukkit / Folia

一键开服(送7天)

本插件专为寻求快速高效排行榜系统的用户设计,支持基于时间的排名,包括每日、每周、每月和永久排行榜。所有内容均通过占位符处理,无需依赖 NPC 或菜单。其核心优势在于设置时间排行榜极为简便——这是少数插件真正擅长的领域。

功能特性

  • 核心完全重构: XLeaderBoards 经过重新设计,同时支持 SQLite 和 MySQL,使插件能够轻松且高效地扩展以处理海量数据。
  • 性能提升: 已成功测试超过 200 万条真实记录,能够在不到一分钟的时间内完成更新。
  • 定时排行榜: 高效的排名系统,全面支持每日、每周、每月和永久排行榜。
  • 易于设置: 仅使用占位符即可轻松创建和配置排行榜。
  • 无限可能: 得益于基于占位符的逻辑,您可以为任何插件创建排行榜——即使该插件缺乏原生支持。XLeaderBoards 会自动处理数字格式化和比较。
  • 玩家排名: 显示每位玩家在各类排行榜(每日、每周等)中的位置,并内置占位符支持。
  • 命令改进: 新增了自动补全和**/reload**命令等功能,便于管理。
  • 优化调整: 写入频率、数据限制和时间间隔均可完全自定义,以适应您服务器的容量和活跃度。
  • 支持所有版本: 包含对 1.21.4 至 1.21.8 的支持。尽管 XLeaderBoards 不依赖 NMS(非 Minecraft 服务端代码),但包含了针对特定版本变化的兼容性逻辑。
  • Folia 支持: 随着 Folia 成为现代 Minecraft 服务器的性能标准,XLeaderBoards 现在完全支持它——就像 StellarProtect 一样。
  • Top 奖励: 您可以为每日排行榜中的玩家设置奖励。
  • 需要更多功能? 加入我们的 Discord 并提出新功能建议。我们积极倾听社区反馈!

如何开始使用

  1. 下载并安装插件。
    默认情况下,插件开箱即用支持 SQLite 和 MySQL。

  2. 启动服务器。
    生成插件文件夹后,根据您选择的数据库引擎配置数据库凭据。

  3. 设置您的排行榜。
    使用您选择的占位符创建自定义排行榜。

  4. 与 DecentHolograms 或您喜欢的其他插件集成。
    确保您选择的插件支持 PlaceholderAPI,并按照下面提供的示例配置进行操作。

  5. 参考占位符部分。
    所有可用的占位符格式均在专门的部分中列出。

DecentHolograms 示例配置
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(财富与他们融为一体)'
    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► &f你的位置:#FBF727#%xleaderboard_ranking_weekly_coins% &8- #FBF727%xleaderboard_amount_weekly_coins%
      #FAFF2E⛃ &8◄'
    height: 0.3
  - content: '&r'
    height: 0.3
  - content: '&7[每日] #F4F149&l[每周] &7[每月] [永久]'
    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(财富与他们合为一体)'
    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► &f你的排名: #FBF727#%xleaderboard_ranking_monthly_coins% &8- #FBF727%xleaderboard_amount_monthly_coins%
      #FAFF2E⛃ &8◄'
    height: 0.3
  - content: '&r'
    height: 0.3
  - content: '&7[每日] [每周] #F4F149&l[每月] &7[永久]'
    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(财富与他们合二为一)'
    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► &f你的排名:#FBF727#%xleaderboard_ranking_permanent_coins% &8- #FBF727%xleaderboard_amount_permanent_coins%
      #FAFF2E⛃ &8◄'
    height: 0.3
  - content: '&r'
    height: 0.3
  - content: '&7[每日] [每周] [每月] #F4F149&l[永久]'
    height: 0.3
  actions:
    LEFT:
    - PREV_PAGE:tops_DINERO
    - SOUND:UI_BUTTON_CLICK:0.7:2.7
config.yml
tops:
  kills:
     ## 此占位符用于解析以获取当前排行榜计数。
    placeholder: "%statistic_player_kills%"
    name: "击杀数"
databaseId: survival_top
debug: false
optimizations:
   ## MongoDB 的最大批量大小,如果玩家数量较多,可以增加此值,
  ## 但请注意内存使用情况。
  max-bulk-size: 1000
  ## 服务器加载到内存中的最大缓存顶部条目数。
  cached-top-entries: 10
  ## 如果玩家数量较多,可以增加此值。
  ticks-between-updates: 600
  ## 重置临时值的最大批量大小,此值较小
  ## 你可以增加此值,但请注意内存使用情况。
  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
tops:
  noPermission: "&c你没有权限使用此命令。"
  noRanking: "&6未排名"
  noTop: "&6无记录"
  loading: "&f加载中..."
  hologram:
    daily: "&6&l[每日] &7[每周] [每月] [永久]"
    weekly: "&7[每日] &6&l[每周] &7[每月] [永久]"
    monthly: "&7[每日] &7[每周] &6&l[每月] &7[永久]"
    permanent: "&7[每日] &7[每周] &7[每月] &6&l[永久]"
  daily: "每日"
  weekly: "每周"
  monthly: "每月"
  permanent: "永久"
  invalidTimeType: "&c排行榜时间类型无效。"
  toggleWait: "&c请等待片刻再更改排行榜时间。"
  toggleTime: "&f当前排行榜时间为:&e<timeType>"
  tops: |-
    &d     &a
    <center>&6&l<name> TOPS
    &d     &f
    <tops>
    &d     &b
  topLine: "&b#<#> &8- &f<name> &8- &e<value>"
rewards.yml
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: &7你因保持在榜首而获得了一把钻石剑!"
        - "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: &7你因保持在榜首而获得了一把铁剑!"
        - "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: &7你因保持在榜首而获得了一把石剑!"
        - "message: &7   &a"

TimeType: daily/weekly/monthly/permanent

  • /xlb gettop <timeType> <topKey> » 获取每日、每周、每月或永久的排行榜。

  • /xlb forceupdate <timeType> » 强制更新排行榜。

  • xleaderboards.forceupdate » 强制更新排行榜。

  • xleaderboards.gettop » 获取每日、每周、每月或永久的排行榜。

TopName:

  • name - 这是在 config.yml 键中设置的名称。例如,在 tops.coins 中,“coins” 是排行榜的名称。

TimeType:

  • daily – 显示过去 24 小时内的最高玩家或数值。
  • weekly – 显示过去 7 天内的最高玩家或数值。
  • monthly – 显示过去 30 天内的最高玩家或数值。
  • permanent – 永久显示最高玩家或数值。

ValueType:

  • top_name – 显示该排行榜索引位置的玩家名称。
  • top_value – 显示该排行榜索引位置的数值。
  • top_uuid – 显示该排行榜索引位置的玩家 UUID。

Index:

  • min – 最小索引为 1。
  • max – 最大索引是在配置文件中 cached-top-entries 下设置的值。

%xleaderboard_top_<topName>;<timeType>;<valueType>;<index>%

示例
%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>%

示例
%xleaderboard_ranking_daily_coins%
%xleaderboard_ranking_weekly_coins%
%xleaderboard_ranking_monthly_coins%
%xleaderboard_ranking_permanent_coins%

%xleaderboard_amount_<timeType>_<topName>%

示例
%xleaderboard_amount_daily_coins%
%xleaderboard_amount_weekly_coins%
%xleaderboard_amount_monthly_coins%
%xleaderboard_amount_permanent_coins%

%xleaderboard_update_cooldown_<timeType>%

示例
%xleaderboard_update_cooldown_daily%
%xleaderboard_update_cooldown_weekly%
%xleaderboard_update_cooldown_monthly%
%xleaderboard_update_cooldown_permanent%

%xleaderboard_reset_cooldown_<timeType>%

示例
%xleaderboard_reset_cooldown_daily%
%xleaderboard_reset_cooldown_weekly%
%xleaderboard_reset_cooldown_monthly%
更多图片

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源