TPA DonutSMP

A highly-configurable 1:1 replica of the DonutSMP TPA system for Paper servers (Java 17). Features Safe-Teleport logic, a modern GUI request popup, MiniMessage messages, PlaceholderAPI integration and optional bStats metrics.

Features

Full TPA command suite: /tpa, /tpahere, /tpaccept, /tpdeny, /tpacancel, /tpatoggle, /tpareload.
Safe-Teleport (safeplace) checks destinations for lava, fire, suffocation and void and searches for the nearest safe location before teleporting.
Warmup and cooldown support with bypass permissions for VIPs/staff.
Clickable chat components ([ACCEPT] / [DENY]) and optional 3-row GUI request popup (player head + green/red wool).
Configurable cancel-on-move and cancel-on-damage behavior.
Full MiniMessage support for colored/gradient/hex messages and PlaceholderAPI support for placeholders.
bStats metrics support (configure your plugin id in the main class).

Commands & Permissions

tpa.use — Use basic TPA commands (default: true)
tpa.bypass.warmup — Bypass teleport warmup (default: op)
tpa.bypass.cooldown — Bypass cooldown between teleports (default: op)
tpa.admin — Reload config and admin actions (default: op)

Example commands:

/tpa <player> — Request to teleport to a player.
/tpahere <player> — Request that a player teleport to you.
/tpaccept — Accept incoming request.
/tpdeny — Deny incoming request.
/tpacancel — Cancel your outgoing request.
/tpatoggle — Toggle incoming requests on/off.
/tpareload — Reload config.yml (requires tpa.admin).

Config (high level)

The plugin ships with config.yml exposing:

settings.warmup — Warmup time in seconds before teleport.
settings.cooldown — Seconds between requests.
settings.request-expire — Request lifetime (default 60s).
settings.cancel-on-move / settings.cancel-on-damage — Cancel warmup.
settings.safe-teleport-enabled — Toggle safeplace logic.
settings.safe-search-radius / settings.safe-search-vertical — Safe search area.
gui.enabled — Enable the 3-row GUI popup.
messages.* — All user-facing text (MiniMessage-compatible).

Use MiniMessage tags and hex colors in messages.* entries. PlaceholderAPI placeholders are expanded when PlaceholderAPI is present.

Notes for Server Owners

bStats ID is left as a placeholder — edit TPADonutSMPPlugin to set your Modrinth/bStats id.
Toggle state for incoming requests is in-memory by default (resets on restart). If you want persistence I can add a small storage layer.
Safeplace logic uses a configurable radius/vertical search; on very large servers you may want to reduce the search area.

Technical

Java: 17+
Target: Paper (1.21+ recommended)
Optional: PlaceholderAPI (softdepend)