ThunderTPA

Advanced TPA plugin for Minecraft 26.2 (Chaos Cubed), built on the Paper API. Teleport requests with buttons you can click directly in chat ([✔ ACCEPT] / [✖ DENY]), no typing required, and 100% configuration from a YAML file.

Commands

Command	Description
`/tpa <player>`	Ask to teleport TO that player
`/tpahere <player>`	Ask the player to teleport TO YOU
`/tpaccept [player]`	Accept the most recent request, or a specific player's if you have several queued
`/tpdeny [player]`	Deny a request
`/tpacancel`	Cancel your outgoing request(s)
`/tpatoggle`	Block/unblock incoming TPA requests
`/tpaall`	Ask every online player to teleport to you
`/tpahelp`	Show the list of ThunderTPA commands
`/back`	Return to your last location (pre-teleport or pre-death)
`/tpadmin reload`	Reload config.yml without restarting the server

Features

Clickable chat buttons: when a request arrives, the recipient sees two colored buttons with hover-text; clicking one automatically runs /tpaccept or /tpdeny, no typing needed.
Countdown before teleporting (configurable), automatically cancelled if the player moves.
Cooldown between requests, to prevent spam.
Automatic timeout for unanswered requests.
Queued-request limit per player.
/tpatoggle: players who don't want to be disturbed can disable receiving requests.
/tpaall: send a teleport request to everyone online at once, asking them all to teleport to you — great for gathering the whole server for an event.
Smart /back: saves your location both before a TPA teleport and on death (each can be disabled separately in the config).
Sounds and particles for every phase (request received, accepted, denied, successful teleport) — all configurable or can be turned off.
100% customizable messages in MiniMessage format (colors, gradients, bold text, etc.) directly from config.yml, with /tpadmin reload to apply changes on the fly.

How to build

You need Java 25 and Maven installed (Minecraft 26.2 / Paper require JDK 25).

mvn clean package

The compiled jar will appear in target/ThunderTPA-1.0.0.jar.

If you use IntelliJ IDEA: just open the project folder, IntelliJ will recognize the pom.xml and automatically download Paper API 26.2 from PaperMC's official repository (https://repo.papermc.io/repository/maven-public/).

Installing on your server

Copy ThunderTPA-1.0.0.jar into the plugins/ folder of your Paper 26.2 server.
Start (or restart) the server: plugins/ThunderTPA/config.yml will be generated.
Edit config.yml however you like (colors, text, sounds, timings, etc.).
Use /tpadmin reload to apply changes without restarting.

Quick customization

Everything the end user sees — prefix, messages, button text/color, sounds, countdown/cooldown/timeout timings, request limits, sound/particle toggles, cross-world teleporting — lives in config.yml, no code needed. Check the comments inside the file: they're in English and explain every line.

Permissions

Permission	Default	Description
`tpa.use`	true (everyone)	Use the basic TPA commands
`tpa.all`	true (everyone)	Use `/tpaall` to request a teleport from everyone online
`tpa.back`	true (everyone)	Use `/back`
`tpa.admin`	op	Reload the configuration

Technical notes

Written for Paper API 26.2 (io.papermc.paper:paper-api:[26.2.build,)), compatible with the new year.drop numbering scheme introduced by Mojang in 2026.
Uses Adventure/MiniMessage for all text (no legacy &-color-codes).
No external dependency to shade: paper-api is provided since it's already present on the server at runtime.