雷维拉的公平传送

Revela's Fair Teleports

Revela's Fair Teleports 是一个专为 Hytale 设计的稳健、服务端实用模组，提供 TPA 和 Homes 等核心移动指令，其核心理念严格遵循 生存/战斗公平性。

本服务器模组旨在防止“紧急逃生”式操作。它直接集成到 Hytale 的实体组件系统（ECS）中，实时监测玩家伤害事件，确保传送功能仅用于便捷，而非战斗中的逃生手段。

反战斗滥用（核心功能）

本模组的突出特性是主动战斗监测。

• 实时追踪： 通过原生的 CombatMonitorSystem，模组能够精确检测玩家何时受到伤害。
• 传送限制： 如果玩家在最近 15 秒内（可配置）处于战斗状态，所有传送指令将被严格禁用。
• 防滥用： 玩家无法在战局不利时立即通过“TPA 逃离”或“Home 逃离”。系统尊重战斗流程。

---

✨ 功能

🏠 持久化家园系统

• 设置多个有名称的家园（例如 /sethome base、/sethome farm）。
• 可配置每个服务器的家园上限（默认 5 个）。
• 位置参数：使用 /home base 等指令，无需繁琐的标记。
• 安全的跨世界支持：传送到位于其他世界的家园也能无缝处理。

🤝 高级 TPA 套件

• 标准 /tpa 指令用于请求传送到朋友身边。
• 支持多个并发请求。
• 智能接受：/tpaccept 默认自动选择最新的请求，除非指定了玩家名称。
• 完全控制：可拒绝不想要的请求，或取消自己误发的请求。

📍 全局出生点访问

• 使用 /spawn 快速返回服务器默认出生点。
• 利用引擎原生的 SpawnProvider，确保精确回到世界预设的出生位置。

⚙️ 仅需服务端

• 客户端无需任何安装。
• 通过 Hytale 的原生界面和消息系统自动对所有玩家生效。

💾 稳健的持久化存储

• Hytale 原生 BSON： 使用引擎首选的二进制格式存储数据，速度最快。
• 线程安全： 所有文件 I/O 操作都在世界线程之外进行，防止服务器卡顿或 TPS 下降。
• 分层保存： 数据在变更时即时保存，并由后台维护服务管理。

---

指令

传送请求（TPA）

• /tpa [玩家]：向一名玩家发送传送到其身边的请求。
• /tpahere [玩家]：请求一名玩家传送到你身边。
• /tpaccept [玩家]：接受一个待处理的请求（默认接受最新的）。
• /tpdeny [玩家]：拒绝一个待处理的请求。
• /tpcancel [玩家]：取消你发送给他人的请求。

家园

• /sethome [名称]：在当前位置设置一个家园（默认名称为“home”）。
• /home [名称]：传送到已保存的家园。
• /delhome [名称]：删除特定的家园。
• /homes：列出你所有已保存的家园。

出生点

• /spawn：返回服务器的起始点。

---

权限节点

本模组使用 Hytale 的系统指令节点，方便与你现有的权限组集成。

• hytale.system.command.tpa
• hytale.system.command.tpahere
• hytale.system.command.tpaccept
• hytale.system.command.tpdeny
• hytale.system.command.tpcancel
• hytale.system.command.sethome
• hytale.system.command.home
• hytale.system.command.delhome
• hytale.system.command.homes
• hytale.system.command.spawn

---

配置

模组在首次启动时，会在 mods/fairteleports/ 目录下生成一个 config.json 文件。

服主可以自定义以下内容：

• homeLimit：每个玩家可设置的家园数量上限。
• combatTagSeconds：玩家在受到伤害后必须等待多少秒才能传送。
• tpaTimeoutSeconds：请求在超时前保持活跃的时间。

---

兼容性

• 专为生存和创造模式的多人在线服务器设计。
• 可安全地添加到现有世界中。
• 完全独立于客户端模组。

---

如有任何疑问，欢迎留言！