⚡ SimpleTPA+ | 终极现代传送系统
SimpleTPA+ 是一款高性能、轻量且功能丰富的传送插件,专为 Paper、Purpur 和 Spigot(1.19 – 1.21+)从头开发。旨在提供流畅、互动且高品质的玩家体验,同时避免占用过多服务器资源!
✨ 核心亮点与功能
- ? 异步与超高性能: 基于现代 Adventure API 和 Kyori 组件构建,能够异步处理文本、音效、动作栏及粒子效果,零主线程延迟。
- ? 交互式在线玩家 GUI (
/tpa): 不带参数运行 /tpa 将打开一个完全分页的动态库存菜单,其中包含在线玩家头像、TPA 状态指示器以及一键发送请求功能!
- ? 可点击的交互式聊天卡片: 当玩家收到 TPA 请求时,会收到格式精美、类似嵌入式的聊天卡片,带有带悬停提示的可点击
[ ACCEPT ] 和 [ DENY ] 按钮。
- ? 音调缩放音频与粒子效果: 倒计时期间具有渐进式音频音调缩放功能,并在传送准备和到达时提供完全可定制的粒子爆发效果。
- ⏱️ 实时动作栏倒计时: 在传送过程中,直接在玩家快捷栏上方显示平滑的视觉倒计时。
- ?️ 防移动安全系统: 如果旅行者移动,传送将自动取消。旅行者和目标玩家都会立即收到解释为何中止的通知!
- ? 出站请求取消 (
/tpacancel): 玩家可以在请求过期或被接受之前的任何时间取消待处理的出站 TPA 请求。
- ? 请求锁定与防垃圾信息: 防止玩家 spam 多个活跃的 TPA 请求。在请求过期、被接受或被拒绝之前,玩家一次只能有一个活跃的出站请求。
- ⚙️ 玩家 TPA 开关与管理员绕过: 玩家可以使用
/tpatoggle 禁用传入的 TPA 请求。如果启用,拥有绕过权限的管理员成员仍可以发送必要的请求。
- ? 内置反馈系统 (
/tpafeedback): 允许玩家直接从游戏中向开发人员提交反馈或报告问题。
- ?️ 100% 完全可定制:
config.yml 中可编辑每一条消息、前缀、按钮标签、GUI 布局、粒子类型、音效和倒计时持续时间!
? 如何使用 SimpleTPA+(分步指南)
1. 发送传送请求
- 使用 GUI: 输入
/tpa(不带参数)以打开 在线玩家菜单。点击任何玩家的头像即可即时发送请求!
- 直接命令: 输入
/tpa <player> 以请求传送到特定玩家。
- 如果您已经有待处理的活跃请求,插件将阻止您发送另一个请求,直到第一个请求得到解决、取消或过期。
2. 接受、拒绝或取消请求
- 目标玩家: 当有人向您发送 TPA 请求时,会出现带有交互按钮的自定义聊天卡片:
- 点击
[ ACCEPT ](或输入 /tpaccept):接受请求并启动发送者的传送倒计时。
- 点击
[ DENY ](或输入 /tpdeny):拒绝请求并立即通知发送者。
- 发送者玩家: 改变主意了?输入
/tpacancel 在被接受之前取消您活跃的出站请求。
3. 在传送倒计时期间
- 一旦接受,发送者的动作栏上会出现倒计时(例如 5 秒),并伴有渐进式音频铃声和传送门粒子效果。
- 关键: 旅行者必须完全静止不动。
- 如果玩家移动超过 0.2 格,传送将立即中止,播放取消音效,并通知双方玩家。
4. 开启/关闭请求
- 输入
/tpatoggle(或在 /tpa GUI 中点击自己的状态头像)以阻止传入的 TPA 请求。
- 再次执行该命令将为您的账户重新启用传入请求。
5. 提交反馈
- 输入
/tpafeedback <your message> 直接向开发人员发送评论或错误报告。
? 命令与命令参考
| 命令 |
描述 |
权限节点 |
默认访问权限 |
/tpa |
打开在线玩家 GUI 菜单。 |
simpletpa.use |
所有人 (true) |
/tpa <player> |
发送直接传送请求。 |
simpletpa.use |
所有人 (true) |
/tpaccept |
接受待处理的传送请求。 |
simpletpa.use |
所有人 (true) |
/tpdeny |
拒绝待处理的传送请求。 |
simpletpa.use |
所有人 (true) |
/tpacancel |
取消您活跃的出站请求。 |
simpletpa.use |
所有人 (true) |
/tpatoggle |
切换接收传入 TPA 请求的状态。 |
simpletpa.use |
所有人 (true) |
/tpafeedback <msg> |
向插件开发人员发送直接反馈。 |
simpletpa.use |
所有人 (true) |
/tpahelp |
显示交互式帮助菜单。 |
simpletpa.use |
所有人 (true) |
/tpareload |
实时重载插件配置。 |
simpletpa.admin.reload |
管理员 / OP |
? 权限指南
SimpleTPA+ 使用清晰直观的权限节点。默认情况下,标准玩家权限会自动授予(default: true),而管理功能则锁定给服务器操作员(default: op)。
| 权限节点 |
描述 |
默认访问权限 |
推荐组别 |
simpletpa.use |
授予对标准命令(/tpa, /tpaccept, /tpdeny, /tpacancel, /tpatoggle, /tpahelp, /tpafeedback)的访问权限。 |
true (所有玩家) |
默认 / 成员 |
simpletpa.admin.reload |
允许通过 /tpareload 实时重载 config.yml 文件。 |
op (仅限管理员) |
管理员 / 所有者 |
simpletpa.bypass.toggle |
允许向已关闭请求的玩家发送 TPA 请求(需要在配置中设置 allow-bypass: true)。 |
op (仅限管理员) |
版主 / 管理员 |
⚙️ 权限管理器(LuckPerms)示例配置
# 普通玩家:
/lp group default permission set simpletpa.use true
# 工作人员 / 管理员(绕过开关):
/lp group moderator permission set simpletpa.bypass.toggle true
# 服务器管理员:
/lp group admin permission set simpletpa.admin.reload true
⚡ SimpleTPA+ | The Ultimate Modern Teleportation System
SimpleTPA+ is a high-performance, lightweight, and feature-rich teleportation plugin built from the ground up for Paper, Purpur, and Spigot (1.19 – 1.21+). Designed to deliver a smooth, interactive, and premium player experience without bloating server resources!
✨ Key Highlights & Features
- ? Async & Ultra-Performant: Built using modern Adventure API and Kyori components to process text, sound effects, action bars, and particle effects asynchronously with zero main-thread lag.
- ? Interactive Online Players GUI (
/tpa): Running /tpa without arguments opens a fully paginated, dynamic inventory menu featuring online player heads, TPA status indicators, and one-click request sending!
- ? Clickable Interactive Chat Cards: When a player receives a TPA request, they get a beautifully formatted, embed-like chat card with clickable
[ ACCEPT ] and [ DENY ] buttons featuring hover text.
- ? Pitch-Scaled Audio & Particle Effects: Features progressive audio pitch scaling during countdowns, alongside fully customizable particle bursts during teleport preparation and arrival.
- ⏱️ Real-time Action Bar Countdown: Smooth visual countdown displayed directly above the player's hotbar during teleportation.
- ?️ Anti-Movement Safety System: Teleportation automatically cancels if the traveler moves. Both the traveler and the target player receive immediate notifications explaining why it was aborted!
- ? Outgoing Request Cancellation (
/tpacancel): Players can cancel their pending outgoing TPA request at any time before it expires or gets accepted.
- ? Request Locking & Anti-Spam: Prevents players from spamming multiple active TPA requests. Players can only have one active outgoing request at a time until it expires, is accepted, or is rejected.
- ⚙️ Player TPA Toggle & Staff Bypass: Players can disable incoming TPA requests using
/tpatoggle. Staff members with the bypass permission can still send essential requests if enabled.
- ? Built-in Feedback System (
/tpafeedback): Allows players to submit feedback or report issues directly to developers right from in-game.
- ?️ 100% Fully Customizable: Every single message, prefix, button label, GUI layout, particle type, sound effect, and countdown duration can be edited in
config.yml!
? How to Use SimpleTPA+ (Step-by-Step Guide)
1. Sending a Teleport Request
- Using the GUI: Type
/tpa (without arguments) to open the Online Players Menu. Click on any player's head to send a request instantly!
- Direct Command: Type
/tpa <player> to request a direct teleport to a specific player.
- If you already have an active request pending, the plugin will block you from sending another until the first one is resolved, canceled, or expires.
2. Accepting, Denying, or Canceling Requests
- Target Player: When someone sends you a TPA request, a custom chat card appears with interactive buttons:
- Click
[ ACCEPT ] (or type /tpaccept): Accepts the request and initiates the teleport countdown for the sender.
- Click
[ DENY ] (or type /tpdeny): Rejects the request and notifies the sender immediately.
- Sender Player: Changed your mind? Type
/tpacancel to cancel your active outgoing request before it gets accepted.
3. During the Teleport Countdown
- Once accepted, a countdown (e.g., 5 seconds) appears on the sender's Action Bar accompanied by progressive audio chimes and portal particles.
- CRITICAL: The traveling player must stand completely still.
- If the player moves more than 0.2 blocks, the teleportation is instantly aborted, cancellation sounds play, and both players are notified.
4. Toggling Requests On/Off
- Type
/tpatoggle (or click your own status head in the /tpa GUI) to block incoming TPA requests.
- Executing the command again will re-enable incoming requests for your account.
5. Submitting Feedback
- Type
/tpafeedback <your message> to send comments or bug reports straight to the developers.
? Commands & Command Reference
| Command |
Description |
Permission Node |
Default Access |
/tpa |
Open online players GUI menu. |
simpletpa.use |
Everyone (true) |
/tpa <player> |
Send a direct teleport request. |
simpletpa.use |
Everyone (true) |
/tpaccept |
Accept a pending teleport request. |
simpletpa.use |
Everyone (true) |
/tpdeny |
Deny a pending teleport request. |
simpletpa.use |
Everyone (true) |
/tpacancel |
Cancel your active outgoing request. |
simpletpa.use |
Everyone (true) |
/tpatoggle |
Toggle receiving incoming TPA requests. |
simpletpa.use |
Everyone (true) |
/tpafeedback <msg> |
Send direct feedback to plugin developers. |
simpletpa.use |
Everyone (true) |
/tpahelp |
Display the interactive help menu. |
simpletpa.use |
Everyone (true) |
/tpareload |
Reload the plugin configuration in real-time. |
simpletpa.admin.reload |
Admins / OP |
? Permissions Guide
SimpleTPA+ uses clean, intuitive permission nodes. By default, standard player permissions are granted automatically (default: true), while administrative functions are locked to Server Operators (default: op).
| Permission Node |
Description |
Default Access |
Recommended Group |
simpletpa.use |
Grants access to standard commands (/tpa, /tpaccept, /tpdeny, /tpacancel, /tpatoggle, /tpahelp, /tpafeedback). |
true (All Players) |
Default / Member |
simpletpa.admin.reload |
Allows reloading the config.yml file in real-time via /tpareload. |
op (Admins Only) |
Admin / Owner |
simpletpa.bypass.toggle |
Allows sending TPA requests to players who have toggled requests off (Requires allow-bypass: true in config). |
op (Admins Only) |
Moderator / Admin |
⚙️ Example Setup for Permission Managers (LuckPerms)
# For Regular Players:
/lp group default permission set simpletpa.use true
# For Staff / Moderators (Bypass Toggle):
/lp group moderator permission set simpletpa.bypass.toggle true
# For Server Admins:
/lp group admin permission set simpletpa.admin.reload true
评论 0
登录后参与评分
还没有评论,来抢沙发吧