EasyTPA
简单的玩家传送请求,支持自定义菜单、倒计时和灵活的传送目的地。

平台

要求
- Minecraft: 适用于 Bukkit、Spigot、Paper 或 Purpur 的 1.13+ 版本。请查看 可用版本 以确认发行版的兼容性。
- Java: 该插件基于 Java 8 开发。请使用你的服务器所需的 Java 版本;Minecraft 26.x 需要 Java 25。
- LuckPerms: 可选;若无 LuckPerms,则回退至 Bukkit 权限系统。
- 客户端安装: 无需任何客户端安装。
- Folia: 不支持。
功能
- 传送请求 — 请求传送到其他玩家身边,或邀请他们传送到你这里。
- 自定义菜单 — 发送和接受两种类型的请求分别拥有独立的确认菜单。
- 可配置倒计时 — 可选择玩家在传送前等待的时间长度。
- 灵活的目的地 — 当请求被接受或倒计时结束时,使用目标玩家的位置作为目的地。
- 移动取消 — 当正在传送的玩家移动到另一个方块时,取消倒计时。
- 断开连接取消 — 如果目标玩家离线,则取消传送。
- 玩家偏好设置 — 可切换接收请求、自动接受以及接受菜单的显示。
- 请求控制 — 可配置冷却时间和请求过期时间。
- 自定义消息和音效 — 自定义聊天消息、可点击通知、动作栏、标题和音效。
- 旧版颜色支持 — 在 Minecraft 1.13–1.15 中,十六进制颜色代码会回退到相似的旧版颜色代码。
- 持久化设置 — 玩家偏好设置存储在 SQLite 数据库中。
- 权限支持 — 支持 Bukkit 权限,并可选集成 LuckPerms。
- 更新通知 — 后台检查 Modrinth 上的发布情况,显示你落后于多少个已发布的构建版本,并提供下载链接。
工作原理
使用 /tpa <player> 命令请求传送到某位玩家处,或使用 /tpahere <player> 命令邀请他们传送到你身边。在菜单中确认请求后,接收方玩家可以接受或拒绝。
一旦请求被接受,旅行玩家的倒计时开始。若旅行者移动到另一个方块,倒计时将被取消。未被响应的请求会自动过期。
选择你的传送目的地
teleport-destination: acceptance
| 设置项 |
行为 |
acceptance |
在请求被接受时,使用目标玩家的位置。 |
countdown-end |
在倒计时归零时,使用目标玩家的当前位置。 |
两种选项均适用于 /tpa、/tpahere 以及自动接受的请求。已在进行中的倒计时在被接受时将保留所选的目标模式。
命令
| 命令 |
描述 |
/tpa <player> |
请求传送到某玩家处。 |
/tpahere <player> |
请求某玩家传送到你身边。 |
/tpaccept |
接受待处理的请求。 |
/tpadeny |
拒绝待处理的请求。 |
/tpacancel |
取消你发出的请求。 |
/tpatoggle |
切换接收 /tpa 请求的状态。 |
/tpaheretoggle |
切换接收 /tpahere 请求的状态。 |
/tpaauto |
切换自动接受功能。别名:/tpauto。 |
/tpaguitoggle |
切换接受确认菜单。 |
/tpareload |
重载配置文件。 |
权限
| 权限节点 |
默认值 |
描述 |
easytpa.tpa |
所有人 |
使用 /tpa。 |
easytpa.tpahere |
所有人 |
使用 /tpahere。 |
easytpa.tpaccept |
所有人 |
接受请求。 |
easytpa.tpadeny |
所有人 |
拒绝请求。 |
easytpa.tpacancel |
所有人 |
取消发出的请求。 |
easytpa.tpatoggle |
所有人 |
切换接收传送请求的状态。 |
easytpa.tpaheretoggle |
所有人 |
切换接收传送邀请的状态。 |
easytpa.tpaauto |
所有人 |
切换自动接受功能。 |
easytpa.tpaguitoggle |
所有人 |
切换接受菜单。 |
easytpa.tpareload |
OP |
重载配置文件。 |
easytpa.tpa.bypass |
OP |
绕过其他玩家的请求切换限制。 |
easytpa.admin |
OP |
拥有所有插件权限及请求冷却时间豁免权。 |
旧的 donuttpa.* 权限名称仍受支持,以兼容现有配置。
配置
config.yml
teleport-warmup: 3
teleport-destination: acceptance
request-timeout: 60
update-check: true
更改传送设置后请使用 /tpareload 重载。更新检查器仅在服务器启动时运行一次;更改 update-check 后需重启服务器。
自定义文件
| 文件 |
用途 |
messages.yml |
聊天消息、操作栏提示、标题和副标题。 |
sounds.yml |
音效。 |
request-cooldown.yml |
请求冷却时长。 |
world-nick.yml |
菜单中显示的世界名称。 |
gui/*.yml |
菜单标题、物品、位置、名称和描述。 |
从 DonutTPA 升级
停止服务器,备份插件数据,删除旧的 DonutTPA JAR 文件,然后安装 EasyTPA。
首次启动时,如果 EasyTPA 的文件夹不存在或为空,它将复制现有的 DonutTpa 或 DonutTPA 数据文件夹。你的原始文件夹将被保留,且不会覆盖现有的 EasyTPA 数据。
文件结构
plugins/EasyTPA/
├── config.yml
├── messages.yml
├── sounds.yml
├── request-cooldown.yml
├── world-nick.yml
├── data.db
└── gui/
├── tpa-send.yml
├── tpa-accept.yml
├── tpa-here-send.yml
└── tpa-here-accept.yml
支持
本项目由 sqidgeon 维护。未经我们同意,您不得重新分发此插件!
EasyTPA
Simple player teleport requests with customisable menus, countdowns, and flexible teleport destinations.

Platforms

Requirements
- Minecraft: 1.13+ on Bukkit, Spigot, Paper, or Purpur. Check the available versions for release compatibility.
- Java: the plugin targets Java 8. Use the Java version required by your server; Minecraft 26.x requires Java 25.
- LuckPerms: optional; falls back to Bukkit permissions.
- Client installation: none required.
- Folia: not supported.
Features
- Teleport requests — request to visit another player or invite them to you.
- Customisable menus — separate confirmation menus for sending and accepting both request types.
- Configurable countdowns — choose how long players wait before teleporting.
- Flexible destinations — use the destination player's location when accepted or when the countdown finishes.
- Movement cancellation — cancels the countdown when the travelling player moves to another block.
- Disconnect cancellation — cancels the teleport if the destination player goes offline.
- Player preferences — toggle incoming requests, automatic acceptance, and acceptance menus.
- Request controls — configurable cooldowns and request expiry.
- Custom messages and sounds — customise chat messages, clickable notifications, action bars, titles, and sound effects.
- Legacy colour support — hex colours fall back to a similar legacy colour on Minecraft 1.13–1.15.
- Persistent settings — player preferences are stored in SQLite.
- Permission support — Bukkit permissions with optional LuckPerms integration.
- Update notifications — background Modrinth checks show how many published builds you're behind and provide a download link.
How It Works
Send a request with /tpa <player> to teleport to someone, or /tpahere <player> to invite them to you. Confirm the request in the menu, then the receiving player can accept or deny it.
Once accepted, the travelling player's countdown begins. Moving to another block cancels it. Unanswered requests expire automatically.
Choose Your Teleport Destination
teleport-destination: acceptance
| Setting |
Behaviour |
acceptance |
Uses the destination player's location when the request was accepted. |
countdown-end |
Uses the destination player's current location when the countdown reaches zero. |
Both options work with /tpa, /tpahere, and automatically accepted requests. Countdowns already in progress keep the destination mode selected when accepted.
Commands
| Command |
Description |
/tpa <player> |
Request to teleport to a player. |
/tpahere <player> |
Request that a player teleport to you. |
/tpaccept |
Accept a pending request. |
/tpadeny |
Deny a pending request. |
/tpacancel |
Cancel your outgoing requests. |
/tpatoggle |
Toggle incoming /tpa requests. |
/tpaheretoggle |
Toggle incoming /tpahere requests. |
/tpaauto |
Toggle automatic acceptance. Alias: /tpauto. |
/tpaguitoggle |
Toggle acceptance confirmation menus. |
/tpareload |
Reload configuration files. |
Permissions
| Permission |
Default |
Description |
easytpa.tpa |
Everyone |
Use /tpa. |
easytpa.tpahere |
Everyone |
Use /tpahere. |
easytpa.tpaccept |
Everyone |
Accept requests. |
easytpa.tpadeny |
Everyone |
Deny requests. |
easytpa.tpacancel |
Everyone |
Cancel outgoing requests. |
easytpa.tpatoggle |
Everyone |
Toggle incoming teleport requests. |
easytpa.tpaheretoggle |
Everyone |
Toggle incoming teleport invitations. |
easytpa.tpaauto |
Everyone |
Toggle automatic acceptance. |
easytpa.tpaguitoggle |
Everyone |
Toggle acceptance menus. |
easytpa.tpareload |
OP |
Reload configuration files. |
easytpa.tpa.bypass |
OP |
Bypass another player's request-toggle restrictions. |
easytpa.admin |
OP |
All plugin permissions and request-cooldown bypass. |
Legacy donuttpa.* permission names remain supported for existing setups.
Configuration
config.yml
teleport-warmup: 3
teleport-destination: acceptance
request-timeout: 60
update-check: true
Use /tpareload after changing teleport settings. The update checker runs once at startup; restart after changing update-check.
Customisation Files
| File |
Purpose |
messages.yml |
Chat messages, action bars, titles, and subtitles. |
sounds.yml |
Sound effects. |
request-cooldown.yml |
Request cooldown duration. |
world-nick.yml |
World names displayed in menus. |
gui/*.yml |
Menu titles, items, slots, names, and lore. |
Updating From DonutTPA
Stop your server, back up your plugin data, remove the old DonutTPA JAR, and install EasyTPA.
On first start, EasyTPA copies an existing DonutTpa or DonutTPA data folder when its own folder is absent or empty. Your original folder is preserved, and existing EasyTPA data is not overwritten.
File Structure
plugins/EasyTPA/
├── config.yml
├── messages.yml
├── sounds.yml
├── request-cooldown.yml
├── world-nick.yml
├── data.db
└── gui/
├── tpa-send.yml
├── tpa-accept.yml
├── tpa-here-send.yml
└── tpa-here-accept.yml
Support
This project is maintained by sqidgeon. You are NOT allowed to re-distribute this plugin without consent from us!
评论 0
登录后参与评分
还没有评论,来抢沙发吧