FancyTPA

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11 26.1 26.1.1 26.1.2

平台： paper purpur

标签： adventure game-mechanics utility

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

| Command | Description | Permission |
| --- | --- | --- |
| /tpa <player> | Send a teleport request to another player. | fancytpa.tpa |
| /tpahere <player> | Request another player to teleport to you. | fancytpa.tpahere |
| /tpaccept / /tpyes | Accept the latest pending request. | fancytpa.accept |
| /tpacancel / /tpdeny / /tpno | Deny or cancel a pending request. | fancytpa.deny |
| /tpawithdraw / /tpaundo | Withdraw a request you sent. | fancytpa.withdraw |
| /tpatoggle | Toggle whether you receive TPA requests. | fancytpa.toggle |
| /tpaauto | Toggle auto-accept for TPA requests. | fancytpa.auto |
| /tpagui | Open the player selection GUI. | fancytpa.gui |
| /tpareload | Reload config, messages, homes, and warps. | fancytpa.reload |

Homes

| Command | Description | Permission |
| --- | --- | --- |
| /home / /homes / /fhome | Open the home GUI. | fancytpa.home |
| /sethome [slot] | Save your current location into a home slot. | fancytpa.home.set |
| /delhome <slot> | Delete a home slot. | fancytpa.home.delete |

Warps

| Command | Description | Permission |
| --- | --- | --- |
| /warp [name] / /warps / /fwarp | Open the warp GUI or teleport to a warp. | fancytpa.warp |
| /setwarp <name> [displayName] [lore...] | Create a new warp at your current location. | fancytpa.admin |
| /delwarp <name> / /deletewarp / /removewarp | Delete a warp. | fancytpa.admin |

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.