Enhanced BalTop - 高级余额排行榜

EnhancedBalTop 是一个功能强大且高度可定制的插件，它完全取代了 Essentials 的 /baltop 命令，并支持创建全息余额排行榜。它提供了丰富的配置选项和命令，让服务器管理财富排名变得直观而灵活。

💡基本信息

• 测试版本: CraftBukkit/Spigot 1.7 - 1.12
• 核心功能: 可定制的文本与全息余额排行榜
• 前置需求: Vault (经济与权限)

🎮命令列表

主要命令

• /baltop [<pageno>]

显示基于文本的余额排行榜，每次一页。可选参数 <pageno> 用于指定页码。

• 可执行者: 控制台/玩家

文本排行榜设置

• /baltop topnbal <numberofplayers>

设置文本排行榜显示的玩家总数。每页显示玩家数可在配置文件中修改。执行后排行榜将重置到第一页。

• 可执行者: 控制台/玩家

玩家排除列表管理

• /baltop exclude list

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

• 可执行者: 控制台/玩家
• /baltop exclude add <playername>|<playeruuid>

将指定玩家名或 UUID 添加到永久排除列表并写入配置文件。

• 可执行者: 控制台/玩家
• /baltop exclude remove <playername>|<playeruuid>

将指定玩家名或 UUID 从永久排除列表中移除并更新配置文件。

• 可执行者: 控制台/玩家

全息排行榜设置

• /baltop holotopn <numberofplayers>

设置创建新全息排行榜时默认显示的玩家总数。

• 可执行者: 控制台/玩家
• /baltop hologram list

列出已存在的全息排行榜详情，包括位置（世界/坐标）、更新间隔和使用的模板文件。

• 可执行者: 控制台/玩家
• /baltop hologram movehere <hologramname>

将指定的全息排行榜移动到玩家当前位置。

• 可执行者: 玩家
• /baltop hologram add <hologram_name> [interval] [board_filename]

在玩家当前位置创建一个永久的全息余额排行榜。可选的 [interval] 参数指定更新间隔（秒），默认为30秒。可选的 [board_filename] 参数指定使用的模板文件，默认为 default.yml。

• 可执行者: 玩家
• /baltop hologram remove <hologramname>

移除指定名称的全息排行榜。

• 可执行者: 控制台/玩家
• /baltop hologram topn <hologram_name> <top_n_players>

为指定的全息排行榜设置显示的玩家数量。

插件管理

• /baltop reload

重载插件和配置文件。此操作不会禁用或移除任何已存在的全息排行榜。

✨依赖项

• 必需插件:
• Vault (用于经济和权限)
• 链接: http://dev.bukkit.org/bukkit-plugins/vault/
• 可选插件:
• Holographic Displays (用于全息显示)
• 链接: http://dev.bukkit.org/bukkit-plugins/holographic-displays/
• PlaceholderAPI (用于外部插件变量)
• 链接: https://www.spigotmc.org/resources/placeholderapi.6245/

🔧配置文件详解 (`config.yml`)

以下是对关键配置选项的说明

基本设置

• displayuuid: 仅在命令中显示玩家UUID。若要在文本排行榜中禁用UUID显示，需从配置中移除 - '&6{lineno}: UUID: &a{uuid}' 行。
• cmdaliases: 添加命令别名，会覆盖现有命令。例如，设置 'ebaltop' 将覆盖 Essentials 的 ebaltop 命令。
• deftopn: 设置文本排行榜显示的玩家总数。
• pagesize: 设置每页显示的玩家数量。不建议设置过高，以免输出过长。
• excludepermnode: 自定义权限节点，用于通过权限插件排除玩家，作为 /baltop exclude 命令的补充。
• usemoneydenominations: 设为 true 时，余额将使用 K, M, B, T 等单位缩写。
• decimalplaces: 设置余额显示的小数位数。
• dateformat: 设置 {date} 变量的日期格式。
• excludeddays: 设置排除多少天未登录的玩家余额。设为 0 可禁用此功能。
• placeholderempty: 当 PlaceholderAPI 变量返回空或无法解析时显示的字符串。

全息排行榜设置

• holotopn: 设置全息排行榜显示的玩家总数。
• holopagesize: 设置全息排行榜每页显示的玩家数量。
• holoupdateinterval: 设置全息排行榜的更新间隔（秒）。

显示模板

• 页眉与页脚: 支持多行配置，可使用 {icon:xx} 变量显示全息图标。
• 详情行: 用于显示玩家名和余额，支持多行配置。
• 所有文本均支持使用 & 符号的颜色和格式代码。

⭐可用变量

版本 1.0+ 可用变量

• {servername} - 服务器名称
• {pageno} - 当前页码
• {totalpages} - 总页数
• {player} - 玩家游戏名
• {playerpadr} - 填充至16字符长度的玩家名
• {date} - 当前日期/时间

版本 1.3+ 新增变量

• {uuid} - 玩家UUID
• {totalonlineplayers} - 当前在线玩家数
• {totalofflineplayers} - 所有曾登录的离线玩家数（包含在线玩家）
• {maxbalvalue} / {minbalvalue} - 最高/最低玩家余额
• {maxbalplayer} / {minbalplayer} - 拥有最高/最低余额的玩家名
• {servertotal} / {serverbaltotalfmt} - 所有玩家余额总和（使用单位缩写）
• {serverbaltotal} - 所有玩家余额总和（不使用单位缩写）
• {maxplayerbalvaluefmt} / {minplayerbalvaluefmt} - 最高/最低余额玩家名（使用单位缩写）
• {maxplayerbalvalue} / {minplayerbalvalue} - 最高/最低余额玩家名（不使用单位缩写）

图标变量（仅页眉页脚）

• {icon:<materialname>} - 显示指定的材质图标。<materialname> 为标准 CraftBukkit 材质名。

❓权限节点

版本 1.0 - 1.4.1

需先添加根权限 EnhancedBalTop.baltop，然后添加以下子权限：

• EnhancedBalTop.baltop.baltop - 允许使用 /baltop 命令（玩家级）
• EnhancedBalTop.baltop.exclude - 允许使用 /baltop exclude 相关命令（管理级）
• EnhancedBalTop.baltop.hologram - 允许使用所有 /baltop hologram 相关命令（管理级）
• EnhancedBalTop.baltop.holotopn - 允许使用 /baltop holotopn 命令（管理级）
• EnhancedBalTop.baltop.topnbal - 允许使用 /baltop topnbal 命令（管理级）
• EnhancedBalTop.baltop.admin - 允许使用所有管理命令（管理级）

版本 1.4.5+

权限节点简化，可直接使用

• EnhancedBalTop.baltop
• EnhancedBalTop.exclude
• EnhancedBalTop.hologram
• EnhancedBalTop.holotopn
• EnhancedBalTop.topnbal
• EnhancedBalTop.admin

注意: 玩家也可以通过配置文件中 excludepermnode 定义的权限节点被排除。

🔧未来计划

开发者考虑在高级版本中添加以下功能

• 数据库支持 (SQLite/MySQL)
• 独立且可定制的全息排行榜
• 用于动态添加文本/全息排行榜页眉、页脚和详情行的命令
• 外部插件 Placeholder 变量支持

欢迎提供宝贵的反馈和建议。如果您喜欢这个插件，请考虑通过 Spigot 页面捐赠以支持开发者。