TPA banner
TPA icon

TPA

A TPA REQUEST MOD System State & Data Structures Pending Requests: A structure to map a Requester to a Receiver. Logic: Only one outgoing request is allowed...

00
hytaleServer2026.1mod

TPA adds a simple teleport-request flow for servers.

  • Use /tpa <player> to request teleporting to another player. Requests fail if you target yourself, the player is offline, you already have an active request, or you are on cooldown.
  • Accept with /tpaccept; it grabs the oldest pending request targeting you and teleports that requester after a 2-second stand-still check. Moving cancels the teleport.
  • Cooldowns: 30s between /tpa uses (per requester) and 5 minutes after a successful teleport (per requester). Requests expire automatically after 45s.
  • The requester must remain online and stationary during the 2-second window; otherwise the teleport is canceled and the request is cleared.
  • Multiple players can request the same target, but each requester only has one active outgoing request at a time. Incoming requests are handled one at a time via /tpaccept.
  • Messages are sent to both parties on send/accept, including cooldown notices and movement cancellations.

Known notes/limitations:

  • If the requester disconnects or moves during the stand-still window, the teleport is canceled and must be re-requested.
  • Expired requests are quietly discarded; send a new /tpa if nothing happens.