授权转载 工具 Nexal TPA ⚡ 传送请求 | 图形界面、预热粒子、可点击聊天、跨服支持 1.0.4

Nexal TPA

传送请求插件，带预热粒子、可点击聊天按钮，以及 BungeeCord 或 Velocity 上的跨服 TPA。


━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> 特性

视觉化玩家选择 GUI
不带参数执行 /tpa 打开玩家头像菜单。左键发送 TPA，右键发送 TPA Here。被屏蔽的玩家显示为灰色。

可点击聊天按钮
每个请求下方直接附带 [接受] 和 [拒绝] 按钮。一键响应，适合手机端和主机端玩家。

粒子光环预热
可配置的预热效果，包含螺旋粒子环和动作栏倒计时。移动或受伤会取消传送，防止战斗滥用。

请求管理 GUI
分页菜单显示待处理请求，包含玩家头像、请求类型和实时倒计时。可在同一界面接受、拒绝或全部拒绝。

个人设置 GUI
每位玩家拥有设置菜单，可开关接收请求、管理已屏蔽玩家。

跨服 TPA
向 BungeeCord 或 Velocity 网络其他服务器的玩家发送请求，无需代理端插件。接受后代理将玩家移动至目标所在服务器。服务器间消息经过签名，移动失败时费用退还。默认关闭。

Vault 经济费用
可选每次传送收费，仅在传送实际发生时扣除，捐赠者组拥有 bypass 权限。费用格式统一显示为 $100、$1,000 或 $1,000.50。

传送历史
保存所有请求记录，分页查看：类型、方向、结束方式（已传送、预热取消、费用未付）以及实际扣除的费用。

战斗保护
战斗中禁止 TPA，可配置战斗标签时长，在发送请求和接受请求时都会检查，防止玩家脱离战斗。

世界控制
在特定世界禁用 TPA（禁止发出和传入），或完全禁止跨世界传送。

管理员菜单
/tpa admin 可在游戏内修改主要设置（开关、计时器、费用、预热粒子），直接保存到 config.yml，并支持重载、导出和导入数据。

更多功能

> TPA 与 TPA Here：传送到玩家身边，或请求对方传送到你身边
> 冷却与超时：限制请求刷屏；请求在可配置时间后过期
> 屏蔽与开关：屏蔽单个玩家或完全停止接收请求
> 请求上限：限制每位玩家待处理的传入请求数量
> 双存储：JSON 文件或 MySQL 数据库，网络内多台服务器可共享；支持相互导出导入
> PlaceholderAPI：待处理请求数、TPA 状态、屏蔽数量等
> 自定义文本：所有消息、聊天按钮、动作栏和菜单文本均在 messages.yml 中，含音效和标题
> 短命令：/tpaccept、/tpdeny、/tpahere 等开箱即用，也支持 /tpa 子命令形式

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> 命令

玩家命令：
/tpa <玩家> 请求传送到某玩家
/tpahere <玩家> 请求某玩家传送到你身边
/tpaccept [玩家] 接受传入请求
/tpdeny [玩家] 拒绝传入请求
/tpacancel 取消你发出的请求
/tpatoggle 开关接收请求
/tpblock <玩家> 屏蔽某玩家
/tpunblock <玩家> 取消屏蔽
/tpa list 查看待处理请求
/tpa settings 打开设置 GUI
/tpa history 查看传送历史

管理员命令：
/tpa admin 打开管理菜单（游戏内修改设置）
/tpa admin reload 重载配置
/tpa admin export 导出数据
/tpa admin import 导入数据

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> 权限

nexaltpa.tpa - 发送 TPA 请求（默认：true）
nexaltpa.tpahere - 发送 TPA Here 请求（默认：true）
nexaltpa.accept - 接受请求（默认：true）
nexaltpa.deny - 拒绝请求（默认：true）
nexaltpa.cancel - 取消发出的请求（默认：true）
nexaltpa.toggle - 开关 TPA（默认：true）
nexaltpa.block - 屏蔽玩家（默认：true）
nexaltpa.unblock - 取消屏蔽（默认：true）
nexaltpa.list - 查看请求 GUI（默认：true）
nexaltpa.settings - 打开设置 GUI（默认：true）
nexaltpa.history - 查看传送历史（默认：true）
nexaltpa.bypass.cooldown - 绕过请求冷却（默认：op）
nexaltpa.bypass.fee - 免费传送（默认：false）
nexaltpa.admin - 管理员菜单及所有管理员命令（默认：op）
nexaltpa.admin.reload - 重载配置
nexaltpa.admin.export - 导出数据
nexaltpa.admin.import - 导入数据

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> PlaceholderAPI

%nexaltpa_pending_requests% - 待处理传入请求数量
%nexaltpa_tpa_enabled% - TPA 是否开启（Yes/No）
%nexaltpa_tpa_enabled_status% - 带颜色的开启/关闭状态
%nexaltpa_blocked_count% - 已屏蔽玩家数量
%nexaltpa_has_outgoing% - 是否有发出的请求（Yes/No）
%nexaltpa_history_count% - 历史记录条数

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> 配置示例

request-timeout: 60
cooldown: 10
allow-in-combat: false
combat-tag-duration: 10
warmup: 3

warmup-particles:
enabled: true
type: PORTAL
count: 15
radius: 0.8
update-interval: 2

disabled-worlds: []
allow-cross-world: true
warmup-cancel-on-damage: true

clickable-messages:
enabled: true

cross-server:
enabled: false
type: bungee

economy:
enabled: false
tpa-fee: 100.0

history:
max-entries-per-player: 50

storage:
type: json
# 可选 sql

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> 要求

Java 17+
Spigot 或 Paper 1.20 至 26.3
Vault（可选，用于传送费用）
PlaceholderAPI（可选，用于占位符）
BungeeCord 或 Velocity（可选，用于跨服 TPA；无需代理端插件）

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

> 支持

原帖：SpigotMC
文档：https://docs.nexalstudios.com/docs/plugins/nexaltpa/
Discord：原帖获取