HyperFactions

⚔️HyperFactions - Hytale 的完整阵营系统

建立帝国。占领领土。缔结联盟。发动战争。HyperFactions 是一个全功能的阵营管理系统，专为 Hytale 服务器从零开始构建，强调 精美的 GUI、深度可配置性以及与 HyperSystems 生态系统的无缝集成。

所有功能均可通过直观的游戏内 GUI (/f) 或命令访问。无需查阅 Wiki 即可上手。

💬 加入我们的 Discord | 📖 文档与 Wiki | 🔗 GitHub

✨ 为什么选择 HyperFactions？

• 70+ 交互式 GUI 页面 - 每个功能都有精美的交互式 GUI。无需记忆命令。
• 实时 GUI 更新 - 当有成员加入、区块被占领或关系变更时，所有已打开的 GUI 都会自动刷新。
• 51 种区域标志 - 最精细的领土保护机制，从 PvP 和精细友军伤害，到生物生成、交通控制和 F 键拾取，一应俱全。
• 数据导入 - 正在从 ElbaphFactions、HyFactions、SimpleClaims 或 FactionsX 迁移？一条命令即可导入你的阵营、领地和关系。
• 深度可配置性 - 11 个模块化配置文件，涵盖游戏玩法的方方面面。可根据你的服务器风格进行调整。
• 积极开发 - 定期更新，功能由社区驱动。在 GitHub 上开源。

🆕 v0.12.0 的新功能

• 内置本地化 (i18n) - 开箱即用 10 种语言：英语、德语、西班牙语、法语、意大利语、荷兰语、波兰语、葡萄牙语、俄语、菲律宾语。玩家语言自动检测，可配置默认语言。
• 管理员 GUI：配置编辑器 - 在游戏中编辑所有 HyperFactions 设置，包含 11 个标签页、自适应大小布局、布尔开关、步进器、颜色选择器、下拉菜单和输入验证。
• 管理员 GUI：备份管理器 - 分页备份列表，支持创建、恢复和删除操作，以及类型筛选。
• 管理员 GUI：更新页面 - 检查 HyperFactions 和 HyperProtect-Mixin 的更新、下载和回滚——全部在 GUI 中完成。
• SimpleClaims 和 FactionsX 导入器 - 两个新的数据导入器：可从 SimpleClaims (SQLite 或 JSON) 或 FactionsX 迁移，支持完整的领地、成员和关系导入。
• BetterMap 兼容性 - 按世界启用/禁用 WorldMap 的配置，领地和区域在 BetterMap 管理的世界中能正确渲染。
• 海洋领地可见性修复 - 在水中/海洋中的阵营领地现在在世界地图上清晰可见。

🏰 核心功能

👥 阵营管理

• 创建阵营，支持自定义名称、标签、颜色和描述。
• 三级角色层级 - 领袖、官员、成员，每个角色都有精细的权限设置。
• 领地权限 - 分别为外人、盟友和成员配置破坏、放置和交互权限。服主可以在 faction-permissions.json 中锁定特定权限，以强制执行阵营无法覆盖的服务器全局规则。
• 邀请系统，包含过期邀请和面向封闭阵营的加入申请。
• 领导权转移，在领袖离开时自动继承。
• 解散确认，防止意外删除阵营。
• 阵营浏览器 - 搜索和排序所有阵营，查看详情，并申请加入。
• 活动日志 - 追踪所有带时间戳的阵营事件。

🗺️ 领土与占领

• 基于区块的占领，配备交互式 GUI 地图（点击即可占领/放弃）。
• 地形地图模式 - 在领地叠加层后显示真实地形图像，便于定位。
• 世界地图集成 - 在 Hytale 的世界地图上（按 M 键）按阵营颜色显示所有领地。
• 基于能量的占领限制 - 成员越多，领土越多。
• 反占领 - 当敌方能量降至零时，可占领其领土。
• 领地衰减 - 非活跃阵营在经过可配置的时间后会自动失去领地。
• 5 种世界地图刷新模式 - 从基于距离到手动刷新，选择适合你服务器的模式。
• 可配置的地图显示 - 切换显示阵营标签、玩家标记和非阵营玩家可见性。

⚡ 动态能量系统

• 个人能量 每个玩家（可配置上限，默认 20）。
• 自动恢复，可配置恢复间隔。
• 死亡能量损失，通过 Hytale 的 ECS 系统检测，可分别为 PvP、怪物和环境死亡设置开关。
• 每个领地的可配置能量消耗（默认：每个区块 2 点能量）。
• 战争区无能量损失 - 在指定的 PvP 竞技场中自由战斗。
• 中立击杀惩罚 - 可配置攻击中立玩家的能量损失。
• 战斗退出惩罚 - 可配置在战斗中退出的单独能量损失。

🤝 外交关系

• 💚 盟友 - 互相保护、共享领地访问权限、无友军伤害。
• ❤️ 敌人 - 完全启用 PvP，解锁反占领。
• 🤍 中立 - 启用 PvP，但攻击有能量惩罚。
• 基于 GUI 的外交 - 在 GUI 中浏览阵营、发送盟友/敌人/中立请求。
• 基于关系的聊天颜色 - 公开聊天中显示 绿色（同阵营）、粉色（盟友）、红色（敌人）、灰色（中立）。

⚔️ 战斗系统

• 战斗标记 - 防止退出游戏作弊（可配置持续时间，默认 15 秒）。
• 重生保护 - 重生后可配置的无敌时间。
• 基于关系的 PvP - 盟友受保护，敌人开放，可按区域配置。
• 反占领防御警报 - 当领土被夺取时，阵营成员会收到实时警报。

💰 阵营经济

• 阵营金库，支持存款、取款、阵营间转账和交易记录。
• 维护系统 - 自动化领土维护费用，支持固定或渐进式分级定价、宽限期和自动支付。
• VaultUnlocked 集成 - 通过标准经济 API 与任何经济插件协同工作。

🌍 本地化

• 内置 10 种语言：英语、德语、西班牙语、法语、意大利语、荷兰语、波兰语、葡萄牙语、俄语、菲律宾语。
• 玩家语言自动检测，可配置默认语言和每个玩家的覆盖设置。
• 每个语言包约 467 条翻译条目，涵盖所有命令、GUI 标签和帮助内容。

🛡️ 保护系统

HyperFactions 提供全面的领土保护，拥有 51 种可配置的区域标志，分为 10 个类别：

• ⚔️ 战斗 (7) - PvP、友军伤害（按阵营/按盟友）、抛射物伤害、PvE 伤害、怪物伤害。
• 🧱 建筑 (4) - 允许建造、放置方块 (mixin)、使用锤子 (mixin)、使用建造工具 (mixin)。
• 🚪 交互 (13) - 方块交互、门、容器、合成、处理、座位、使用光源、NPC 使用/驯服/交互、骑乘使用、箱子拾取/放置。
• 🎒 物品 (4) - 物品丢弃、自动拾取、F 键拾取 (mixin)、无敌物品 (mixin)。
• 🐾 生成 (5) - 生物生成（主控）、敌对/被动/中立生物、NPC 生成。
• 🧹 生物清理 (4) - 生物清理（主控）、敌对/被动/中立生物清理。
• 💀 死亡 (2) - 保留物品 (mixin)、能量损失。
• 💥 伤害 (4) - 坠落伤害、环境伤害、爆炸伤害 (mixin)、火焰蔓延 (mixin)。
• 🚀 交通 (3) - 使用传送器 (mixin)、使用传送门 (mixin)、骑乘进入。
• 🔗 集成 (5) - 访问墓碑、在地图上显示、Essentials 家、Essentials 传送点、Essentials 工具包。

🏟️ 安全区 & 战争区

管理员可以指定具有独立标志配置的特殊区域：

• 🟢 安全区 - 禁止 PvP、禁止生物生成、死亡保留物品。非常适合出生点和市场区域。
• 🔴 战争区 - 完全启用 PvP，死亡无能量损失。非常适合竞技场和活动。
• 视觉地图指示器 - 安全区在所有地图上显示为 青色，战争区显示为 紫色。
• 按标志自定义 - 可逐个区域覆盖任何默认标志。
• 生物生成控制 - 与 Hytale 的原生生成抑制系统集成，实现可靠的生物阻挡。
• 区域创建向导 - 通过占领单个区块、圆形半径、方形半径或使用视觉地图来创建区域。

💬 阵营与联盟聊天

• 切换模式 - /f c 在公开、阵营和盟友聊天之间循环。
• 直接设置 - /f c f 切换到阵营聊天，/f c a 切换到盟友聊天，/f c off 切换到公开聊天。
• 聊天历史 GUI - 在带有标签页的专用 GUI 页面中浏览过去的阵营和盟友消息。
• 自定义格式 - 为每个频道配置颜色和前缀。
• 安全消息传递 - 只有阵营/联盟成员才能看到私密消息。
• 持久历史 - 聊天消息保存到磁盘，即使重启后也可查看。

📢 服务器全局公告

主要的阵营事件会广播给所有在线玩家，并可配置开关：

• 阵营创建 / 解散
• 领导权转移
• 领土被反占领
• 宣战
• 联盟缔结 / 破裂

每种事件类型都可以在 announcements.json 中单独启用或禁用。

🖥️ 完整 GUI 系统

HyperFactions 拥有 70+ 交互式 GUI 页面，涵盖游戏玩法的各个方面：

🎮 玩家 GUI (/f)

• 仪表盘 - 能量、领地、成员、关系、状态和邀请一目了然。
• 领土地图 - 交互式区块地图，支持点击占领和视觉图例。
• 成员 - 可展开的成员列表，支持晋升、降级、踢出和转移操作。
• 关系 - 浏览阵营并通过盟友/敌人/中立按钮管理外交。
• 设置 - 双栏设置页面，包含阵营详情、领土权限、生物生成控制和外观编辑。
• 聊天历史 - 阵营和盟友聊天记录，支持标签页切换。
• 邀请 - 管理已发送的邀请和收到的加入申请。
• 日志 - 查看阵营活动历史。
• 金库 - 管理阵营资金，支持存款、取款、转账和交易记录。
• 玩家信息 - 查看任何玩家的阵营成员身份、能量统计、战斗记录和历史。
• 帮助 - 以指南为主的帮助中心，包含 7 个类别、侧边栏导航和验证过的命令参考。

🆕 新玩家 GUI

• 阵营浏览器 - 搜索、排序和查看所有服务器阵营。
• 创建阵营向导 - 单页创建，包含预览、颜色选择器和权限默认值。
• 世界地图 - 在加入阵营前查看已占领的领土。

🔐 管理员 GUI (/f admin)

• 仪表盘 - 服务器统计概览。
• 阵营管理 - 浏览、编辑和删除任何阵营。
• 区域管理 - 创建、配置和映射安全区和战争区。
• 配置 - 运行时设置调整。
• 玩家 - 浏览所有玩家，支持搜索、排序、能量统计和快速操作。
• 经济 - 服务器经济概览、按阵营调整金库、可排序的阵营余额列表。
• 能量管理 - 设置、调整、重置玩家能量，带有绕过开关和批量操作。
• 活动日志 - 全服范围的阵营活动浏览器，支持按类型、玩家和时间筛选。
• 版本信息 - Mod 版本、服务器版本以及所有 12 个受支持 Mod 的集成状态。
• 操作 - 全局快速操作（K/D 重置、批量操作）。
• 区域属性 - 整合的区域名称、类型和通知编辑。
• 备份 - 备份管理和恢复。
• 更新 - 在游戏内检查和安装更新。

🧠 智能 GUI 行为

• 基于权限的筛选 - 当玩家缺少权限时，按钮和导航标签页会自动隐藏。
• 实时更新 - 所有已打开的 GUI 在数据更改时会立即刷新。
• 基于角色的可见性 - 官员和领袖可以看到管理选项；成员只能看到只读视图。

🔧 管理工具

• 完整的管理员 GUI，包含专用的导航和管理页面。
• 绕过模式 - 切换管理员绕过以修改任何领土。
• 自动备份 - 可配置的备份计划，支持保留轮换。
• 更新前备份 - 安装更新前自动备份数据。
• 回滚支持 - /f admin rollback 可在重启前恢复到上一个版本。
• 调试系统 - 单独切换 7+ 个调试类别以进行针对性故障排除。
• 领地衰减管理 - 监控和手动触发非活跃阵营清理。
• 数据导入 - 从 ElbaphFactions、HyFactions、SimpleClaims 或 FactionsX 迁移，带有验证报告。
• 能量管理 - 按玩家设置、调整、重置能量，绕过开关和批量阵营操作。
• 经济管理 - 全服金库概览、按阵营调整余额。
• 玩家浏览器 - 搜索和管理所有服务器玩家，支持排序和快速操作。
• 配置热重载 - /f admin reload 无需重启即可重新加载所有配置。
• 持久管理员绕过 - 管理员绕过状态在服务器重启后保留。
• 版本信息 - /f admin version 可检查 Mod 版本和集成状态。

📊 PlaceholderAPI 支持

HyperFactions 为 PlaceholderAPI (PAPI) 和 WiFlow PlaceholderAPI 提供了 49 个占位符，涵盖：

• 阵营信息（名称、标签、描述、颜色、成员数量）
• 玩家角色和状态（等级、is_owner、is_officer、has_faction）
• 能量数据（玩家能量、最大能量、阵营能量、百分比）
• 领土数据（领地、最大领地、领土所有者、领土类型）
• 家坐标和状态
• 关系数量和配置值

可与任何支持 PAPI 或 WiFlow 的计分板、全息图或菜单插件一起使用。

🔌 集成

所有集成都使用自动检测和故障开放设计。⭐ = 推荐

📦 数据导入

🔮 即将推出的集成

💡 希望 HyperFactions 集成你的插件？ 在 Discord 上联系 DMehaffy 讨论集成机会。

📥 安装

基础安装

1. 将 HyperFactions.jar 放入你的 mods/ 文件夹。
2. 启动你的服务器。
3. 输入 /f 打开 GUI。

完整保护（推荐）

1. 在你的服务器目录中创建一个 earlyplugins/ 文件夹。
2. 将 Hyxin 和