FancyTPA

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.

Features

• TPA / TPAHere with request expiry, withdraw support, toggle, and auto-accept.
• GUI player selector for /tpagui, built with InventoryHolder menus instead of title checks.
• Homes with per-player slot limits driven by permissions like fancytpa.home.max.<number>.
• Warps with GUI browsing, tab completion, and case-insensitive lookup.
• /back for returning to a previous teleport or death location.
• Countdown teleport flow for TPA, homes, warps, and /back.
• Safety checks that prevent unsafe destinations and can fall back to a nearby safe location.
• Config-driven sounds and MiniMessage-based messages.
• PlaceholderAPI support for %fancytpa_tpatoggle% and %fancytpa_tpaauto%.

Installation

1. Download the plugin JAR and place it in your server's plugins/ folder.
2. Install PlaceholderAPI only if you want to use placeholders.

Commands and Permissions

TPA

Homes

Warps

Back

Configuration Highlights

config.yml

• settings.teleport-delay: countdown before teleporting.
• settings.request-expiry: how long a pending TPA request stays valid.
• settings.cancel-on-move: cancel countdown when the player changes block coordinates.
• settings.back.back-on-death and settings.back.back-on-teleport: control what /back stores.
• settings.back.allowed-worlds: restrict /back to specific worlds, or use * for all worlds.
• world-restriction.enabled and world-restriction.type: apply a global whitelist/blacklist for all plugin commands.
• sounds.*: fully configurable sounds for GUI open, request sent/received, countdown, teleport success, cancellation, and home/back actions.

messages.yml

• Uses MiniMessage formatting.
• Messages are versioned and automatically merged when the plugin ships new keys.
• {prefix} is cached and injected into messages automatically.

Storage and Runtime Files

FancyTPA creates and manages these files in the plugin data folder:

• config.yml
• messages.yml
• homes.yml
• warps.yml

Home data is stored per player UUID and warp names are saved case-insensitively.

PlaceholderAPI

FancyTPA registers a PlaceholderAPI expansion with the identifier fancytpa.

Available placeholders:

• %fancytpa_tpatoggle%
• %fancytpa_tpaauto%

Each placeholder returns Enabled or Disabled based on the player's current state.