EnhancedBalTop 是一款完全可定制的 /baltop 命令替代插件，它在 Essentials 的基础上进行了增强，并支持全息排行榜显示（需要 Holographic Displays 插件）。支持 Minecraft 版本 1.7 - 1.12。

---

🎮 命令

• /baltop [<pageno>]

  显示基于文本的财富排行榜，一次显示一页。可以通过可选参数 <pageno> 指定页码。

  可由：控制台/玩家 执行

• /baltop topnbal <numberofplayers>

  设置基于文本的财富排行榜显示前 N 名玩家的余额，一次显示一页。页面默认显示 10 名玩家，但可以在配置文件中更改。

  财富排行榜会立即重置到第 1 页。

  可由：控制台/玩家 执行

• /baltop exclude list

  列出添加到配置文件中永久排除列表的玩家。如果 config.yml 中的 displayuuid 设置为 true|yes，则会显示玩家的 UUID。

  可由：控制台/玩家 执行

• /baltop exclude add <playername>|<playeruuid>

  将玩家 <playername> 或 <playeruuid> 添加到永久排除列表，并添加到配置文件中。

  可由：控制台/玩家 执行

• /baltop exclude remove <playername>|<playeruuid>

  从永久排除列表中移除玩家 <playername> 或 <playeruuid>，并从配置文件中移除。

  可由：控制台/玩家 执行

• /baltop holotopn <numberofplayers>

  设置创建新的全息显示板时最初使用的默认 TopN 值为 <numerofplayers>。

  可由：控制台/玩家 执行

• /baltop hologram list

  列出已有的全息财富排行榜的详细信息，包括它们的位置（世界/XYZ 坐标）、更新间隔和使用的模板文件名。

  可由：控制台/玩家 执行

• /baltop hologram movehere <hologramname>

  将全息图 <hologramname> 移动/重新定位到玩家的当前位置。

  可由：玩家 执行

• /baltop hologram add <hologram_name> [interval] [board_filename]

  在玩家的当前位置创建一个永久全息财富排行榜 <hologramname>。

  您可以选择性地指定更新频率（秒），如果省略，则使用默认间隔 30 秒。

  您还可以选择指定用于创建全息图的余额排行榜模板文件，如果省略此参数，则使用 default.yml。

  可由：玩家 执行

• /baltop hologram remove <hologramname>

  从当前位置移除全息财富排行榜 <hologramname>。

  可由：控制台/玩家 执行

• /baltop hologram topn <hologram_name> <top_n_players>

  设置全息余额排行榜 <hologram_name> 的前 N 名玩家为 <top_n_players>。

• /baltop reload

  重新加载插件和配置文件 - 这不会禁用/移除任何现有的全息财富排行榜。

---

🧱 依赖

• 必需:

  • Vault (用于经济和权限)

• 可选:

  • Holographic Displays (用于全息显示)
  • Clip's PlaceholderAPI (用于外部插件占位符变量)

---

⚙️ config.yml

enable: true
checkupdates: true
displayuuid: true
cmdaliases:
- 'ebaltop'
- 'ebt'
- 'bt'
deftopn: 100
pagesize: 10
excludepermnode: EnhancedBalTop.baltop.excludeplayer
usemoneydenominations: true
decimalplaces: 2
dateformat: dd-MM-yyyy HH:mm
excludedays: 30
placeholderempty: ''
header:
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '&e{servername} &f{date}'
- '&6Top &a{topnbal} &6Balances For Last &a{excludedays}&6 days'
- '&6High Bal: &e{maxbalplayer}&e - &a$&f{maxbalvalue}'
- '&6Low Bal: &e{minbalplayer}&e - &a$&f{minbalvalue}'
- '&6Offline Players: &a{totalofflineplayers}&6, Online Players: &a{totalonlineplayers}'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
detail:
- '&6{lineno}: &f&l{player} &6has &a$&f{balance}'
- '&6{lineno}: UUID: &a{uuid}'
footer:
- '&e---- Page &6{pageno} &eOf &6{totalpages} &e----'
holotopn: 100
holopagesize: 10
holoupdateinterval: 30
holoheader:
- '{icon:DIAMOND}'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '&e{servername} &f{date}'
- '&6Top &f{topnbal} &6Balances For Last &a{excludedays}'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
holodetail:
- '&6{lineno}: &f&l{player} &6has &a$&f{balance}'
holofooter:
- '&e---- Page &6{pageno} &eOf &6{totalpages} &e----'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '&6Enhanced&eBalTop &f(C) 2016 &1&lL&2&lO&3&l&lZ&4&lZ&c&lSoft'
- '&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e=&6-&e='
- '{icon:DIAMOND}'
excludedplayers: []

config.yml 说明:

以下是一些不太明显的配置选项的说明：

• displayuuid: 启用显示玩家 UUID，仅用于 /baltop exclude.... 等命令。如果使用默认配置，UUID 将通过 /baltop 命令显示在基于文本的余额排行榜中。要禁用此功能，请从 config.yml 中删除以下行：

  - '&6{lineno}: UUID: &a{uuid}'

• cmdaliases: 添加多个命令别名（如果选择已存在的命令别名，这些别名应覆盖任何现有命令）。例如，'ebaltop' 将覆盖 Essentials 的 ebaltop 命令，并运行 /baltop 命令！

• deftopn: 设置基于文本的 /baltop 余额排行榜显示的玩家余额总数。

• pagesize: 设置每页列出的玩家数量。不要将此值设置得太高，否则文本输出将在长玩家列表（如果由 deftopn 设置）中滚动！

• excludepermnode: 除了基于 /baltop exclude 的命令外，还用于排除玩家的自定义权限节点。这适用于 Vault 权限支持的大多数权限插件（PEX、bPermissions、GroupManager 等）。

• usemoneydenominations: 如果设置为 true，余额将使用以下单位/符号：K、M、B、T、Q、QT、S、SP。设置为 false 以禁用并使用普通符号。

• decimalplaces: 设置余额/货币值四舍五入到的小数位数。例如，默认值为 2：如果玩家的余额为 100.268 美元，将显示为 100.27 美元。

• dateformat: 用于在 config 文件中包含 {date} 变量的 header/footer/detail 配置行的标准 Java 日期格式。

• excludedays: 设置排除旧玩家余额的天数（通过他们上次登录的日期/时间）。默认为 30，这意味着任何超过 30 天未登录的玩家余额将被排除。设置为 0 以禁用此功能。

• placeholderempty: 如果占位符 API 字符串（用 % 包裹，例如 %statistic_player_kills%）返回空字符串或未解析，则显示的字符串。默认为 ''。

• holotopn: 设置基于全息的 /baltop 余额排行榜显示的玩家余额总数。

• holopagesize: 设置基于全息的余额排行榜每页列出的玩家余额数量。默认为 10 名玩家。

• holoupdateinterval: 设置所有全息余额排行榜的更新间隔（秒）。如果它们跨越多个页面，它将循环显示每个页面，每次更新显示一页。

编辑相关的 Header、Detail 和 Footer 键以自定义您的基于文本的 /baltop 和全息余额排行榜。

Header & Footer (text /baltop and holograms) keys

基于文本的 /baltop 和全息余额排行榜的标头和页脚配置行可以有多行，如配置中所示。

它们还支持使用 {icon:xx} 变量的单行全息图标/项目行（按照全息显示规范）。

Detail (text /baltop and holograms) keys

多行细节行，通常用于显示玩家姓名及其相关余额。

所有颜色编码和格式化代码都支持使用 & 前缀。

---

💬 messages.yml (v1.3+ only!)

cmdprefix: "&7[&eEnh&6BalTop&7] "
hookvaultecon: "&aHooked Successfully Into &f&lVault Economy"
vaultnf: "&cDependant &f&lVault &cPlugin Not Found!"
holopluginnf: "&f&lHolographic Displays &cPlugin Not Found, Exiting"
hookvaultperm: "&aHooked Successfully Into &f&lVault Permissions (&e%0%&a)"
newversion: "&6New Version: &a%0% &6Is Available. Download from &ahttps://www.spigotmc.org/resources/enhanced-baltop.20168/"
failcheck: "&cFailed To Check For Update....."
reloadplugin: "&aReloaded Plugin"
reloadconfig: "&aReloaded Config"
#
hologramfilenf: "&cHologram File &a&%0%&e Not Found, Creating!"
hologramscr: "&6Creating Initial Holograms From &a%0%"
holocoordnf: "&cHologram: &a%0% &chas Empty &a%1% Coord. Value In &a%2%"
holocoordnv: "&cHologram: &a%0% &chas Invalid &a%1% Coord. Value In &a%2%"
#
topnbalset: "&eSet No. Player Balances To &a%0%"
holotopnset: "&eSet Hologram No. Balances To &a%0%"
excllist: "&6Excluded Players List:-"
hololist: "&6Hologram List:-"
#
getbalinfo: "&6Fetched And Sorted &a%0%&6 OffLine Player Balances"
holoinfo: "&e%0%. &6Hologram: &f%1%&e, &6World: %2%&f &6@ X: &f%3%&6, Y: &f%4%&6, Z: &f%5%"
holocrinfo: "&6Created Hologram: &f%0%&e, &6In World: %1%&f &6@ X: &f%2%&6, Y: &f%3%&6, Z: &f%4%"
holoreminfo: "&6Removed Hologram: &f%0%&e, &6From World: %1%&f &6@ X: &f%2%&6, Y: &f%3%&6, Z: &f%4%"
holomoveinfo: "&6Moved Hologram: &f%0%&e, &6To World: %1%&f &6@ X: &f%2%&6, Y: &f%3%&6, Z: &f%4%"
excllistinfo1: "&6%0%. &ePlayer: &f&l%1%"
excllistinfo2: "&6UUID: &a%0%"
excladdinfo1: "&6Added Player: &a&l%0%"
excladdinfo2: "&6UUID: &a%0%"
excladdinfo3: "&6To Excluded Players List"
exclreminfo1: "&6Removed Player: &a&l%0%"
exclreminfo2: "&6UUID: &a%0%"
exclreminfo3: "&6From Excluded Players List"
#
usage: "&6Usage: &e&l/%0% &a[pageno]"
reloadusage: "&6Usage: &e&l/%0% reload"
topnbalusage: "&6Usage: &e&l/%0% topnbal &a"
holotopnusage: "&6Usage: &e&l/%0% holotopn &a"
excllistusage: "&6Usage: &e&l/%0% exclude list"
excladdusage: "&6Usage: &e&l/%0% exclude add &a"
exclremusage: "&6Usage: &e&l/%0% exclude remove &a"
hololistusage: "&6Usage: &e&l/%0% hologram list"
holoaddusage: "&6Usage: &e&l/%0% hologram add &a"
holoremusage: "&6Usage: &e&l/%0% hologram remove &a"
holomoveusage: "&6Usage: &e&l/%0% hologram movehere &a"
#
baltopperm: "&cYou Don't Have Permission to &a/%0%&c, Exiting"
topnbalperm: "&cYou Don't Have Permission to &a/%0% topnbal&c, Exiting"
holotopnperm: "&cYou Don't Have Permission to &a/%0% holotopn&c, Exiting"
holoperm: "&cYou Don't Have Permission to &a/%0% hologram &ccommands, Exiting"
exclperm: "&cYou Don't Have Permission to &a/%0% exclude &ccommands, Exiting"
#
baltoptp: "&cIncorrect Parameters '&a%0%&c', Exiting!"
reloadtp: "&cIncorrect Parameters '&a%0%&c', Exiting!"
topnbalnp: "&cMissing Number Players Parameter, Exiting!"
topnbaltp: "&cIncorrect Parameters '&a%0%&c', Exiting!"
topnbalnv: "&cInvalid Number Players Parameter '&a%0%&c', Exiting!"
holotopnnp: "&cMissing Number Players Parameter, Exiting!"
holotopntp: "&cIncorrect Parameters '&a%0%&c', Exiting!"
holotopnnv: "&cInvalid Number Players Parameter '&a%0%&c', Exiting!"
pagenv: "&cInvalid Page Number: &a%0%&c, Exiting!"
#
exclnp: "&cMissing Parameters, Exiting!"
excltp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
excllisttp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
excladdnp: "&cMissing Player Parameter, Exiting!"
excladdtp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
excladdnf1: "&cPlayer: &a%0%&c Not Found, Exiting!"
excladdnf2: "&cUUID: &a%0%&c"
exclremnp: "&cMissing Player Parameter, Exiting!"
exclremnf1: "&cPlayer: &a%0%&c Not Excluded, Exiting!"
exclremnf2: "&cUUID: &a%0%&c"
exclremnf: "&cPlayer: &a%0%&c Not Excluded, Exiting!"
exclremtp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
#
holonp: "&cMissing Parameters, Exiting!"
holotp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
hololisttp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
holoaddtp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
holoaddae: "&cHologram: &a%0%&c Already Exists, Exiting!"
holoaddnh: "&cMissing Hologram Parameter, Exiting!"
holoaddcs: "&cCannot Run &a/%0% hologram add &cfrom Console, Exiting!"
holoremnh: "&cMissing Hologram Parameter, Exiting!"
holoremtp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
holoremnf: "&cHologram: &a%0%&c Not Found, Exiting"
holomovecs: "&cCannot Run &a/%0% hologram movehere &cfrom Console, Exiting!"
holomovetp: "&cIncorrect Parameters: '&a%0%&c', Exiting!"
holomovenh: "&cMissing Hologram Parameter, Exiting!"
holomovenf: "&cHologram: &a%0%&c Not Found, Exiting"

---

Variables:

v 1.0+ Header, Footer, Detail Line Variables:

• {servername} - 当前服务器名称.
• {pageno} - 当前页码.
• {totalpages} - 余额板使用的总页数.
• {player} - 玩家 (Minecraft) 完整用户名.
• {playerpadr} - 玩家 (Minecraft) 完整用户名，名称后填充空格，使其长度为 16 个字符.
• {date} - 当前日期/时间，按照 config.yml 中的 dateformat 格式设置.

v 1.3 + Header, Footer, Detail Line Variables:

• {uuid} - 玩家离线/在线 UUID
• {totalonlineplayers} - 当前在线玩家总数
• {totalofflineplayers} - 已登录服务器的离线玩家总数（包括在线玩家计数）
• {maxbalvalue} - 最大离线或在线玩家余额
• {minbalvalue} - 最小离线或在线玩家余额
• {maxbalplayer} - 具有最大离线或在线余额的玩家名称
• {minbalplayer} - 具有最小离线或在线余额的玩家名称
• {servertotal} 或 {serverbaltotalfmt} - 显示所有玩家余额的总和，四舍五入并使用单位面额（即 K/M/B 等）
• {serverbaltotal} - 显示所有玩家余额的总和，不使用单位面额，但四舍五入到 DecimalPlaces 配置选项定义的十进制位数.
• {maxplayerbalvaluefmt} - 显示具有最高余额的玩家姓名，四舍五入并使用单位面额.
• {maxplayerbalvalue} - 显示具有最高余额的玩家姓名，四舍五入到 DecimalPlaces 配置选项定义的十进制位数。不使用单位面额.
• {minplayerbalvaluefmt} - 显示具有最低余额的玩家姓名，四舍五入并使用单位面额.
• {minplayerbalvalue} - 显示具有最低余额的玩家姓名，四舍五入到 DecimalPlaces 配置选项定义的十进制位数。不使用单位面额.

所有版本的 Header 和 Footer 行仅支持：

• {icon: <materialname>}

其中 <materialname> 是标准的 CraftBukkit 材料名称。

有关更多信息，请参阅 https://hub.spigotmc.org/javadocs/bukkit/org/bukkit/Material.html

---

🔑 权限

(v1.0 - v1.4.1 only 添加 EnhancedBalTop.baltop, 根权限)

然后添加：

• EnhancedBalTop.baltop.baltop 或 (v1.4.5+) EnhancedBalTop.baltop - 允许访问 /baltop 命令！(player level)
• EnhancedBalTop.baltop.exclude 或 (v1.4.5+) EnhancedBalTop.exclude - 允许访问 /baltop exclude 命令 (admin level)。(注意：也可以通过 config.yml 中定义的自定义权限节点 excludepermnode，通过权限排除玩家)。
• EnhancedBalTop.baltop.hologram 或 (v1.4.5+) EnhancedBalTop.hologram - 允许访问所有 /baltop hologram ... 命令 (admin level)。
• EnhancedBalTop.baltop.holotopn 或 (v1.4.5+) EnhancedBalTop.holotopn - 允许访问 /baltop holotopn 命令 (admin level)。
• EnhancedBalTop.baltop.topnbal 或 (v1.4.5+) EnhancedBalTop.topnbal - 允许访问 /baltop topnbal 命令 (admin level)。

EnhancedBalTop.baltop.admin or (v1.4.5) EnhancedBalTop.admin Allows access to:- /baltop exclude ... /baltop topnbal ... /baltop holotopn ... /baltop hologram ... /baltop reload