⚡ xTpa | The Premium Teleportation Suite

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.