SimpleTPA+

⚡ SimpleTPA+ | The Ultimate Modern Teleportation System
SimpleTPA+ is a high-performance, lightweight, and modern teleportation plugin built from the ground up for Paper, Purpur, and Spigot (1.19 – 1.21+). Designed to deliver a smooth, interactive player experience without bloating server resources!

Key Highlights & Features

• Async & Ultra-Performant: Built using modern Adventure API and Kyori components to process text, sound effects, and Action Bar updates asynchronously with zero main-thread lag.
  
  
• Clickable Interactive Chat Cards: When a player receives a TPA request, they get a beautifully formatted, embed-like chat message with clickable [ ACCEPT ] and [ DENY ] buttons featuring hover text.
  
  
• Real-time Action Bar Countdown: Smooth visual countdown displayed directly above the player's hotbar during teleportation.
  
  
• Anti-Movement Safety System: Teleportation automatically cancels if the traveler moves. Both the traveler and the target player receive immediate notifications explaining why it was cancelled!
  
  
• ⚡ Request Locking & Anti-Spam: Prevents players from spamming multiple active TPA requests. Players can only have one active outgoing request at a time until it expires, is accepted, or is rejected.
  
  
• ️ Player TPA Toggle & Staff Bypass: Players can disable incoming TPA requests using /tpatoggle. Staff members with the bypass permission can still send essential requests if enabled.
  
  
• Built-in Feedback System (/tpafeedback): Allows players to submit feedback or report issues directly to developers right from in-game.
  
  
• ⚙️ 100% Fully Customizable: Every single message, prefix, button label, hover text, sound effect, and countdown duration can be edited!

How to Use SimpleTPA+ (Step-by-Step Guide)
1. Sending a Teleport Request

• Type /tpa <player> to request to teleport to another player.
  
  
• You will receive a confirmation message, and a command cooldown will trigger to prevent spam.
  
  
• If you already have an active request pending, the plugin will block you from sending another until the first one is resolved or expires.

2. Accepting or Denying Requests
When someone sends you a TPA request, a custom card appears in your chat with interactive buttons:

• Click [ ACCEPT ] (or type /tpaccept): Accepts the request and initiates the teleport countdown for the sender.
  
  
• Click [ DENY ] (or type /tpdeny): Rejects the request and notifies the sender immediately.

3. During the Teleport Countdown

• Once accepted, a countdown (e.g., 5 seconds) appears on the sender's Action Bar.
  
  
• CRITICAL: The traveling player must stand completely still.
  
  
• If the player moves more than 0.2 blocks, the teleportation is instantly aborted, sound effects play, and both players receive a cancellation message in chat.

4. Toggling Requests On/Off

• Type /tpatoggle to block incoming TPA requests.
  
  
• Executing the command again will re-enable requests for your account.

5. Submitting Feedback

• Type /tpafeedback <your message> to send comments or bug reports straight to the developers.

Commands & Command Table
Command Description Permission Node Default Access

/tpa <player> Send a teleport request to a player. simpletpa.use Everyone (true)
/tpaccept Accept a pending teleport request. simpletpa.use Everyone (true)
/tpdeny Deny a pending teleport request. simpletpa.use Everyone (true)
/tpatoggle Toggle receiving incoming TPA requests. simpletpa.use Everyone (true)
/tpafeedback <msg> Send direct feedback to plugin developers. simpletpa.use Everyone (true)
/tpahelp Display the interactive help menu. simpletpa.use Everyone (true)
/tpareload Reload the plugin configuration in real-time. simpletpa.admin.reload Admins / OP

Permissions & Permissions Node Guide

SimpleTPA+ uses clean, intuitive permission nodes. By default, standard player permissions are granted automatically (default: true), while administrative functions are locked to Server Operators (default: op).

Permission Node Description Default Access Recommended Group

simpletpa.use Grants access to standard user commands (/tpa, /tpaccept, /tpdeny, /tpatoggle, /tpahelp, /tpafeedback). true (All Players) Default / Member
simpletpa.admin.reload Allows reloading the config.yml file in real-time via /tpareload. op (Admins Only) Admin / Owner
simpletpa.bypass.toggle Allows sending TPA requests to players who have disabled requests via /tpatoggle (Requires allow-bypass: true in config). op (Admins Only) Moderator / Admin

️ Example Setup for Permission Managers (LuckPerms, etc.)
For Regular Players:
Bash
/lp group default permission set simpletpa.use true

For Staff / Moderators (Bypass Toggle):
Bash
/lp group moderator permission set simpletpa.bypass.toggle true

For Server Admins:
Bash
/lp group admin permission set simpletpa.admin.reload true

️ Installation Guide

1. Download the latest SimpleTPA+-Bukkit-1.5.jar.
   
   
2. Place the .jar file into your server's plugins/ directory.
   
   
3. Start or restart your server to generate default configuration files.
   
   
4. Modify plugins/SimpleTPAPLUS/config.yml to fit your server's style.
   
   
5. Run /tpareload in-game to apply changes instantly without restarting!

⚙️ Complete config.yml Preview

# ==============================================================================
# SimpleTPA+ - Configuration
# By MillanLA (1.0v)
# ==============================================================================
# Compatible with Paper / Purpur / Spigot (1.19 - 1.21+)
# Supports Adventure API, MiniMessage/Legacy Color Codes, Action Bar & Interactive Cards.
# ==============================================================================

settings:
# Time in seconds before a pending teleport request automatically expires.
request-expiry-seconds: 60

# Delay in seconds before teleportation actually occurs after a request is accepted.
# The player MUST stand still during this period. Set to 0 to disable countdown.
teleport-cooldown-seconds: 5

# Cooldown in seconds between individual uses of the /tpa command per player
# to prevent request spamming.
tpa-command-cooldown-seconds: 10

# [EXPLANATION] Allow Bypass:
# Players can block incoming requests using '/tpatoggle'.
# If 'true', players holding the permission 'simpletpa.bypass.toggle'
# can still send a TPA request to someone who has toggled requests off.
# If 'false', everyone is strictly blocked by a player's toggle state.
allow-bypass: false

# ==============================================================================
# Sound Effects
# Sound names must match official Minecraft Bukkit Sound Enums:
# https://hub.spigotmc.org/javadocs/spigot/org/bukkit/Sound.html
# Leave empty "" to disable a specific sound effect.
# ==============================================================================
sounds:
request-sent: "ENTITY_ARROW_HIT_PLAYER"
request-received: "ENTITY_EXPERIENCE_ORB_PICKUP"
teleport-countdown: "BLOCK_NOTE_BLOCK_PLING"
teleport-success: "ENTITY_ENDERMAN_TELEPORT"
teleport-cancelled: "ENTITY_ITEM_BREAK"

# ==============================================================================
# Custom Messages
# Color codes (&0-9, &a-f, &k-r) are fully supported across all text fields.
# Placeholders: {player}, {target}, {time}, {seconds}
# ==============================================================================
messages:
# Global prefix used for standard system notifications
prefix: "&8[&b&lSimpleTPA+&8] &7"

# General System Messages
player-not-found: "&cPlayer not found or offline."
cannot-tpa-self: "&cYou cannot send a teleport request to yourself."
tpa-disabled: "&cThis player has disabled incoming TPA requests."
command-cooldown: "&cPlease wait &e{seconds}s &cbefore sending another request."
already-has-request: "&cYou already have a pending teleport request. Please wait until it expires or is resolved."
no-permission: "&cYou do not have permission to execute this command."
config-reloaded: "&aConfiguration reloaded successfully!"

# ============================================================================
# /tpahelp Command Card
# ============================================================================
help-card:
- "&8&m----------------------------------------"
- " &b&lSIMPLETPA+ &8» &e&lHELP MENU"
- " &7Commands and usage guide:"
- ""
- " &b/tpa <player> &8- &7Send a teleport request."
- " &b/tpaccept &8- &7Accept a pending request."
- " &b/tpdeny &8- &7Deny a pending request."
- " &b/tpatoggle &8- &7Toggle receiving TPA requests."
- " &b/tpafeedback <message> &8- &7Send feedback to developers."
- " &b/tpahelp &8- &7Display this help menu."
- " &b/tpareload &8- &7Reload plugin configuration &8(&cAdmin&8)"
- ""
- " &7&oStand still during the teleport countdown!"
- "&8&m----------------------------------------"

# ============================================================================
# Interactive Chat Card (Embed)
# Sent to the target player when receiving a TPA request.
# Placeholders: {button_accept}, {button_deny}
# ============================================================================
request-card:
- "&8&m----------------------------------------"
- " &b&lTELEPORT REQUEST &8» &e&l{player}"
- " &7Wants to teleport to your location."
- " &7Expires in &f{time}s&7."
- ""
- " {button_accept} {button_deny}"
- "&8&m----------------------------------------"

# Interactive Chat Buttons
button-accept: "&a&l[ ACCEPT ]"
button-accept-hover: "&aClick to accept request from &e{player}"
button-deny: "&c&l[ DENY ]"
button-deny-hover: "&cClick to deny request from &e{player}"

# Request Notifications
request-sent: "&aTeleport request sent to &e{target}&a."
no-pending-requests: "&cYou have no pending teleport requests."
request-accepted: "&aRequest accepted! Teleporting target player..."
request-accepted-target: "&e{player} &aaccepted your request. Don't move!"
request-denied: "&cTeleport request denied."
request-denied-target: "&c{player} denied your teleport request."
request-expired: "&cThe teleport request has expired."

# ============================================================================
# Action Bar & Teleport Status
# Displays directly above the player's experience bar.
# ============================================================================
actionbar-countdown: "&b&lTPA IN &e&l{seconds}s &8• &c&lDON'T MOVE!"
teleport-cancelled-move: "&c&lCANCELLED &8» &7Teleportation aborted because you moved."
teleport-cancelled-move-target: "&c&lCANCELLED &8» &7Teleportation cancelled because &e{player} &7moved."

# Toggle Status Notifications
toggle-on: "&aYou have &eenabled &ayour TPA requests."
toggle-off: "&cYou have &edisabled &ayour TPA requests."

PICTURE