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)