!banner

A professional and feature-rich TPA (Teleport Ask) plugin for Minecraft 1.20.5+ servers, inspired by Donut TPA with enhanced features.

!gif

Features

Core Features

• TPA Request System: Send teleport requests to other players
• TPA Here: Request other players to teleport to you
• Auto-Open GUI: Automatically opens GUI when receiving requests (like Donut TPA)
• Clickable Messages: Accept or deny requests directly from chat
• GUI Interface: Modern and intuitive GUI for managing teleport requests
• Countdown System: Configurable countdown with actionbar display
• Sound Effects: Custom sounds for different actions (countdown, success, cancel, request)
• Cooldown System: Prevent spam with configurable cooldowns
• Movement/Damage Cancellation: Cancel teleport if player moves or takes damage
• Request Expiration: Automatic expiration of pending requests
• Multiple Language Support: All messages fully customizable

Advanced Features

• TPA Toggle: Enable/disable receiving TPA requests
• Block System: Block specific players from sending you requests
• TPA Back: Return to your previous location after teleporting (Soon!)
• Statistics System: Track TPA usage with detailed statistics
• Cancel Requests: Cancel your outgoing TPA requests
• Player Data Persistence: All settings and stats saved to files
• Friend System: Friends can autoaccept their TPAs

Commands

Command	Aliases	Description	Permission
/tpa <player>	/teleportask	Send a teleport request to a player	btpa.use
/tpahere <player>	/tphere	Request a player to teleport to you	btpa.use
/tpaccept	/tpyes, /tpac	Accept a teleport request	btpa.use
/tpdeny	/tpno, /tpdc	Deny a teleport request	btpa.use
/tpagui	/tpgui	Open the teleport GUI	btpa.use
/tpatoggle	/tpat	Toggle TPA requests on/off	btpa.toggle
/tpablock <player>	/tpab	Block a player from sending requests	btpa.block
/tpaunblock <player>	/tpaub	Unblock a player	btpa.block
/tpacancel	/tpac	Cancel your outgoing request	btpa.use
/tpafriend		Send/Deny/Remove friend request	btpa.use
/tpareload	/tparl	Reload the plugin configuration	btpa.reload

Permissions

• btpa.use - Allows the use of basic TPA commands (default: true)
• btpa.toggle - Allows toggling TPA requests (default: true)
• btpa.block - Allows blocking/unblocking players (default: true)
• btpa.reload - Allows reloading the plugin configuration (default: op)
• btpa.* - Gives access to all TPA commands (default: op)

🌟 Comparison with Donut TPA

Feature	Donut TPA	bTpa
TPA Commands	✅	✅
GUI System	✅	✅ Enhanced
Friend System	❌	✅ Enhanced
Toggle System	✅	✅
Block System	✅	✅
Statistics	❌	✅ Enhanced
Clickable Messages	✅	✅
Sound Effects	✅	✅ Configurable
Action Bar	❌	✅
Acceptance Rate	❌	✅
Data Persistence	✅	✅ YAML
Cancel Requests	✅	✅
Documentation	Good	Comprehensive
Open Source	❌	✅
Price	$6.99	Free

🏆 Production Ready

This plugin is 100% production-ready for:

• ✅ Large servers (1000+ players)
• ✅ Serious networks
• ✅ Professional servers
• ✅ Public servers
• ✅ Private servers
• ✅ Creative servers
• ✅ Survival servers
• ✅ Any server type

!stats

Configuration

# bTpa Configuration File

# Teleport settings
teleport:
  # Cooldown in seconds before teleport starts (countdown)
  countdown: 5
  # Cooldown in seconds before player can use /tpa again
  cooldown: 10
  # Request expiration time in seconds
  request-expire: 60
  # Cancel teleport if player moves during countdown
  cancel-on-move: true
  # Cancel teleport if player takes damage during countdown
  cancel-on-damage: true

# Sound settings
sounds:
  enabled: true
  # Use namespaced key format: e.g. "block.note_block.pling"
  # Full list: https://minecraft.wiki/w/Sounds.json
  countdown-tick: block.note_block.hat
  teleport-success: entity.enderman.teleport
  teleport-cancel: entity.villager.no
  request-received: block.note_block.pling
  volume: 0.8
  pitch: 1.0

# Unicode font style (small caps and fancy text)
# Set to true to use Unicode small caps in titles and messages (e.g., ᴛᴘᴀ)
# Set to false for regular text (default: true)
unicode-font: true

# Messages
messages:
  prefix: ""
  player-only: "&7Only players can use this command."
  no-permission: "&7You do not have permission to do that."
  player-not-found: "&7Player not found or offline."
  player-offline: "&7That player is no longer online."
  cannot-self-request: "&7You cannot send a request to yourself."
  request-sent: "&7Request sent to &b{player}&7."
  request-received: "&b{player} &7sent you a teleport request."
  request-expired: "&7Your request to &b{player} &7expired."
  no-pending-request: "&7You have no pending teleport requests."
  request-accepted: "&7You accepted &b{player}&7's request."
  request-accepted-sender: "&b{player} &7accepted your request."
  request-denied: "&7You denied &b{player}&7's request."
  request-denied-sender: "&b{player} &7denied your request."
  already-pending: "&7You already have a pending request for that player."
  outgoing-request-active: "&7You already have an active request. Use &b/tpacancel &7or wait for it to expire."
  teleporting: "&7Teleporting in &b{seconds}s&7..."
  teleport-cancelled-move: "&7Teleport cancelled: you moved."
  teleport-cancelled-damage: "&7Teleport cancelled: you took damage."
  teleport-success: "&7Teleport completed."
  cooldown: "&7Wait &b{seconds}&7s before sending another request."
  teleport-here-request-sent: "&7Teleport-here request sent to &b{player}&7."
  teleport-here-request-received: "&b{player} &7wants you to teleport to them."
  reload-success: "&aConfiguration reloaded successfully."

  # TPA Toggle messages
  tpa-enabled: "&7TPA requests enabled."
  tpa-disabled: "&7TPA requests disabled."
  player-tpa-disabled: "&b{player} &7has TPA requests disabled."
  tpauto-enabled: "&7TPA auto-accept enabled."
  tpauto-disabled: "&7TPA auto-accept disabled."
  tpauto-accepted-target: "&7You automatically accepted &b{player}&7's request."

  # Block/Unblock messages
  player-blocked: "&7You blocked &b{player}&7 from sending TPA requests."
  player-unblocked: "&7You unblocked &b{player}&a."
  player-already-blocked: "&b{player} &7is already blocked."
  player-not-blocked: "&b{player} &7is not blocked."
  player-blocked-you: "&7You cannot send requests to &b{player}&c."

  # Cancel command messages
  request-cancelled: "&7Request to &b{player}&7 cancelled."
  request-cancelled-target: "&b{player} &7cancelled their request."
  no-outgoing-request: "&7You have no outgoing requests."

  # tpafriend messages (trusted players / auto-accept)
  tpafriend-added: "&7Added &b{player} &7to your trusted players."
  tpafriend-removed: "&7Removed &b{player} &7from your trusted players."
  tpafriend-list-empty: "&7You have no trusted players."
  tpafriend-not-trusted: "&b{player} &7is not in your trusted list."

  # Generic usage message used by some commands
  usage: "&7Usage: &b{usage}"

  # Friend request messages
  friend-request-sent: "&7Friend request sent to &b{player}&7. If they accept, both of you will be added to each other's trusted list (mutual) and TPA requests between you will be auto-accepted."
  friend-request-received: "&b{player} &7sent you a friend request. Accepting will add both of you to each other's trusted list (mutual) and enable automatic acceptance of TPA requests between you."
  friend-request-accepted-sender: "&b{player} &7accepted your friend request."
  friend-request-accepted-target: "&7You accepted &b{player}&7's friend request."
  friend-request-denied-sender: "&b{player} &7denied your friend request."
  friend-request-denied-target: "&7You denied &b{player}&7's friend request."
  friend-request-expired: "&7Your friend request expired."

# GUI Settings
gui:
  # Legacy/global switch (kept for backwards compatibility)
  enabled: true

  # Selector GUI (/tpa with no args, /tpagui, /tpahere with no args)
  selector-enabled: true

  # Incoming request GUI (shown to target player on request)
  incoming-enabled: true

  # Outgoing request GUI (shown to sender after sending request)
  outgoing-enabled: true

  # Auto-open incoming GUI on request (only if incoming-enabled = true)
  auto-open: false

  title: "&bTeleport Requests"
  size: 27

update-check:
  enabled: true
  frequency-minutes: 360

security:
  # Require that both players have added each other for auto-accept to work
  require-mutual-trust: false
  # Require trusted players to have played before (more secure)
  require-played-before-for-trusted: true

# Friend request settings
friend:
  request-expire: 120

Note: When auto-open is enabled, players will automatically see the GUI when they receive a TPA request, just like in Donut TPA. They can still use chat commands if they prefer.

Messages

All messages are fully customizable in the configuration file. Support for color codes using &.

How It Works

Sending a Request

1. Player A types /tpa PlayerB
2. Player B receives a message with clickable buttons: [Accept] [Deny] [GUI]
3. Player B can click on the buttons or use commands to accept/deny

Teleporting

1. When a request is accepted, the countdown starts
2. The player sees an actionbar message: "Teleporting in: X seconds"
3. Sound effects play every second during countdown
4. If the player moves or takes damage (if enabled), the teleport is cancelled
5. After countdown completes, the player is teleported successfully

GUI

• Open with /tpagui or by clicking [GUI] in the chat message
• Visual representation of pending requests
• Player head shows who sent the request
• Green wool button to accept
• Red wool button to deny
• Gray glass pane decoration

Requirements

• Minecraft 1.20.5 or higher
• Paper/Spigot/Purpur/Leaf server
• Java 21 or higher

Support

For issues, feature requests, or questions, please contact me.

License

Copyright © 2026 blackowlzz. All rights reserved.

---

Made with ❤️ for the Minecraft community