{"id":35246,"date":"2026-06-01T20:03:34","date_gmt":"2026-06-01T17:03:34","guid":{"rendered":"https:\/\/vpesports.com\/minecraft\/mods\/btpa\/"},"modified":"2026-06-01T20:03:34","modified_gmt":"2026-06-01T17:03:34","slug":"btpa","status":"publish","type":"mod","link":"https:\/\/vpesports.com\/minecraft\/mods\/btpa\/","title":{"rendered":"bTpa"},"content":{"rendered":"

![banner](https:\/\/cdn.modrinth.com\/data\/cached_images\/59f3fafa457979aa1493a5bfec59b8a594eec89e_0.webp)<\/p>\n

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

![gif](https:\/\/media0.giphy.com\/media\/v1.Y2lkPTc5MGI3NjExeWZpeGZuMmY0Mmo5dGFwYnZxaGRzMnJ3NXViemc2Mm1kb2tycXB4cyZlcD12MV9pbnRlcm5hbF9naWZfYnlfaWQmY3Q9Zw\/Ihm1ro78tbk55UnvEX\/giphy.gif)<\/p>\n

## Features<\/p>\n

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

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

### Commands<\/p>\n

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

### Permissions<\/p>\n

– `btpa.use` – Allows the use of basic TPA commands (default: true)
\n– `btpa.toggle` – Allows toggling TPA requests (default: true)
\n– `btpa.block` – Allows blocking\/unblocking players (default: true)
\n– `btpa.reload` – Allows reloading the plugin configuration (default: op)
\n– `btpa.*` – Gives access to all TPA commands (default: op)<\/p>\n

## \ud83c\udf1f Comparison with Donut TPA<\/p>\n

| Feature | Donut TPA | bTpa |
\n|———|———–|——|
\n| TPA Commands | \u2705 | \u2705 |
\n| GUI System | \u2705 | \u2705 Enhanced |
\n| Friend System | \u274c | \u2705 Enhanced |
\n| Toggle System | \u2705 | \u2705 |
\n| Block System | \u2705 | \u2705 |
\n| Statistics | \u274c | \u2705 Enhanced |
\n| Clickable Messages | \u2705 | \u2705 |
\n| Sound Effects | \u2705 | \u2705 Configurable |
\n| Action Bar | \u274c | \u2705 |
\n| Acceptance Rate | \u274c | \u2705 |
\n| Data Persistence | \u2705 | \u2705 YAML |
\n| Cancel Requests | \u2705 | \u2705 |
\n| Documentation | Good | Comprehensive |
\n| Open Source | \u274c | \u2705 |
\n| Price | $6.99 | Free |<\/p>\n

## \ud83c\udfc6 Production Ready<\/p>\n

This plugin is **100% production-ready** for:
\n– \u2705 Large servers (1000+ players)
\n– \u2705 Serious networks
\n– \u2705 Professional servers
\n– \u2705 Public servers
\n– \u2705 Private servers
\n– \u2705 Creative servers
\n– \u2705 Survival servers
\n– \u2705 Any server type<\/p>\n

![stats](https:\/\/bstats.org\/signatures\/bukkit\/btpa.svg\/)<\/p>\n

## Configuration<\/p>\n

“`yaml
\n# bTpa Configuration File<\/p>\n

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

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

# Unicode font style (small caps and fancy text)
\n# Set to true to use Unicode small caps in titles and messages (e.g., \u1d1b\u1d18\u1d00)
\n# Set to false for regular text (default: true)
\nunicode-font: true<\/p>\n

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

# TPA Toggle messages
\n tpa-enabled: “&7TPA requests enabled.”
\n tpa-disabled: “&7TPA requests disabled.”
\n player-tpa-disabled: “&b{player} &7has TPA requests disabled.”
\n tpauto-enabled: “&7TPA auto-accept enabled.”
\n tpauto-disabled: “&7TPA auto-accept disabled.”
\n tpauto-accepted-target: “&7You automatically accepted &b{player}&7’s request.”<\/p>\n

# Block\/Unblock messages
\n player-blocked: “&7You blocked &b{player}&7 from sending TPA requests.”
\n player-unblocked: “&7You unblocked &b{player}&a.”
\n player-already-blocked: “&b{player} &7is already blocked.”
\n player-not-blocked: “&b{player} &7is not blocked.”
\n player-blocked-you: “&7You cannot send requests to &b{player}&c.”<\/p>\n

# Cancel command messages
\n request-cancelled: “&7Request to &b{player}&7 cancelled.”
\n request-cancelled-target: “&b{player} &7cancelled their request.”
\n no-outgoing-request: “&7You have no outgoing requests.”<\/p>\n

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

# Generic usage message used by some commands
\n usage: “&7Usage: &b{usage}”<\/p>\n

# Friend request messages
\n 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.”
\n 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.”
\n friend-request-accepted-sender: “&b{player} &7accepted your friend request.”
\n friend-request-accepted-target: “&7You accepted &b{player}&7’s friend request.”
\n friend-request-denied-sender: “&b{player} &7denied your friend request.”
\n friend-request-denied-target: “&7You denied &b{player}&7’s friend request.”
\n friend-request-expired: “&7Your friend request expired.”<\/p>\n

# GUI Settings
\ngui:
\n # Legacy\/global switch (kept for backwards compatibility)
\n enabled: true<\/p>\n

# Selector GUI (\/tpa with no args, \/tpagui, \/tpahere with no args)
\n selector-enabled: true<\/p>\n

# Incoming request GUI (shown to target player on request)
\n incoming-enabled: true<\/p>\n

# Outgoing request GUI (shown to sender after sending request)
\n outgoing-enabled: true<\/p>\n

# Auto-open incoming GUI on request (only if incoming-enabled = true)
\n auto-open: false<\/p>\n

title: “&bTeleport Requests”
\n size: 27<\/p>\n

update-check:
\n enabled: true
\n frequency-minutes: 360<\/p>\n

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

# Friend request settings
\nfriend:
\n request-expire: 120<\/p>\n

“`<\/p>\n

**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.<\/p>\n

### Messages<\/p>\n

All messages are fully customizable in the configuration file. Support for color codes using `&`.<\/p>\n

## How It Works<\/p>\n

### Sending a Request<\/p>\n

1. Player A types `\/tpa PlayerB`
\n2. Player B receives a message with clickable buttons: [Accept] [Deny] [GUI]
\n3. Player B can click on the buttons or use commands to accept\/deny<\/p>\n

### Teleporting<\/p>\n

1. When a request is accepted, the countdown starts
\n2. The player sees an actionbar message: “Teleporting in: X seconds”
\n3. Sound effects play every second during countdown
\n4. If the player moves or takes damage (if enabled), the teleport is cancelled
\n5. After countdown completes, the player is teleported successfully<\/p>\n

### GUI<\/p>\n

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

## Requirements<\/p>\n

– Minecraft 1.20.5 or higher
\n– Paper\/Spigot\/Purpur\/Leaf server
\n– Java 21 or higher<\/p>\n

## Support<\/p>\n

For issues, feature requests, or questions, please contact me.<\/p>\n

## License<\/p>\n

Copyright \u00a9 2026 blackowlzz. All rights reserved.<\/p>\n

—<\/p>\n

**Made with \u2764\ufe0f for the Minecraft community**<\/p>\n