EN 5 3 TPA

TPA Module

中文版本 | English version

Function

This module handles player-to-player teleport request and response flow.

It is suitable for temporary group-up actions, such as meeting, helping new players, or fast movement during multiplayer activities.

Typical Usage

TPA is designed for immediate needs like "I want to go to someone" or "ask someone to come here".

Commands

/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>

Related Config

Mainly related: tpa.enabled, tpa.requestExpireTime, teleporting.delay, teleporting.cooldown.

Behavior Notes

Requests expire automatically after timeout. Actual teleport execution still follows global delay/cooldown.

This module separates "request accepted" and "teleport executed" into different steps. Accepting a request does not guarantee immediate teleport.

Trust Rules

Trust rules let players skip the standard manual request flow by auto-accepting or auto-denying TPA/TPAHere requests for all players or specific players.

Three-tier Decision Priority

1. Per-player override rule — set via /trust <player>, has the highest priority.
2. Global default rule — set via /trust all, applies to players not in the override list.
3. System default — default, uses the standard manual request/response flow.

Decision Values

Value	Behavior
accept	Auto-accept the request and immediately enqueue teleport execution
deny	Auto-reject the request; the sender receives a notification
default	Use the standard flow, equivalent to having no trust rule set

Storage

Trust rules are stored in each player's personal data; both global defaults and per-player overrides persist across server restarts. Setting a player's rules to default/default removes that player's override entry, making the player fall back to the global default rule. The global defaults are never auto-cleared — setting them to default simply means reverting to system default behavior.

Important Caveats

If players report "request accepted but no immediate teleport", this is usually expected behavior (global delay/cooldown), not an error. Check tpa.requestExpireTime together with global teleporting config.