SimpleTPA

A lightweight TPA plugin for Paper and Folia servers. Teleport requests, clear feedback, per-player settings and protection options you can configure, made for current Minecraft versions.

Wiki:

https://wiki.vexo-dev.de/

✨ Features

• Send, accept, deny and cancel teleport requests with /tpa, /tpahere, /tpaccept, /tpadeny and /tpacancel.
• /tpalist shows your incoming and outgoing requests with the time left, pages and clickable accept/deny/cancel buttons.
• Trust list with auto-accept: add friends with /tpatrust and choose if their /tpa, /tpahere or both requests get accepted automatically. Nobody else is ever auto-accepted.
• Request expiry and anti-spam cooldowns (the cooldown can't be skipped by relogging).
• Optional teleport countdown that gets cancelled when the player moves or takes damage.
• Safe destinations: no teleports into lava, water, fire, cobwebs or onto the Nether roof. Snow, carpets, slabs and paths are handled correctly.
• New: optional teleport costs via Vault. Off by default. The sender only pays once the teleport actually starts, and failed teleports get refunded.
• New: world rules. Allow TPA only inside the same world, or block dimensions like the Nether or the End completely.
• World and cuboid-region blacklist.
• Optional WorldGuard and GriefPrevention support (off by default).
• Settings GUI for requests, sounds, language, auto-accept, trust list and request inbox. Title, size, slots and materials are configurable.
• Every player can pick their own language: English, German, French or Spanish.
• Player blocking, TPA toggle, direct admin teleport and /tpaall.
• /tp <player> uses the safe teleport. Everything else (/tp x y z, /tp a b, selectors, console) still works like vanilla.
• /tpaadmin status for quick diagnostics (requests, teleports, storage, economy, protection plugins).
• New config options are added automatically on startup and /tpareload, your existing values stay untouched.

Commands

| Command | Description | Permission |
| --- | --- | --- |
| /tpa <player> | Send a teleport request. | — |
| /tpahere <player> | Ask a player to teleport to you. | — |
| /tpaccept [player] | Accept a request. | — |
| /tpadeny [player] | Deny a request. | — |
| /tpacancel | Cancel your sent request(s) or your running countdown. | — |
| /tpalist [in\|out] [page] | List your incoming or outgoing requests. | — |
| /tpatrust <add\|remove\|list\|auto> | Manage your trust list and auto-accept. | — |
| /tpatoggle | Turn incoming requests on or off. | — |
| /tpablock <player> | Block requests from a player. | — |
| /tpaunblock <player> | Unblock a player. | — |
| /tpasettings | Open your settings GUI. | — |
| /tp <player> | Teleport directly to a player. | simpletpa.tp |
| /tpaall | Ask all online players to teleport to you. | simpletpa.tpaall |
| /tpareload | Reload config and language files. | simpletpa.reload |
| /tpaadmin status | Show plugin diagnostics. | simpletpa.admin.status |

Permissions

| Permission | Description | Default |
| --- | --- | --- |
| simpletpa.updatenotify | Get update notifications on join. | OP |
| simpletpa.bypass.delay | Skip the teleport countdown. | OP |
| simpletpa.bypass.cooldown | Skip the request cooldown. | OP |
| simpletpa.bypass.protection | Skip safety checks and countdown cancelling. | OP |
| simpletpa.bypass.worlds | Ignore the cross-world and dimension rules. | OP |
| simpletpa.bypass.cost | Teleport requests are free. | nobody |
| simpletpa.bypass.integrations | Ignore WorldGuard/GriefPrevention checks. | nobody |

Teleport costs (optional)

Needs Vault and an economy plugin like EssentialsX. Turn it on in config.yml:

economy:
  enabled: true
  tpa-cost: 10.0
  tpahere-cost: 10.0

The player who sent the request always pays, also for /tpahere. /tpaall charges tpahere-cost for every player who accepts.

World rules (optional)

worlds:
  allow-cross-world: false
  blocked-dimensions: [NETHER, THE_END]

Works for /tpa, /tpahere and /tpaall. The admin /tp is not affected.

Compatibility

| Server type | Supported |
| --- | :---: |
| Paper | ✅ |
| Folia | ✅ |
| Purpur and other Paper forks | ✅ |
| Spigot | ❌ |
| Bukkit | ❌ |
| BungeeCord | ❌ |
| Velocity | ❌ |

Requires Minecraft 1.21.1 or newer and Java 21 (Minecraft 26.x needs Java 25).

Configuration

Every option is explained in config.yml. Updates keep your settings and only add what's missing. Please back up your plugin folder before updating.

bStats