# TPA DonutSMP<\/p>\n
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.<\/p>\n
## Features<\/p>\n
– Full TPA command suite: `\/tpa`, `\/tpahere`, `\/tpaccept`, `\/tpdeny`, `\/tpacancel`, `\/tpatoggle`, `\/tpareload`.
\n– Safe-Teleport (safeplace) checks destinations for lava, fire, suffocation and void and searches for the nearest safe location before teleporting.
\n– Warmup and cooldown support with bypass permissions for VIPs\/staff.
\n– Clickable chat components (`[ACCEPT]` \/ `[DENY]`) and optional 3-row GUI request popup (player head + green\/red wool).
\n– Configurable cancel-on-move and cancel-on-damage behavior.
\n– Full MiniMessage support for colored\/gradient\/hex messages and PlaceholderAPI support for placeholders.
\n– bStats metrics support (configure your plugin id in the main class).<\/p>\n
## Commands & Permissions<\/p>\n
– `tpa.use` \u2014 Use basic TPA commands (default: true)
\n– `tpa.bypass.warmup` \u2014 Bypass teleport warmup (default: op)
\n– `tpa.bypass.cooldown` \u2014 Bypass cooldown between teleports (default: op)
\n– `tpa.admin` \u2014 Reload config and admin actions (default: op)<\/p>\n
Example commands:<\/p>\n
– `\/tpa ## Config (high level)<\/p>\n The plugin ships with `config.yml` exposing:<\/p>\n – `settings.warmup` \u2014 Warmup time in seconds before teleport. Use MiniMessage tags and hex colors in `messages.*` entries. PlaceholderAPI placeholders are expanded when PlaceholderAPI is present.<\/p>\n ## Notes for Server Owners<\/p>\n – bStats ID is left as a placeholder \u2014 edit `TPADonutSMPPlugin` to set your Modrinth\/bStats id. ## Technical<\/p>\n – Java: 17+ This plugin brings TPA from Donut SMP to your server. Fully customisable for easy use with permissions for roles.<\/p>\n","protected":false},"featured_media":158784,"template":"","meta":{"_minecraft_slug":"tpa-donutsmp","_minecraft_project_id":"lDm7LUAX","_minecraft_author":"dominik-kaspar-dev","_minecraft_license":"MIT","_minecraft_downloads":30,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"tpa-donutsmp.zip","_minecraft_size_bytes":1126347,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T22:45:25.701791Z","_minecraft_date_created":"2026-05-14T03:25:48.924192Z","_minecraft_date_modified":"2026-05-14T06:27:50.227712Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/tpa-donutsmp","_minecraft_icon_attachment_id":158784,"_minecraft_imported_at":"2026-06-09T13:54:36+00:00","_minecraft_import_hash":"339dbca173966294896bd5aff975ab09","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,127,867,869,92],"mod_loader":[130,132],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-158783","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-paper","mod_category-social","mod_category-transportation","mod_category-utility","mod_loader-bukkit","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/tpahere
\n– `\/tpaccept` \u2014 Accept incoming request.
\n– `\/tpdeny` \u2014 Deny incoming request.
\n– `\/tpacancel` \u2014 Cancel your outgoing request.
\n– `\/tpatoggle` \u2014 Toggle incoming requests on\/off.
\n– `\/tpareload` \u2014 Reload `config.yml` (requires `tpa.admin`).<\/p>\n
\n– `settings.cooldown` \u2014 Seconds between requests.
\n– `settings.request-expire` \u2014 Request lifetime (default 60s).
\n– `settings.cancel-on-move` \/ `settings.cancel-on-damage` \u2014 Cancel warmup.
\n– `settings.safe-teleport-enabled` \u2014 Toggle safeplace logic.
\n– `settings.safe-search-radius` \/ `settings.safe-search-vertical` \u2014 Safe search area.
\n– `gui.enabled` \u2014 Enable the 3-row GUI popup.
\n– `messages.*` \u2014 All user-facing text (MiniMessage-compatible).<\/p>\n
\n– Toggle state for incoming requests is in-memory by default (resets on restart). If you want persistence I can add a small storage layer.
\n– Safeplace logic uses a configurable radius\/vertical search; on very large servers you may want to reduce the search area.<\/p>\n
\n– Target: Paper (1.21+ recommended)
\n– Optional: PlaceholderAPI (softdepend)<\/p>\n","protected":false},"excerpt":{"rendered":"