# **ProTPA** - 高级玩家传送管理
**ProTPA** 是一款专为 PaperMC/Folia（包括其分支）服务器设计的插件，旨在提供轻量级但高级、可配置且用户友好的传送请求系统。它利用现代 PaperMC API 构建，提供强大的对传送机制的控制，确保玩家和管理员都能获得无缝体验。
### 主要功能：
ProTPA 通过一套复杂的传送工具增强服务器游戏体验：
* **多样的传送请求:**
* `/tpa <玩家>`: 请求传送到另一位玩家处。
* `/tpahere <玩家>`: 请求另一位玩家传送到你的位置。
* **完整的请求生命周期管理:**
* `/tpaccept [玩家]`: 接受传入的传送请求。如果存在多个待处理的请求，可以选择接受哪个玩家的请求。
* `/tpdeny`: 拒绝所有传送请求。
* `/tpcancel`: 取消你的传出传送请求。
* `/tplist`: 查看你的待处理传入和传出传送请求。
* **玩家特定偏好:**
* `/tpblock`: 切换阻止所有传入传送请求。
* `/tpautoaccept`: 切换自动接受所有传入传送请求。
* **死亡位置恢复:**
* `/back`: 传送到你的上一次死亡位置，带有可配置的预热和冷却倒计时。
* **可配置的计时器和延迟:**
* **冷却时间:** 设置发送传送请求和使用回退命令之间的延迟。
* **预热时间:** 在传送发生之前实现倒计时，为传送和回退命令增加了策略深度。
* **请求超时时间:** 定义请求过期之前持续的时间。
* **增强的安全性和游戏机制:**
* **移动取消:** 选项：如果玩家移动，则取消传送预热。
* **受损取消:** 选项：如果玩家受到伤害，则取消传送预热。
* **战斗保护:** 在玩家战斗时阻止传送（可配置持续时间）。
* **世界黑名单:** 在指定的维度内禁用 TPA 和回退功能。
* **丰富的通知和反馈:**
* 使用 MiniMessage 进行自定义的在游戏消息，支持颜色和格式。
* 可选的声音效果，用于发送、接收和接受请求。
* 可选的粒子效果，用于在传送操作上提供视觉反馈。
* **细粒度的权限系统:**
* 对每个命令和功能的详细权限（例如：`protpa.tpa`、`protpa.accept`、`protpa.back`、`protpa.tplist`）。
* 绕过权限，用于冷却时间、预热时间、超时时间以及发送给被阻止的玩家（`protpa.bypass.*`）。
* 管理员权限，用于插件管理（`protpa.admin`、`protpa.admin.reload`）。
* 包含 `protpa.*` 通配符权限，用于完全访问。
### 技术细节：
ProTPA 轻量级但功能强大，专为现代服务器环境构建：
* **PaperMC & Folia API 集成:** 利用高级 API，包括 `LifecycleEvents` 用于命令注册，Brigadier 命令框架，`AsyncScheduler` 用于非阻塞任务（例如预热和超时），以及 `GlobalRegionScheduler` 用于安全的线程主传送。
* **广泛的配置:** 带有详细注释的 `config.yml` 允许服务器所有者微调几乎每个方面，包括所有计时器、安全功能、战斗设置、通知设置（声音、粒子）、回退命令设置以及通过 MiniMessage 自定义所有插件消息。
* **高效的用户数据处理:** 阻止和自动接受请求的玩家偏好以高效的方式存储在内存中，以便快速访问。
* **动态战斗管理:** 一个有效的系统会在战斗中标记玩家，与安全功能集成，以防止 TPA 漏洞。
* **死亡位置跟踪:** 自动跟踪和存储每个玩家的上一次死亡位置，用于回退命令功能。
* **MiniMessage 格式:** 所有面向用户的消息都支持强大的 MiniMessage 格式，允许进行丰富且引人入胜的文本。
### 管理员功能：
管理员拥有强大的工具来管理 ProTPA：
* **实时配置重新加载:** 使用 `/protpa reload` 立即应用来自 `config.yml` 的更改，无需重新启动服务器。
* **游戏内帮助命令:** `/protpa` 或 `/protpa help` 提供可用命令及其描述的详细列表，根据用户的权限定制。
* **绕过能力:** OP 级别的权限允许管理员在必要时覆盖标准的 TPA 限制。
* **全面的权限控制:** 精确定义谁可以使用插件的哪些功能。
### 适用场景：
* 服务器需要轻量级但高级的 TPA 系统，具有强大的配置和死亡恢复功能。
* 重视玩家主导的传送，并具有可定制规则和安全措施的社区。
* 希望提供不同传送体验的网络（例如，通过绕过权限为捐助者提供更快的传送）。
* 需要对传送机制进行细粒度控制以适应其服务器特定游戏风格的服务器所有者。
* 希望在保持平衡游戏性的同时，为玩家提供便捷的死亡恢复选择的服务器。
ProTPA，由 **BloodRed** 开发，将强大的功能与易用性相结合，为您的 Minecraft 服务器提供专业且经过打磨的传送解决方案。它专为性能而设计，并利用现代 Minecraft 服务器技术，以确保稳定性和兼容性。