📊 Heads Leaderboards

Heads Leaderboards 是一款允许你使用 MySQL 数据库或 Flat File Storage 中的数据创建带有玩家头颅的排行榜的插件。请注意，此插件本身不跟踪任何玩家数据，仅用于展示存储在数据库中的数据，例如击杀数、胜场等。

🆕 版本 4.0 更新

此更新对 Heads Leaderboards 进行了重大更改，但仍与旧的排行榜兼容！主要变化包括：

• leaderboard.yml 文件已被移除，取而代之的是一个 Leaderboards 目录，每个排行榜都有一个单独的文件。
• 针对 MySQL 排行榜，新增了许多选项，例如：
  • 每个排行榜现在都可以指定不同的数据库。
  • 可以使用 UUID 列代替玩家名称，插件会自动从 Mojang 获取玩家名称。
  • 启用 multiStat 后，可以在一个排行榜上显示两个统计数据，例如 PvP 排行榜同时显示击杀数和死亡数。

💾 Flat File Storage 支持

Heads Leaderboards 现在支持 Flat File Storage，包括 JSON、YML 和 SQLite 数据库。无需 MySQL 即可使用。使用 SQLite 数据库时，需要启用 flatFileDB 并在配置文件中设置数据库文件路径。

注意：使用 .db 文件时，需要知道表名和列名，可以使用 SQLite DB Browser 来查找。

🛠️ 安装

1. 将 Jar 文件复制到 plugins 目录。
2. 编辑创建的 config 或使用 Setup 命令输入 MySQL 数据库的所需信息。
3. 使用 Enable 命令或更新 config 来启用插件。
4. 创建排行榜。
5. 编辑 leaderboards.yml 或使用 Setup 命令输入排行榜的所需信息。
6. 使用 Enable 命令启用排行榜。
7. 创建排行榜标志，并在上方放置头颅。

📝 示例配置

MySQL 排行榜示例 (来自 Lolmewn 的 "Stats" 插件的 Enemy Kills)

kills_pve:
  enabled: true
  separateNameTable:
    enabled: true
    nameTable: statsplayers
    sepNameCol: name
    sepIdCol: player_id
  sortByWorld:
    enabled: false
    worldCol: world
    worldName: world
  customColumn:
    enabled: true
    customCol: type
    rowValues: Skeleton, Creeper, Spider, Zombie, Ghast, Slime, Pig_zombie, Cave_spider, Silverfish, Enderman, Blaze, Magma_cube, Witch, Endermite, Guardian
  customColumn2:
    enabled: false
    customCol: customCol
    rowValues: rowValues
  statTable: statskill
  statName: amount
  statDisplay: Kills
  nameColumn: player_id
  hlbSize: 5
  reverseOrder: false
  statOnSameLine: true
  line0Format: red, bold, name
  line1Format: pink, magic, custom, sdfasdsafdsfadsdfd
  line2Format: pink, magic, custom, sdfasdsafdsfadsdfd
  line3Format: dark blue, bold, stat

Flat File Storage 排行榜示例

PVPKills:
  enabled: true
  filePath: \world\stats\
  usingUUID: true
  statName: stat.playerKills
  statDisplay: PVP Kills
  hlbSize: 5
  reverseOrder: false
  statOnSameLine: false
  line0Format: black, bold, header
  line1Format: dark blue, normal, name
  line2Format: dark red, bold, statdisplay
  line3Format: dark purple, bold, stat

SQLite Flat File Storage 排行榜示例

mob_kills:
  enabled: true
  separateNameTable:
    enabled: false
    nameTable: player_stats
    sepNameCol: name
    sepIdCol: player_id
  sortByWorld:
    enabled: false
    worldCol: world
    worldName: world
  customColumn:
    enabled: false
    customCol: type
    rowValues: values
  customColumn2:
    enabled: false
    customCol: customCol
    rowValues: rowValues
  statTable: player_stats
  statName: mobkills
  statDisplay: Mob Kills
  nameColumn: playername
  hlbSize: 5
  reverseOrder: false
  statOnSameLine: false
  line0Format: black, bold, header
  line1Format: dark blue, normal, name
  line2Format: dark red, bold, statdisplay
  line3Format: dark purple, bold, stat
  flatFileDB:
    enabled: true
    flatFilePath: \plugins\scoreboardstats\scoreboardstats.db

⌨️ 命令

• /hlb setup - 启动设置实用程序，在 Config.yml 中输入数据库信息。
• /hlb enable - 启用或禁用插件。
• /hlb create <leaderboard> <leaderboard type> - 创建一个名为 <leaderboard> 的新排行榜。类型必须为 "sql"（MySQL）或 "ffs"（Flat File Storage）。
• /hlb delete <leaderboard> - 删除名为 <leaderboard> 的排行榜。
• /hlb list - 列出所有已创建的排行榜。
• /hlb setup <leaderboard> - 启动所选排行榜的设置实用程序。
• /hlb enable <leaderboard> - 启用或禁用所选排行榜。
• /hlb reload - 重新加载插件配置文件。
• /hlbupdate - 更新所有已启用的排行榜。

🔑 权限

• hlb.commands - 允许用户使用除 hlb.update 之外的所有 hlb 命令。
• hlb.signs - 允许用户创建和破坏 HLB 标志。
• hlb.update - 允许用户使用 /hlbupdate 命令。

🌈 标志颜色代码

可以使用 "颜色名称" 或 "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)

🪧 HLB 标志

放置一个标志，在第一行输入 [hlb]，在第二行输入 <排行榜名称>，在第三行输入要显示在标志上的位置。可选：在标志上方放置一个头颅（直接在上方或在标志所在的方块顶部）。运行 /hlbupdate 或等待排行榜更新！

📊 插件指标

此插件现在使用 Metrics。这将有助于我跟踪有多少服务器正在使用该插件。要退出指标，请在插件目录中的 metrics config 中将 opt-out: 设置为 true。

🌍 GitHub

插件的 GitHub 仓库。