5 3 TPA

TPA 模块

中文版本 | English version

功能

这个模块用于处理玩家之间的传送请求与响应流程。

它适合处理临时性的玩家集合需求，例如会合、带新玩家回基地，或者在多人活动中快速移动。

适用场景

TPA 实现了“我要去某个人那边”或“让某个人来我这里”这种即时需求。

命令

/tpa <player>
/tpahere <player>
/tpaaccept <player>
/tpaaccept <player> <requestId>
/tpadeny <player>
/tpadeny <player> <requestId>
/trust all
/trust all tpa <accept|default|deny>
/trust all tpa <accept|default|deny> tpahere <accept|default|deny>
/trust all tpahere <accept|default|deny>
/trust all tpahere <accept|default|deny> tpa <accept|default|deny>
/trust player <player>
/trust player <player> tpa <accept|default|deny>
/trust player <player> tpa <accept|default|deny> tpahere <accept|default|deny>
/trust player <player> tpahere <accept|default|deny>
/trust player <player> tpahere <accept|default|deny> tpa <accept|default|deny>
/trust <player>
/trust <player> tpa <accept|default|deny>
/trust <player> tpa <accept|default|deny> tpahere <accept|default|deny>
/trust <player> tpahere <accept|default|deny>
/trust <player> tpahere <accept|default|deny> tpa <accept|default|deny>

配置

主要相关的配置有 tpa.enabled、tpa.requestExpireTime、teleporting.delay 和 teleporting.cooldown。

行为说明

请求会在超时后失效，而真正执行传送时，仍然受全局 delay 和 cooldown 约束。

这个模块把”发起请求”和”真正传送”拆成了两步，所以接受请求并不等于会立刻完成传送，后面的延迟和冷却仍然会继续生效。

信任规则

信任规则允许玩家跳过标准的手动请求流程，针对所有玩家或特定玩家自动处理 TPA/TPAHere 请求。

三层决策优先级

1. 单个玩家覆盖规则 — 通过 /trust <player> 设置，优先级最高。
2. 全局默认规则 — 通过 /trust all 设置，对未在覆盖列表中出现的玩家生效。
3. 系统默认 — default，走标准的手动请求+响应流程。

决策值

值	行为
accept	自动接受请求，立刻排队执行传送
deny	自动拒绝请求，发送方会收到提示
default	走标准流程，相当于没有设置信任规则

存储

信任规则保存在每个玩家的个人数据中，全局默认和单个玩家覆盖都会在服务器重启后保留。设置某个玩家的规则为 default/default 会清除该玩家的覆盖条目，使该玩家回退到全局默认规则。全局默认规则本身不会被自动清除，设置为 default 即表示回退到系统默认行为。

使用时要注意

如果玩家反馈“已经同意了但没有立刻传送”，多数情况下并不是出错，而是仍在等待全局延迟，或者正处于冷却中。排查时，最好同时查看 tpa.requestExpireTime 以及全局 teleporting 配置。