TaleFly

TaleFly

高级飞行管理器。基于经济与时间，支持经济、领地及占位符的挂钩。

实用

TaleFly

Hytale 飞行管理

时间或金钱计费 | 战斗安全 | 领地识别 | 滑翔翼防护 | PlaceholderAPI

世界规则 | 速度控制 | 掉落伤害保护 | 热重载

给你的玩家飞行能力，同时不破坏你的经济或 PvP 平衡。TaleFly 将飞行变为一种可管理的资源，玩家在真正飞行时消耗时间银行或按秒付费，而你拥有控制工具来确保公平。

概览

TaleFly 是一款为任何希望实现可控飞行的 Hytale 服务器设计的高级飞行插件：

  • 飞行作为资源：玩家在飞行时首先消耗存储的时间银行，然后可选择按秒付费（静止时不会消耗）。
  • 公平设计：战斗标记、领地规则、世界白名单和反滑翔翼利用机制确保飞行不会破坏平衡。
  • 安全着陆：飞行结束后立即触发掉落伤害保护，玩家不会因此受到惩罚。
  • 兼容任何经济系统：自动检测 Vault、EcoAPI、Ecotale 和 XqediiCore，若未安装则仅使用时间模式。
  • 为仪表板而生：完整支持 PlaceholderAPI，可在计分板和 HUD 上显示时间、状态、余额、费用和速度。
  • 对服主友好：所有内容（包括消息）均可配置，支持热重载，无需重启服务器。

一键切换飞行

  • 一个命令 /fly 即可开关飞行（别名：/tf, /tfly, /talefly）
  • 启用和禁用时客户端同步流畅，不会出现飞行状态卡住
  • 可配置启用、禁用和资源耗尽消息，支持聊天或标题显示

双资源系统

  • 每个玩家拥有一个以秒为单位的个人飞行时间银行
  • TaleFly 首先消耗存储的时间，且仅在玩家主动飞行时消耗
  • 当时间银行耗尽时，可选择按每秒收费（消耗金钱）
  • 在空中悬停不会消耗资源，仅当玩家真正飞行时才消耗

经济支持（自动检测，可选）

  • 自动检测并使用第一个可用的受支持经济系统
  • 支持 VaultUnlocked、EcoAPI、Ecotale 和 XqediiCore
  • 未安装经济系统？飞行将自动回退到仅时间模式，一切正常
  • 开发者可通过公开的 TaleFly API 注册自定义经济系统

领地和阵营识别（可选）

  • 实时读取玩家飞行时的领地数据，并按区域执行规则
  • 兼容 SimpleClaims 和 WiFlow's Claims
  • 分别为自己的、友方、中立、敌方、安全区、战争区和荒野 设置独立的允许/禁止开关
  • talefly.claimbypass 权限允许管理员在任何地方飞行
  • 实时区块检测：当玩家进入禁止飞行的领地时立即禁用飞行

战斗标记系统

  • 当玩家进入战斗时自动禁用飞行
  • 阻止在可配置的冷却时间内重新启用飞行，防止玩家飞离战斗
  • 独立控制 PvP 和 PvE 开关
  • 可选择在死亡时清除战斗标记

滑翔翼防护

  • 阻止经典的滑翔翼利用漏洞，玩家无法在飞行途中切换滑翔翼以逃避费用或规则
  • 智能两阶段处理：取消滑翔、重置速度并安全着陆，不会出现坠落卡顿
  • 选择执行方式：静默阻止滑翔翼，或对反复违规者发送自定义消息并踢出
  • 在飞行结束后持续保护，直到玩家安全着陆

掉落伤害保护

  • 在飞行禁用后立即防止掉落伤害，因此结束飞行不会导致受伤
  • 保护持续到玩家实际接触地面，然后自动清除
  • 完全可选，如果你希望飞行有风险，可在配置中关闭

飞行速度控制

  • 玩家可通过 /fly speed <数值> 设置自己的速度
  • 可配置的最小值和最大值确保速度合理
  • 需要 talefly.speed 权限

世界规则

  • 世界白名单：仅在你允许的世界中启用飞行
  • 切换世界时自动禁用：飞行不会在不同世界之间延续，避免跨世界利用

可配置消息和标题

  • 每条消息均可编辑，支持以聊天或标题形式输出
  • 支持丰富的颜色标签，如 <gold>、<red>、<bold> 以及传统 & 代码
  • 设置一次前缀即可全局生效

PlaceholderAPI 支持

  • 检测到 PlaceholderAPI 时自动注册，否则完全可选
  • 在计分板、HUD 和菜单上显示飞行时间、状态、余额、费用和速度
  • 占位符输出文本本身可在 config/placeholders 中配置

快速、安全的存储

  • 每个玩家的时间银行保存在一个紧凑的本地数据库文件中
  • 异步写入并原子化保存，不会阻塞主线程
  • 玩家加入时预加载数据，因此 /fly status 和占位符从第一秒起就准确

命令

玩家（权限：talefly.use）

  • /fly - 切换飞行（别名：/tf, /tfly, /talefly）
  • /fly status - 显示你的飞行时间、余额和每秒费用
  • /fly speed <数值> - 在配置限制内设置飞行速度（权限：talefly.speed）

管理员（权限：talefly.admin）

  • /fly reload - 重载配置和消息
  • /fly givetime <玩家> <秒数> - 为玩家增加飞行时间
  • /fly settime <玩家> <秒数> - 将玩家的飞行时间设为精确值

权限

  • talefly.use - 使用 /fly 和 /fly status 所需
  • talefly.speed - 使用 /fly speed
  • talefly.admin - 访问 /fly reload、givetime 和 settime
  • talefly.bypass - 免费飞行，跳过所有时间和金钱检查
  • talefly.claimbypass - 忽略领地飞行规则，可在任何领地内飞行

占位符（可选：PlaceholderAPI）

如果安装了 PlaceholderAPI，TaleFly 会自动注册其占位符。输出文本可在 config/placeholders 中配置。

用途： 计分板、HUD、服务器 UI 面板和自定义菜单。

  • %talefly_time% - 剩余飞行时间（秒）
  • %talefly_time_formatted% - mm:ss 或 hh:mm:ss 格式
  • %talefly_status% - true 或 false
  • %talefly_status_formatted% - 已启用 或 已禁用
  • %talefly_balance% - 格式化后的余额（如果安装了经济系统）
  • %talefly_cost% - 配置文件中的每秒费用
  • %talefly_speed% - 玩家当前的飞行速度

配置亮点

TaleFly 完全通过其基于 codec 的配置文件进行配置，无需编码。

  • 经济和费用：启用金钱模式、每秒费用、默认初始时间、货币格式
  • 世界规则：允许的世界列表和切换世界时自动禁用
  • 战斗标记：持续时间、独立的 PvP 和 PvE 开关、死亡时清除、死亡时禁用飞行
  • 滑翔翼防护：启用/禁用、设置阻止消息冷却时间、或切换到踢出模式
  • 安全性：启用/禁用掉落伤害保护
  • 速度：/fly speed 的最小值和最大值
  • 领地：启用集成并选择具体允许飞行的区域类型

完美搭配

  • 一个经济插件（Vault、EcoAPI、Ecotale 或 XqediiCore）：将飞行变为一个消耗玩家金钱的机制。
  • 一个领地插件（SimpleClaims 或 WiFlow's Claims）：让玩家在自己的领地内飞行，但不能从空中袭击敌人。
  • PlaceholderAPI：将飞行时间、费用和状态直接显示在你的计分板或 HUD 上。

每个集成都是可选且自动检测的。如果未安装任何插件，TaleFly 仍可作为一款纯净的基于时间的飞行插件运行。

安装方法

  1. 将 TaleFly.jar 放入服务器的 mods 文件夹中。
  2. 可选：安装一个受支持的经济插件（VaultUnlocked、EcoAPI、Ecotale 或 XqediiCore）以实现基于金钱的飞行。
  3. 可选：安装一个受支持的领地插件（SimpleClaims 或 WiFlow's Claims）以启用领地飞行规则。
  4. 可选：安装 PlaceholderAPI 以公开飞行占位符。
  5. 启动服务器一次，生成 config/TaleFly、config/messages、config/placeholders 和 data/talefly.db。
  6. 根据需要调整配置，然后运行 /fly reload 应用更改，无需重启。

兼容性

新的经济和领地集成功能会持续添加。需要上面未列出的功能？请通过我们的 Discord 联系我们。