Chunkwright TPA

Name: Chunkwright TPA
Brand: Chunkwright
SKU: plugin-tpa
Availability: InStock

Free

Free teleport requests with clickable Accept and Deny, menus, a warmup and cooldowns.

Download free

No sign-up. Free for any server you run. Please do not re-upload or sell it. Questions on Discord.

Server: Paper and Purpur
Minecraft: 1.21.4 to 26.1
Java: 21 or newer
Needs: No other plugins
Version: 1.0.0, 2026-10-11
Tested: Tested on real servers: 1,020 checks passed on Paper 1.21.4 to 26.1 and Purpur
Download: 0.05 MB zip

What it does

Players ask to go to a friend with /tpa or ask a friend over with /tpahere. The other player clicks Accept or Deny in chat or answers from a menu. A short warmup with a countdown keeps it fair in fights: moving or taking damage cancels the teleport. Cooldowns, blocked worlds and a requests-off toggle are in the config, and it runs next to EssentialsX.

/tpa and /tpahere, or pick a player from a menu
Clickable Accept, Deny and Menu buttons in chat, with hover text
Incoming requests menu and an accept or deny menu per request
Request timeout with a message to both players
Warmup with an action bar countdown, cancelled by moving or damage
Cooldown between requests and blocked worlds
/tpatoggle to stop getting requests, saved across restarts
Bypass permissions for staff
Works next to EssentialsX, every message in messages.yml (MiniMessage)

Install

Put Tpa-1.0.0.jar in your plugins folder.
Start the server. The plugin writes plugins/Tpa/config.yml and messages.yml.
Change what you like and run /tpaadmin reload.

Requirements

Paper or Purpur 1.21.4 to 26.1
Java 21+

Commands

Aliases: /tpask, /tpyes, /tpno, /tpacancel, /tptoggle, /tprequests.

Command	What it does	Permission
`/tpa`	Pick a player from a menu	`tpa.use`
`/tpa <player>`	Ask to teleport to a player	`tpa.use`
`/tpahere [player]`	Ask a player to teleport to you (menu without a name)	`tpa.here`
`/tpaccept [player]`	Accept a request	`tpa.use`
`/tpdeny [player]`	Deny a request	`tpa.use`
`/tpcancel [player]`	Cancel your request (all of them without a name)	`tpa.use`
`/tpatoggle`	Stop or start getting requests	`tpa.toggle`
`/tpmenu [player]`	Your incoming requests, or the menu of one request	`tpa.use`
`/tpaadmin help, /tpaadmin version`	Help and version	`tpa.use`
`/tpaadmin reload`	Reload config.yml and messages.yml	`tpa.admin`

Permissions

Permission	Default	What it gives
`tpa.use`	everyone	/tpa, /tpaccept, /tpdeny, /tpcancel, /tpmenu
`tpa.here`	everyone	/tpahere
`tpa.toggle`	everyone	/tpatoggle
`tpa.bypass.cooldown`	op	No cooldown
`tpa.bypass.warmup`	op	Teleport at once
`tpa.bypass.worlds`	op	Ignore blocked worlds
`tpa.bypass.toggle`	op	Send requests to players who turned them off
`tpa.admin`	op	/tpaadmin reload

Every setting is in the commented config.yml, and every message in messages.yml (MiniMessage). The README in the zip lists them all.

How we test it

Tested on real servers: 1,020 checks passed on Paper 1.21.4 to 26.1 and Purpur. Every release runs on Paper 1.21.4, 1.21.5, 1.21.8, 1.21.11, 26.1.2 and Purpur 1.21.11, next to LuckPerms, Vault, EssentialsX and PlaceholderAPI. The run covers unit tests, scripted players going through every command and menu, random input, restarts and reloads. In the soak run 12 bots used the plugin nonstop and the server held 20 TPS, at most 1.6 ms per tick on average.

Changelog

1.0.1 2026-10-12

Fixed: a message missing from messages.yml now shows the built-in text instead of a placeholder.

1.0.0 2026-10-11

First release.

/tpa, /tpahere, /tpaccept, /tpdeny, /tpcancel, /tpatoggle, /tpmenu.
Clickable Accept, Deny and Menu buttons in chat.
Player menu, incoming requests menu and an accept/deny menu.
Request timeout, warmup with a countdown that cancels on movement or damage, send cooldown.
Blocked worlds, with a bypass permission.
Requests-off setting saved across restarts.
Paper and Purpur 1.21.4 to 26.1.