XTpaz – TPA Plugin

XTpaz is a TPA (Teleport Ask) plugin for Paper/Spigot 1.20+. It provides simple, configurable player teleports with an optional confirmation GUI and strong anti-abuse options.

---

🔥 Key Features

👤 User experience

• Confirmation GUI: Confirm or cancel before sending a request; shows target world, ping, and player head.
• Teleport countdown: Configurable delay with action bar and sounds.
• Movement check: Teleport is cancelled if the player moves during the countdown.
• Sounds: Separate sounds for request sent/received, accept/deny, teleport, cooldown, etc.

⚙️ Requests & toggles

• TPA & TPAHere: Request to go to another player or bring them to you.
• Auto-accept: /tpauto and /tpahereauto for trusted players.
• TPA toggle: /tpatoggle to disable receiving requests.
• Confirm toggle: /tpaconfirmtoggle to switch between GUI and direct requests.

📋 Safety & limits

• Request expiry: Requests automatically expire (default 60 seconds).
• Cooldowns: Configurable cooldown between requests.
• Offline cleanup: Pending requests cleared when players quit.

🔧 Backend

• Configurable messages: Hex color support and placeholders ({player}, {target}, {time}).
• Live reload: /xtpaz reload reloads config and messages without restart.

---

🔧 Commands & Permissions

Command	Description	Permission
/tpa <player>	Request to teleport to a player	xtpaz.tpa
/tpahere <player>	Request a player to teleport to you	xtpaz.tpahere
/tpaccept [player]	Accept a pending TPA request	xtpaz.tpaccept
/tpadeny [player]	Deny a pending TPA request	xtpaz.tpadeny
/tpacancel [player]	Cancel your pending request	xtpaz.tpacancel
/tpauto	Toggle auto-accept for /tpa	xtpaz.tpauto
/tpahereauto	Toggle auto-accept for /tpahere	xtpaz.tpahereauto
/tpatoggle	Toggle receiving TPA requests on/off	xtpaz.tpatoggle
/tpaconfirmtoggle	Toggle confirmation GUI on/off	xtpaz.tpaconfirmtoggle
/xtpaz reload	Reload configuration	xtpaz.reload

---

📁 Configuration files

• config.yml – Request timeout, auto-accept delay, cooldown, teleport countdown, sounds, and message texts.

---

⛏️ Requirements

• Server: Paper or Spigot 1.20+
• Java: 17 or higher