/f top - Factions Top - 高效综合领地排行系统

💡简介

FactionsTop 是一款高效、全面的 Factions 领地财富排名系统插件。它实时统计并计算领地内所有方块与箱子的总价值，以此为依据对服务器上的所有派系进行财富排名。本插件完全免费且开源，旨在提供实时结果的同时保持良好的服务器性能。

🎮支持与兼容

• 支持的服务器核心：Spigot 1.7.x 至 1.12.x
• 支持的 Factions 插件：
• FactionsUUID (by drtshock)
• LegacyFactions
• FactionsOne
• MassiveCore Factions 2.7+
• 支持的数据库：H2 与 MySQL

🔧安装步骤

• 下载 FactionsTop.jar 文件。
• 将 FactionsTop.jar 放入服务器的 plugins 目录。
• 启动服务器。
• 检查服务器日志。依赖项下载完成后，您可能会看到以下信息：

    [FactionsTop] H2 forcefully loaded, a reboot may be required.

• 随后可能出现两种情况：

- 服务器正常启动，无错误。

- 出现 SQL 异常，提示驱动缺失。这可能是依赖冲突所致，只需**重启一次服务器**即可解决。

• 重启后，FactionsTop 应已成功加载。

✨命令与权限

命令列表

• /ftop - 列出所有顶级派系（财富排名）。
• /ftopgui - 使用 GUI 界面列出所有顶级派系。
• /ftoprecalculate - 重新计算所有派系的财富值。
• /ftopreload - 重载插件配置。
• /ftopversion - 查看插件版本。

权限列表

• factionstop.use - 允许使用 /ftop 命令查看排名。
• factionstop.recalculate - 允许使用 /ftoprecalculate 命令。
• factionstop.reload - 允许使用 /ftopreload 命令。
• factionstop.sign.break - 允许破坏 FactionsTop 排名告示牌。
• factionstop.sign.place - 允许放置 FactionsTop 排名告示牌。

⭐配置概览

配置文件 config.yml 结构清晰，包含详细注释。主要配置区域如下：

• config-version：配置文件版本，请勿手动修改。
• command-aliases：绑定到 /ftop 命令的其他命令别名列表。
• gui-settings：所有与图形界面（GUI）相关的设置。
• ignored-faction-ids：不计入财富排名的派系ID列表（如安全区、战争区）。
• disable-chest-events：禁用箱子事件监听以提升性能。
• factions-per-page：在 /ftop 命令中每页显示的派系数量。
• database：数据库设置，支持 H2 和 MySQL。
• enabled：开关特定类型的财富计算（如箱子、玩家余额、刷怪笼、方块）。
• spawner-prices：特定刷怪笼类型的价值。
• block-prices：特定方块类型的价值。

重要配置项说明

使用 MySQL 数据库

要使用 MySQL 或 MariaDB，只需修改配置文件中的 JDBC 连接地址：

# jdbc-url: jdbc:mysql://<ip>:<port>/<database>
jdbc-url: jdbc:mysql://127.0.0.1:3306/factionstop

更多关于 MySQL JDBC 连接的信息，请参考官方文档。

自定义物品价值

所有被计入财富的方块和刷怪笼都必须在配置文件中拥有对应的价值设定。

• 有效的刷怪笼类型名称（不区分大小写）请参考 Bukkit 的 EntityType 枚举。
• 有效的材料名称（不区分大小写）请参考 Bukkit 的 Material 枚举。

占位符

插件支持丰富的占位符，用于自定义排名显示格式，例如：

• {rank} - 派系排名。
• {faction} - 派系名称。
• {worth:total} - 派系总财富值。
• {count:spawner:zombie} - 僵尸刷怪笼数量。
• {count:material:diamond_block} - 钻石方块数量。

同时支持 MVdWPlaceholderAPI，例如 {factionstop_name:1} 可获取排名第一的派系名称。

❓常见问题

能否支持 XXX 插件？

如果有合理的理由且开发者同意，可以。请在 GitHub 的 Issue 跟踪页面提交请求：https://github.com/novucs/factions-top/issues。提交前，请先确认该功能是否已被集成。

我发现了 Bug，能修复吗？

请提供完整的服务器日志、已安装的插件列表以及服务器版本信息。同样地，请在 GitHub 的 Issue 页面提交报告：https://github.com/novucs/factions-top/issues。

如何添加铁傀儡刷怪笼（或其他刷怪笼）的价值？

可以添加。所有被计数的方块和刷怪笼都必须在配置文件中设定 worth 价值。请仔细阅读配置文件内的注释说明。如果您使用了某些特殊插件重写了刷怪笼功能，请通知开发者。

启动时出现 SQL 异常怎么办？

如果日志提示数据库驱动缺失，这通常是依赖冲突。按照安装步骤执行一次服务器重启即可解决。