⚡ xTpa | The Premium Teleportation Suite

!banner

xTpa is a professional-grade teleportation plugin for Minecraft servers that prioritizes user experience, visual feedback, and server performance. Say goodbye to boring, text-only teleport requests and welcome a new era of interactive player movement.

---

🚀 Why choose xTpa?

Unlike standard teleport plugins that only provide simple chat messages, xTpa focuses on immersive feedback. With integrated sounds, titles, and action bars, your players will never miss a request again.

✨ Key Features at a Glance:

• 🎨 Advanced Visuals: Uses Titles, Subtitles, and ActionBars to grab the player's attention immediately when a request arrives.
• 🎵 Audio Feedback: Every action has a soul! Fully configurable sounds for receiving requests, starting the countdown, and successful arrival.
• 🛡️ Combat-Safe Teleport: Prevents players from escaping combat or dangerous situations by detecting movement during the teleport countdown.
• ✨ HEX & Legacy Colors: Supports the full range of modern HEX colors (&#RRGGBB) and legacy formatting codes.
• ⚡ Optimized Performance: Written with high-concurrency in mind to ensure your server's TPS stays at a solid 20.
• 🔗 PlaceholderAPI Support: Fully integrated placeholders like %xtpa_player% and %xtpa_time% for customized messages.

---

🛠️ Detailed Commands & Permissions

Command	Usage	Description	Permission
/tpa	/tpa <player>	Send a teleportation request to a player.	None (Default)
/tpaccept	/tpaccept	Accept the most recent teleport request.	None (Default)
/tpdeny	/tpdeny	Decline the current pending request.	None (Default)
/xtpa	/xtpa reload	Reload the plugin configuration and messages.	xtpa.admin

🔑 Special Permissions

• xtpa.bypass.cooldown: Allows the player to send requests without waiting for the cooldown.
• xtpa.bypass.delay: Allows instant teleportation without the countdown wait.

---

⚙️ Full Configuration Preview

Here is the complete config.yml which allows you to customize every single aspect of the plugin to your liking.

#        _____
# __  _/__   \_ __   __ _
# \ \/ / / /\/ '_ \ / _` |
#  >  < / /  | |_) | (_| |
# /_/\_\\/   | .__/ \__,_|
#            |_/
# Official Support: https://xplugins.es/discord
# Documentation: https://xplugins.es/plugins/xtpa

# General plugin settings
settings:
  tpa-timeout-seconds: 60      # How long a request stays active before expiring
  cooldown-seconds: 15         # Time a player must wait between sending requests
  teleport-delay-seconds: 3    # Seconds to wait before the teleport happens
  teleport-move-cancel: true   # If true, teleport cancels if the player moves
  center-messages: false        # Aesthetic option to center chat messages

Sound System

Use standard Spigot sound names (e.g., ENTITY_ENDERMAN_TELEPORT)

sounds: received-tpa: enabled: true sound: "ENTITY_EXPERIENCE_ORB_PICKUP" volume: 1.0 pitch: 1.0 teleport-start: enabled: true sound: "BLOCK_NOTE_BLOCK_HARP" volume: 0.5 pitch: 1.5 teleport-success: enabled: true sound: "ENTITY_ENDERMAN_TELEPORT" volume: 1.0 pitch: 1.0

Visual Feedback (Titles & ActionBars)

visuals: title: enabled: false title: "&#FAEDCB ℹ Request Received!" subtitle: "&f%xtpa_player% wants to teleport to you" fade-in: 10 stay: 60 fade-out: 10 actionbar: enabled: true message: "&fHey! &#FAEDCB&n%xtpa_player%&f has sent you a TPA! Check your chat."

Message System (Supports HEX Colors)

messages: prefix: "" no-permission: "&c ✘ Error! &fYou do not have permission to use this." player-not-found: "&c ✘ &fThat player is offline or does not exist." cooldown: "&#FF5252 ✘ Error! &fWait &e%xtpa_time%s &fbefore sending another request." self-tpa: "&#FF5252 ✘ Error! &fYou cannot teleport to yourself." tpa-sent: "&#A0FF91 ✔ Success! &fRequest sent to &e%xtpa_player%&f." tpa-no-pending: "&#FAEDCB ℹ Info! &fYou have no pending requests." tpa-expired: "&#FAEDCB ℹ Info! &fThe teleport request has expired." tpa-denied-target: "&#A0FF91 ✔ Success! &fYou denied the request." tpa-denied-sender: "&#FF5252 ✘ Error! &fPlayer &e%xtpa_player% &fdenied your request." tpa-accepted-target: "&#A0FF91 ✔ Success! &fRequest accepted." tpa-accepted-sender: "&#A0FF91 ✔ Success! &e%xtpa_player% &faccepted your request." teleport-starting-sender: "&#A0FF91 ✔ Success! &fTeleporting you to &e%xtpa_player%&f." teleport-delay-notice-sender: "&#FAEDCB ℹ Info! &fTeleporting in %xtpa_time% seconds. Do not move!" teleport-cancelled-moved: "&#FF5252 ✘ Error! &fMovement detected! Teleport cancelled." teleport-cancelled-quit: "&#FF5252 ✘ Error! &fPlayer disconnected. Teleport cancelled." teleport-success-sender: "&#A0FF91 ✔ Success! &fYou have arrived safely."

Interactive Chat Request

received-request: line1: "&#FAEDCB ℹ Info! &fPlayer &#FAEDCB%xtpa_player% &fwants to teleport to you." line2-accept: "&fType &a/tpaccept &fTo accept." line3-deny: "&fType &c/tpdeny &fTo decline." line4: "&#FAEDCB ℹ Info! &fThe request expires in %xtpa_time% seconds." hover-accept: "&#A0FF91 Click here to ACCEPT!" hover-deny: "&c Click here to DENY!"

---

## 📥 Installation

1.  **Download** the latest `.jar` file from Modrinth.
2.  **Drop** the file into your server's `plugins/` folder.
3.  **Restart** or **Reload** your server.
4.  **Configure** the `config.yml` to your heart's content!

---

## 🌐 Community & Support

Join our growing community of developers and server owners!




---
*Created by the team at xPlugins. Quality matters.*