Heads Leaderboards - 玩家头颅排行榜

Heads Leaderboards 是一款用于在 Minecraft 服务器中创建带有头颅的排行榜告示牌的插件。它可以从 MySQL 数据库或多种平面文件（如 JSON、YML 或 SQLite 数据库）中读取数据，并将统计信息（如击杀数、胜场等）动态显示在游戏内的告示牌和头颅上。

💡版本 4.0 更新内容

本次更新带来了重大变化，但仍与旧版排行榜保持兼容。

• 配置文件重组：原有的 leaderboard.yml 文件已被移除，替换为 Leaderboards 目录。现在，每个排行榜都拥有自己独立的配置文件。
• 数据库按榜配置：新增 Database 配置项，允许您为不同的排行榜连接不同的数据库。
• UUID 支持：新增 usingUUID 配置项。设置为 true 时，插件将使用 UUID 列并从 Mojang 获取玩家名称。
• 多数据显示：新增 multiStat 配置项。启用并配置后，可以在一个排行榜上同时显示两项统计数据（例如同时显示“击杀”和“死亡”），但排序仍依据第一项数据。

❓插件功能

本插件不追踪任何玩家数据，仅用于展示已存储的数据。

• 创建带有玩家头颅的告示牌排行榜。
• 数据源支持：

- MySQL 数据库。

- 平面文件存储（FFS），支持 JSON 和 YML 格式，可按 UUID 或玩家名存储。

- SQLite 数据库文件（例如与 ScoreboardStats 插件兼容）。

🔧安装与设置

安装步骤

• 将插件 Jar 文件放入服务器的 plugins 目录。
• 启动服务器以生成配置文件。
• 编辑生成的 config.yml 或使用 /hlb setup 命令输入 MySQL 数据库信息。
• 使用 /hlb enable 命令或在配置文件中启用插件。

创建排行榜

• 使用命令创建排行榜：/hlb create <排行榜名称> <类型>，类型为 sql (MySQL) 或 ffs (平面文件)。
• 在 Leaderboards 目录下找到对应的配置文件进行编辑，或使用 /hlb setup <排行榜名称> 进行向导设置。
• 使用 /hlb enable <排行榜名称> 启用该排行榜。
• 在游戏中放置告示牌和头颅。

🎮命令列表

• /hlb setup - 启动设置向导，配置数据库信息。
• /hlb enable - 启用或禁用整个插件。
• /hlb create <leaderboard> <sql|ffs> - 创建一个新的排行榜。
• /hlb delete <leaderboard> - 删除指定的排行榜。
• /hlb list - 列出所有已创建的排行榜。
• /hlb setup <leaderboard> - 为指定排行榜启动设置向导。
• /hlb enable <leaderboard> - 启用或禁用指定的排行榜。
• /hlb reload - 重载插件配置文件。
• /hlbupdate - 更新所有已启用的排行榜（立即刷新告示牌）。

✨权限节点

• hlb.commands - 允许使用除 /hlbupdate 外的所有 HLB 命令。
• hlb.signs - 允许玩家创建和销毁 HLB 告示牌。
• hlb.update - 允许使用 /hlbupdate 命令。

⭐配置示例

MySQL 排行榜配置示例 (kills_pve)

kills_pve:
  enabled: true
  statTable: statskill
  statName: amount
  statDisplay: Kills
  nameColumn: player_id
  hlbSize: 5
  line0Format: red, bold, name
  line3Format: dark blue, bold, stat

平面文件 (FFS) 排行榜配置示例 (PVPKills)

PVPKills:
  enabled: true
  filePath: \world\stats\
  usingUUID: true
  statName: stat.playerKills
  statDisplay: PVP Kills

SQLite 平面文件排行榜配置示例 (mob_kills)

mob_kills:
  enabled: true
  statTable: player_stats
  statName: mobkills
  flatFileDB:
    enabled: true
    flatFilePath: \plugins\scoreboardstats\scoreboardstats.db

🔧创建告示牌

• 放置一个告示牌。
• 在第一行输入 [hlb]。
• 在第二行输入 <排行榜名称>。
• 在第三行输入要显示的排名位置（例如 1, 2, 3）。
• （可选）在告示牌上方或告示牌依附的方块上放置一个头颅。
• 执行 /hlbupdate 或等待下一次自动更新。

✨告示牌颜色代码

在配置文件的 lineXFormat 中，您可以使用颜色名称或 Minecraft 颜色代码（不要使用 & 符号）。

• black (0)
• dark blue (1)
• dark green (2)
• dark aqua (3)
• dark red (4)
• dark purple (5)
• gold (6)
• gray (7)
• dark gray (8)
• blue (9)
• green (a)
• aqua (b)
• red (c)
• light purple (d)
• yellow (e)
• white (f)

⭐其他信息

• 插件统计 (Metrics)：本插件使用 Metrics 来收集匿名使用数据，以帮助开发者了解插件使用情况。您可以在插件生成的 Metrics 配置文件中将 opt-out 设置为 true 来退出。
• GitHub：您可以在 GitHub 上找到本插件的源代码。
• 支持开发者：如果您非常喜欢这个插件，可以考虑支持开发者。