# FancyTPA<\/p>\n
FancyTPA is a Paper plugin for Minecraft 1.21+ that adds a polished teleport system with GUI menus, configurable countdowns, safety checks, homes, warps, and `\/back` support. The codebase is split into small layers so commands stay thin and the actual logic lives in managers.<\/p>\n
## Features<\/p>\n
– **TPA \/ TPAHere** with request expiry, withdraw support, toggle, and auto-accept. ## Installation<\/p>\n 1. Download the plugin JAR and place it in your server’s `plugins\/` folder. ## Commands and Permissions<\/p>\n ### TPA ### Homes ### Warps ### Back<\/p>\n | Command | Description | Permission | ## Configuration Highlights<\/p>\n ### `config.yml`<\/p>\n – `settings.teleport-delay`: countdown before teleporting. ### `messages.yml`<\/p>\n – Uses **MiniMessage** formatting. ## Storage and Runtime Files<\/p>\n FancyTPA creates and manages these files in the plugin data folder:<\/p>\n – `config.yml` Home data is stored per player UUID and warp names are saved case-insensitively.<\/p>\n ## PlaceholderAPI<\/p>\n FancyTPA registers a PlaceholderAPI expansion with the identifier `fancytpa`.<\/p>\n Available placeholders:<\/p>\n – `%fancytpa_tpatoggle%` Each placeholder returns `Enabled` or `Disabled` based on the player’s current state.<\/p>\n","protected":false},"excerpt":{"rendered":" FancyTPA brings modern TPA, HOME, and WARP features to your server with sleek GUIs, countdowns, and fully configurable behavior.<\/p>\n","protected":false},"featured_media":68691,"template":"","meta":{"_minecraft_slug":"fancytpa-lyrinth","_minecraft_project_id":"Me7EaUfj","_minecraft_author":"nqanh2k6","_minecraft_license":"MIT","_minecraft_downloads":4,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"fancytpa-lyrinth.zip","_minecraft_size_bytes":98869,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-16T12:13:34.729182Z","_minecraft_date_created":"2026-05-12T00:32:08.475398Z","_minecraft_date_modified":"2026-05-04T05:51:07.095876Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/fancytpa-lyrinth","_minecraft_icon_attachment_id":68691,"_minecraft_imported_at":"2026-06-03T22:04:29+00:00","_minecraft_import_hash":"b153e043a70590056e2a3122a67a7027","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[87,89,126,127,128,92],"mod_loader":[132,133],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-68690","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-adventure","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-utility","mod_loader-paper","mod_loader-purpur","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","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\n– **GUI player selector** for `\/tpagui`, built with `InventoryHolder` menus instead of title checks.
\n– **Homes** with per-player slot limits driven by permissions like
\n`fancytpa.home.max.
\n– **Warps** with GUI browsing, tab completion, and case-insensitive lookup.
\n– **\/back** for returning to a previous teleport or death location.
\n– **Countdown teleport flow** for TPA, homes, warps, and `\/back`.
\n– **Safety checks** that prevent unsafe destinations and can fall back to a nearby safe location.
\n– **Config-driven sounds** and **MiniMessage**-based messages.
\n– **PlaceholderAPI support** for `%fancytpa_tpatoggle%` and `%fancytpa_tpaauto%`.<\/p>\n
\n2. Install PlaceholderAPI only if you want to use placeholders.<\/p>\n
\n
\n
\n
\n| Command | Description | Permission |
\n| — | — | — |
\n| `\/tpa
\n| `\/tpahere
\n| `\/tpaccept` \/ `\/tpyes` | Accept the latest pending request. | `fancytpa.accept` |
\n| `\/tpacancel` \/ `\/tpdeny` \/ `\/tpno` | Deny or cancel a pending request. | `fancytpa.deny` |
\n| `\/tpawithdraw` \/ `\/tpaundo` | Withdraw a request you sent. | `fancytpa.withdraw` |
\n| `\/tpatoggle` | Toggle whether you receive TPA requests. | `fancytpa.toggle` |
\n| `\/tpaauto` | Toggle auto-accept for TPA requests. | `fancytpa.auto` |
\n| `\/tpagui` | Open the player selection GUI. | `fancytpa.gui` |
\n| `\/tpareload` | Reload config, messages, homes, and warps. | `fancytpa.reload` |<\/p>\n
\n
\n| Command | Description | Permission |
\n| — | — | — |
\n| `\/home` \/ `\/homes` \/ `\/fhome` | Open the home GUI. | `fancytpa.home` |
\n| `\/sethome [slot]` | Save your current location into a home slot. | `fancytpa.home.set` |
\n| `\/delhome
\n
\n| Command | Description | Permission |
\n| — | — | — |
\n| `\/warp [name]` \/ `\/warps` \/ `\/fwarp` | Open the warp GUI or teleport to a warp. | `fancytpa.warp` |
\n| `\/setwarp
\n| `\/delwarp
\n| — | — | — |
\n| `\/back` \/ `\/fback` | Return to your previous location. | `fancytpa.back` |<\/p>\n
\n– `settings.request-expiry`: how long a pending TPA request stays valid.
\n– `settings.cancel-on-move`: cancel countdown when the player changes block coordinates.
\n– `settings.back.back-on-death` and `settings.back.back-on-teleport`: control what `\/back` stores.
\n– `settings.back.allowed-worlds`: restrict `\/back` to specific worlds, or use `*` for all worlds.
\n– `world-restriction.enabled` and `world-restriction.type`: apply a global whitelist\/blacklist for all plugin commands.
\n– `sounds.*`: fully configurable sounds for GUI open, request sent\/received, countdown, teleport success, cancellation, and home\/back actions.<\/p>\n
\n– Messages are versioned and automatically merged when the plugin ships new keys.
\n– `{prefix}` is cached and injected into messages automatically.<\/p>\n
\n– `messages.yml`
\n– `homes.yml`
\n– `warps.yml`<\/p>\n
\n– `%fancytpa_tpaauto%`<\/p>\n