TotemFactions - 图腾派系插件

TotemFactions 是一款为 Factions 类型服务器设计的独特游戏模式插件。其核心玩法是让玩家所属的派系（Faction）争夺并摧毁一个由方块构成的“图腾”，目标是成为唯一完全摧毁图腾的派系，同时抵御其他派系的干扰。

💡核心特性

• 优化性能：数据存储在本地，代码经过优化以支持大量玩家同时游戏。
• 多重图腾：提供 4 个不同的图腾生成点。
• 排名系统：根据胜利次数和摧毁的方块数量对派系进行排名，支持分页查看。
• 高度可配置：插件完全可配置，包括所有消息和设置。
• 广泛兼容：支持众多主流领地插件，并可与多种附属插件协同工作。
• 丰富功能：包含大量可自定义内容以提升玩家体验，如计分板、粒子效果、音效和标题。
• 跨版本支持：兼容 Spigot、PaperSpigot 和 Bukkit，支持从 1.7 到 1.21 的服务器版本。

✨兼容的领地插件

TotemFactions 与以下领地插件完全兼容：

• Factions
• FactionsUUID
• SaberFaction
• SavageFactions
• LegacyFactions
• Lazarus
• FactionsX
• GangPlus
• SimpleClan
• Guils
• SupériorSkyBloc2

✨兼容的附属插件

插件与以下管理/显示类插件兼容

• TAB Premium
• TitleManager
• FeatherBoard
• PlaceholderAPI
• MVdWPlaceholderAPI

🎮安装方法

安装过程非常简单

• 将下载的 TotemFactions.jar 文件放入您服务器的 plugins 文件夹。
• 重启您的服务器。

🔧命令与权限

主命令为 /totem，其子命令及对应权限如下：

管理员命令

• /totem setspawn <1-4>
• 权限：cmd.totem.setspawn
• 功能：设置指定编号（1-4）的图腾生成点。
• /totem create <1-4>
• 权限：cmd.totem.spawn
• 功能：创建图腾（有 5 分钟准备时间）。
• /totem now <1-4>
• 权限：cmd.totem.spawn
• 功能：立即创建图腾（只有 10 秒准备时间）。
• /totem stop
• 权限：cmd.totem.stop
• 功能：强制停止当前正在进行的图腾事件。
• /totem points <add/remove/clear> <派系名> <win/block> <数量>
• 权限：cmd.totem.points
• 功能：手动为派系增加、移除或清空胜利点数/摧毁方块数。
• /totem reset
• 权限：cmd.totem.reset
• 功能：重置统计数据文件 (stats.yml)，重置前会自动备份。
• /totem reload
• 权限：cmd.totem.reload
• 功能：重载插件配置。
• /totem update
• 权限：cmd.totem.update
• 功能：接收插件更新通知。

玩家命令

• /totem 或 /totem help
• 权限：无（默认启用）
• 功能：查看所有可用命令。
• /totem top 或 /totem rank
• 权限：无
• 功能：查看派系排名。
• /totem stats
• 权限：无
• 功能：查看自己所属派系的统计数据。
• /totem info
• 权限：无
• 功能：查看插件信息及所有图腾位置。
• /totem timer
• 权限：无
• 功能：查看距离下一个图腾生成或当前图腾结束的剩余时间。

权限总结

• cmd.totem.all：拥有所有命令权限。
• totemDefault：在配置中默认禁用，可自定义为某个权限来启用基础功能。

⭐占位符 (Placeholders)

插件支持 PlaceholderAPI 和 MVdWPlaceholderAPI。以下是一些常用占位符：

插件与服务器信息

• %totem_plugin_version% - 插件版本。
• %totem_server_version% - 服务器核心版本。

当前图腾信息

• %totem_faction_name% - 当前图腾所属派系名称。
• %totem_remaining_blocks% - 剩余方块数（图形化显示，如 ⬛ ⬛ ⬛）。
• %totem_remaining_block% - 剩余方块数（数字）。
• %totem_max_block% - 图腾总方块数。
• %totem_name% - 当前图腾的名称。
• %totem_status% - 图腾状态（可在 messages.yml 中自定义消息）。
• %totem_location_x%, %totem_location_y%, %totem_location_z%, %totem_location_world% - 图腾的坐标和世界。

时间相关

• %totem_timer_cron% - 距离下一个图腾生成的剩余时间。
• %totem_timer_current% - 当前图腾事件的剩余时间或等待时间。
• %totem_timer_days%, %totem_timer_hours%, %totem_timer_minutes%, %totem_timer_seconds% - 分解显示的时间单位。

玩家派系信息

• %totem_player_faction_name% - 查看该占位符的玩家所属派系名称。
• %totem_player_faction_wins% - 该玩家派系的总胜利次数。
• %totem_player_faction_blocs% - 该玩家派系摧毁的总方块数。

❓配置文件详解

主要配置文件为 config.yml 和 messages.yml。

config.yml 主要设置

• 权限节点：可以在此修改所有命令的权限。
• 奖励系统：可配置玩家摧毁最后一个方块、摧毁最多方块以及整个获胜派系的奖励（支持命令）。
• 游戏机制：
• breakSize：限制玩家必须靠近图腾一定距离内才能破坏方块。
• totemBlockTiming：设置破坏单个方块的最大时间，以及允许使用的末影珍珠数量。
• knockback：自动击退站在图腾顶部的玩家。
• haste：玩家与图腾互动时移除急迫效果。
• 视觉效果与声音：可独立开关计分板、粒子、音效、标题和烟花。
• 关键物品：
• itemBreakTotem：指定可以破坏图腾的工具（如 DIAMOND_SWORD），设为 "*" 则允许任何工具。
• typeTotemBlock：指定图腾生成时使用的方块类型（如 QUARTZ_BLOCK）。
• 自动重生：可设置图腾按照 CRON 表达式自动循环生成。

messages.yml 主要设置

此文件用于自定义插件显示的所有文本信息，包括

• 四个图腾的默认名称（如“北”、“南”）。
• 给管理员和玩家的各种操作反馈消息。
• 排行榜、统计信息的显示格式。
• 图腾生成、破坏、获胜等事件的公告消息。
• 计分板、标题、占位符返回文本的详细内容。

🔧链接与统计

• Metrics：bStats.org/TotemFactions/
• Discord 社区：Discord/TotemFactions/