FancyTPA
FancyTPA 是一款适用于 Minecraft 1.21+ 的 Paper 插件,它添加了一个经过精心打磨的传送系统,包含 GUI 菜单、可配置的倒计时、安全检查、家(Homes)、传送点(Warps)以及 /back 支持。代码库被拆分为多个小层级,使得命令保持简洁,而实际逻辑则由管理器处理。
功能特性
- TPA / TPAHere:支持请求过期、撤回支持、开关切换和自动接受。
- GUI 玩家选择器:用于
/tpagui,基于 InventoryHolder 菜单构建,而非标题检查。
- 家(Homes):每个玩家拥有由权限(如
fancytpa.home.max.<number>)驱动的槽位限制。
- 传送点(Warps):支持 GUI 浏览、Tab 补全和大小写不敏感的查找。
- /back:返回到之前的传送或死亡位置。
- 倒计时传送流程:适用于 TPA、家、传送点和
/back。
- 安全检查:防止传送到不安全的位置,并可回退到附近的安全地点。
- 配置驱动的声音和基于 MiniMessage 的消息。
- PlaceholderAPI 支持:提供
%fancytpa_tpatoggle% 和 %fancytpa_tpaauto%。
安装
- 下载插件 JAR 文件并将其放入服务器的
plugins/ 文件夹中。
- 仅在使用占位符时安装 PlaceholderAPI。
命令与权限
TPA

| 命令 |
描述 |
权限 |
/tpa <player> |
向其他玩家发送传送请求。 |
fancytpa.tpa |
/tpahere <player> |
请求其他玩家传送到你身边。 |
fancytpa.tpahere |
/tpaccept / /tpyes |
接受最新的待处理请求。 |
fancytpa.accept |
/tpacancel / /tpdeny / /tpno |
拒绝或取消待处理的请求。 |
fancytpa.deny |
/tpawithdraw / /tpaundo |
撤回你发送的请求。 |
fancytpa.withdraw |
/tpatoggle |
切换是否接收 TPA 请求。 |
fancytpa.toggle |
/tpaauto |
切换 TPA 请求的自动接受状态。 |
fancytpa.auto |
/tpagui |
打开玩家选择 GUI。 |
fancytpa.gui |
/tpareload |
重新加载配置、消息、家和传送点。 |
fancytpa.reload |
Homes

| 命令 |
描述 |
权限 |
/home / /homes / /fhome |
打开家 GUI。 |
fancytpa.home |
/sethome [slot] |
将当前位置保存到家的槽位中。 |
fancytpa.home.set |
/delhome <slot> |
删除一个家槽位。 |
fancytpa.home.delete |
Warps

| 命令 |
描述 |
权限 |
/warp [name] / /warps / /fwarp |
打开传送点 GUI 或传送到某个传送点。 |
fancytpa.warp |
/setwarp <name> [displayName] [lore...] |
在当前所在位置创建一个新的传送点。 |
fancytpa.admin |
/delwarp <name> / /deletewarp / /removewarp |
删除一个传送点。 |
fancytpa.admin |
Back
| 命令 |
描述 |
权限 |
/back / /fback |
返回到你之前的位置。 |
fancytpa.back |
配置亮点
config.yml
settings.teleport-delay: 传送前的倒计时时间。
settings.request-expiry: 待处理 TPA 请求的有效时长。
settings.cancel-on-move: 当玩家改变方块坐标时取消倒计时。
settings.back.back-on-death 和 settings.back.back-on-teleport: 控制 /back 存储的内容。
settings.back.allowed-worlds: 限制 /back 仅在特定世界使用,或使用 * 允许所有世界。
world-restriction.enabled 和 world-restriction.type: 对所有插件命令应用全局白名单/黑名单。
sounds.*: 完全可配置的声音,包括 GUI 打开、请求发送/接收、倒计时、传送成功、取消以及家/返回动作的声音。
messages.yml
- 使用 MiniMessage 格式。
- 消息具有版本控制,并在插件发布新键时自动合并。
{prefix} 会被缓存并自动注入到消息中。
存储与运行时文件
FancyTPA 会在插件数据文件夹中创建并管理以下文件:
config.yml
messages.yml
homes.yml
warps.yml
家数据按玩家 UUID 存储,传送点名称以大小写不敏感的方式保存。
PlaceholderAPI
FancyTPA 注册了一个标识符为 fancytpa 的 PlaceholderAPI 扩展。
可用的占位符:
%fancytpa_tpatoggle%
%fancytpa_tpaauto%
每个占位符根据玩家的当前状态返回 Enabled 或 Disabled。
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
- Download the plugin JAR and place it in your server's
plugins/ folder.
- 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
| Command |
Description |
Permission |
/back / /fback |
Return to your previous location. |
fancytpa.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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧