TpaGui
一个 Paper 插件,为你的 TPA 插件添加图形界面:Java 玩家使用箱子 GUI,基岩版使用原生表单,1.21.6+ 版本支持原生的 Dialog 请求提示,以及 Velocity 跨服务器玩家列表。
TpaGui 本身不实现传送功能——它作为现有 TPA 插件(如 EssentialsX、HuskHomes 等)之上的 GUI 层工作,并与其中任意一个配合使用。
快速开始
- 将 jar 文件放入
plugins/文件夹并重启服务器 - 检查
plugins/TpaGui/config.yml中的commands.listen-commands是否与你的 TPA 插件匹配(默认值:tpa/tpahere) - 玩家运行
/tpagui打开菜单,点击头像发送请求
功能
Java 版
- 带有在线玩家头像的箱子 GUI:左键点击执行
/tpa,右键点击执行/tpahere - 分页功能,包含上一页/下一页按钮;隐身玩家自动隐藏(兼容 SuperVanish)
- 可配置的返回按钮(自定义材质,点击时运行任意命令,例如
/cd以返回主菜单) - 在 1.21.6+ 版本中,传入的请求可以显示原生的接受/拒绝 Dialog(需要数据包;若未安装则自动回退到聊天消息)
基岩版 (Geyser/Floodgate)
- 自动检测基岩版玩家并提供 Cumulus 表单
- 带有头像和分页的玩家列表;传送请求以接受/拒绝弹窗形式展示
- 返回按钮的命令可与 Java 版分开配置(例如
/gmenu)
Velocity 跨服务器
- 从 Velocity 代理同步全网络玩家列表;跨服务器发送传送请求
- 可选开关,用于隐藏来自其他服务器的玩家
通用功能
- 多语言支持:简体中文 / 繁体中文 / 英文;所有文本均可自定义
- TPA、接受和拒绝命令完全可配置,以适应任何 TPA 插件
- 从控制台运行
/tpagui列出在线玩家 - 启动及定期更新检查(间隔时间可配置)
命令
/tpagui- 打开传送请求菜单(别名:/tpag,/tgui)
权限
tpagui.use- 使用 /tpagui 命令(默认:所有人)tpagui.admin- 接收更新通知(默认:OP)
配置
主要部分(完整注释请参见 config.yml):
| 部分 | 描述 |
|---|---|
language |
界面语言 (zh_CN / zh_TW / en_US) |
velocity |
跨服务器同步开关、服务器名称、同步间隔 |
java-dialog-gui |
每页玩家数、头像显示及头像 API |
back-button |
返回按钮开关、材质、Java/基岩版独立命令 |
commands |
TPA 命令名称、监听命令、接受/拒绝命令 |
update-check |
更新检查开关及间隔 |
依赖项
- 必需:Paper 1.21+(或其分支版本)
- 可选:Floodgate(支持基岩版表单)
- 可选:Velocity(跨服务器玩家同步 —— 相同的 jar 文件也可在代理端使用)
许可证
MIT,详见 LICENSE。
TpaGui
A Paper plugin that adds a graphical interface to your TPA plugin: chest GUI for Java players, native forms for Bedrock, native Dialog request prompts on 1.21.6+, and Velocity cross-server player lists.
TpaGui does not implement teleportation itself — it acts as a GUI layer on top of your existing TPA plugin (EssentialsX, HuskHomes, etc.) and works with any of them.
Quick Start
- Drop the jar into your
plugins/folder and restart the server - Check
commands.listen-commandsinplugins/TpaGui/config.ymlmatches your TPA plugin (default:tpa/tpahere) - Players run
/tpaguito open the menu and click a head to send a request
Features
Java Edition
- Chest GUI with online player heads: left-click for
/tpa, right-click for/tpahere - Pagination with prev/next buttons; vanished players are hidden automatically (SuperVanish compatible)
- Configurable back button (custom material, runs any command on click, e.g.
/cdto return to a main menu) - On 1.21.6+, incoming requests can show a native accept/deny Dialog (requires a datapack; falls back to chat messages automatically)
Bedrock Edition (Geyser/Floodgate)
- Bedrock players are detected automatically and served Cumulus forms instead
- Player list with avatars and pagination; teleport requests shown as accept/deny pop-ups
- Back button command can be configured separately from Java (e.g.
/gmenu)
Velocity Cross-server
- Syncs the network-wide player list from the Velocity proxy; send teleport requests across servers
- Optional toggle to hide players from other servers
General
- Multi-language: Simplified Chinese / Traditional Chinese / English; all text customizable
- TPA, accept and deny commands fully configurable to fit any TPA plugin
- Run
/tpaguifrom console to list online players - Startup and periodic update checks (configurable interval)
Commands
/tpagui- Open the teleport request menu (aliases:/tpag,/tgui)
Permissions
tpagui.use- Use the /tpagui command (default: everyone)tpagui.admin- Receive update notifications (default: OP)
Configuration
Main sections (see config.yml for full comments):
| Section | Description |
|---|---|
language |
Interface language (zh_CN / zh_TW / en_US) |
velocity |
Cross-server sync toggle, server name, sync interval |
java-dialog-gui |
Players per page, avatar display and avatar API |
back-button |
Back button toggle, material, separate Java/Bedrock commands |
commands |
TPA command names, listened commands, accept/deny commands |
update-check |
Update check toggle and interval |
Dependencies
- Required: Paper 1.21+ (or a fork)
- Optional: Floodgate (Bedrock form support)
- Optional: Velocity (cross-server player sync — the same jar works on the proxy)
License
MIT, see LICENSE.
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 tpagui
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
GitHub 发布页:
TpaGui v1.2.0 正式版
新功能
- 返回按钮:Java/基岩双端通用,材质与执行命令可配置(如 Java 执行 /cd、基岩执行 /gmenu 返回主菜单)
- Velocity 端完整 i18n:代理端日志与消息接入语言文件
- 更新检查间隔:支持周期性检查(update-check.interval)
- 配置契约补全:velocity.show-cross-server-players、velocity.server-name 现已生效
重要修复
- 修复 Inventory 拖拽导致的物品丢失漏洞
- 修复 players-per-page 为 0 时的除零崩溃
- 修复 1.21.8+ 版本 Dialog 支持被静默禁用(版本检测改数值比较)
- 修复 Velocity 模式首次打开 GUI 空列表(收到玩家列表后自动刷新)
- 基岩表单回调线程安全化;关闭表单不再误触发拒绝;deny 命令携带请求者参数
- 命令执行改用 performCommand(替换已弃用的 player.chat)
- ShowRequest 增加聊天消息兜底,未装 Dialog 数据包也能收到请求通知
- 跨服玩家头颅显示所在服务器(gui.skull.lore-global)
其他
- 删除不可达死代码 VelocityFormManager;控制台 /tpagui 过滤隐身玩家
- 语言文件三份(zh_CN/zh_TW/en_US)键对齐,清理死键与过期文案
- 注意:plugin.yml 已移除 folia-supported 声明
完整变更:
更新内容
- fix(form): 基岩版表单关闭时静默处理空响应 (Fixes #9) by @leemwood in
- fix(gui): 玩家列表隐藏隐身玩家,兼容 SuperVanish (Fixes #10) by @leemwood in
新贡献者
- @leemwood 在 中完成了首次贡献
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧