? DonutTPA — 现代传送请求
DonutTPA 是一款专为现代 Paper、Purpur、Spigot 和 Folia 服务器打造的精致传送请求插件,灵感源自 DonutSMP。它通过交互式确认 GUI、可自定义音效、玩家独立的开关偏好以及实时的预热倒计时,提升了标准的玩家间传送体验,同时保持服务器高性能且轻量。
✨ 主要功能
- ?️ DonutSMP 风格确认与接受 GUI — 发送或接受请求时打开一个整洁的 27 格菜单,显示:
- 第 10 格: 取消 / 拒绝 (
RED_STAINED_GLASS_PANE)
- 第 12 格: 目标玩家头颅 (
PLAYER_HEAD)
- 第 13 格: 请求类型指示器 (
ENDER_PEARL 用于 /tpa 或 FEATHER 用于 /tpahere)
- 第 14 格: 世界维度指示器 (
GRASS_BLOCK 用于主世界, NETHERRACK 用于下界, END_STONE 用于末地)
- 第 16 格: 确认 / 接受 (
LIME_STAINED_GLASS_PANE)
- ? 交互式聊天按钮 — 传入的请求包含可点击的
[✔ 接受] 和 [✖ 拒绝] 聊天按钮,带有悬停提示框以便即时响应。
- ? 玩家隐私与偏好开关 — 玩家可以单独切换传入的
/tpa 请求、/tpahere 请求、确认 GUI 的状态,或启用自动接受请求(/tpauto)。
- ⏱️ 实时每秒预热倒计时 — 在传送前显示每秒倒计时(
5, 4, 3, 2, 1...)并配有可配置的提示音。
- ? 智能移动取消 — 如果玩家行走或跳跃,将取消当前的传送预热;同时允许他们自由使用鼠标环顾四周。
- ? 完全可配置的音效与信息 — 所有聊天信息、GUI 标题、计时器和音效均可在
config.yml 中自定义或翻译。
- ⚡ 防刷屏冷却与自动过期 — 通过可配置的冷却时间防止请求刷屏,并自动使未答复的请求失效。

? 命令
| 命令 |
别名 |
权限 |
描述 |
/tpa <player> |
— |
donuttpa.use |
打开确认 GUI 或向玩家发送传送请求。 |
/tpahere <player> |
— |
donuttpa.use |
请求另一名玩家传送到你的位置。 |
/tpaccept [player] |
/tpaaccept, /tpyes |
donuttpa.use |
打开接受 GUI 或接受传入的传送请求。 |
/tpdeny [player] |
/tpadeny, /tpno |
donuttpa.use |
拒绝传入的传送请求。 |
/tpacancel |
— |
donuttpa.use |
取消当前活动的出站传送请求。 |
/tpatoggle |
— |
donuttpa.use |
开启或关闭接收传入的 /tpa 请求。 |
/tpaheretoggle |
— |
donuttpa.use |
开启或关闭接收传入的 /tpahere 请求。 |
/tpaguitoggle |
— |
donuttpa.use |
为自己开启或关闭确认和接受 GUI。 |
/tpauto |
— |
donuttpa.use |
自动接受传入的传送请求。 |
/dtpa reload |
— |
donuttpa.admin |
在游戏内重新加载插件配置和信息。 |
? 权限
| 权限节点 |
默认值 |
描述 |
donuttpa.use |
true (所有人) |
授予访问所有玩家 TPA 和开关命令的权限。 |
donuttpa.admin |
op |
授予访问 /dtpa reload 并绕过所有限制的权限。 |
donuttpa.cooldown.bypass |
op |
绕过发送 TPA 请求之间的冷却计时器。 |
donuttpa.limit.bypass |
op |
绕过目标玩家的 TPA 开关限制和待处理限制。 |
donuttpa.bypass.delay |
op |
绕过传送预热倒计时以实现即时传送。 |
⚙️ 配置 (config.yml)
? 点击查看默认 config.yml
# ==========================================
# DonutTPA v26.10.2 (DonutSMP Edition)
# ==========================================
settings:
request-expire-seconds: 60
teleport-delay-seconds: 5
cooldown-seconds: 10
cancel-on-move: true
use-gui-by-default: true
gui:
size: 27
confirm-title: "&8CONFIRM REQUEST"
accept-title: "&8ACCEPT REQUEST"
filler-enabled: true
filler-material: "GRAY_STAINED_GLASS_PANE"
sounds:
enabled: true
gui-click: "UI_BUTTON_CLICK"
request-sent: "ENTITY_EXPERIENCE_ORB_PICKUP"
request-received: "BLOCK_NOTE_BLOCK_PLING"
request-accepted: "ENTITY_PLAYER_LEVELUP"
request-denied: "ENTITY_VILLAGER_NO"
countdown-tick: "BLOCK_NOTE_BLOCK_HAT"
teleport-success: "ENTITY_ENDERMAN_TELEPORT"
teleport-cancelled: "ENTITY_VILLAGER_NO"
messages:
prefix: ""
no-permission: "&c你没有权限使用此命令。"
only-players: "&c只有玩家才能执行此命令。"
reload-success: "&aDonutTPA 配置已成功重载!"
usage-tpa: "&c用法:/tpa <player>"
usage-tpahere: "&c用法:/tpahere <player>"
player-not-found: "&c玩家 &e%player% &c不在线。"
cannot-tpa-self: "&c你不能向自己发送传送请求。"
cooldown-active: "&c请等待 &e%time%s &c后再发送另一个请求。"
already-pending: "&c你已经有一个发送给 &e%player%&c 的待处理请求。"
# Toggle Restriction Messages (DonutSMP Style)
target-tpa-disabled: "&c该用户不接受 tpa 请求。"
target-tpahere-disabled: "&c该用户不接受 tpahere 请求。"
# Request Sent & Received (DonutSMP Style)
request-sent: "&e你已向 &b%target% &e发送了一个 tpa 请求。"
request-sent-tpahere: "&e你已向 &b%target% &e发送了一个 tpahere 请求。"
request-received-tpa: "&b%sender% &e向你发送了一个 tpa 请求。"
request-received-tpahere: "&b%sender% &e向你发送了一个 tpahere 请求。"
# Interactive Chat Buttons
buttons-prefix: "&7点击选项: "
button-accept-text: "&a&l[✔ 接受]"
button-accept-hover: "&a点击接受 %sender% 的请求"
button-deny-text: "&c&l[✖ 拒绝]"
button-deny-hover: "&c点击拒绝 %sender% 的请求"
# Accept / Deny / Cancel / Expiration
no-pending-requests: "&c你没有任何待处理的传送请求。"
no-outgoing-requests: "&c你没有任何可以取消的已发送传送请求。"
request-accepted-target: "&a你的传送请求已被接受。"
request-accepted-sender: "&a你的传送请求已被接受。"
request-denied-target: "&c你拒绝了 &e%sender%'s &c的传送请求。"
request-denied-sender: "&c你发送给 &e%target% &c的传送请求已被拒绝。"
request-cancelled: "&e你取消了发送给 &b%target%&e 的传送请求。"
request-expired-sender: "&c此传送请求可能已过期。"
request-expired-target: "&e%sender% &c的传送请求已过期。"
# 每秒倒计时与状态(DonutSMP 风格)
teleport-countdown: "&7正在传送,剩余 &b%time% &7秒..."
teleport-success: "&a传送成功!"
teleport-cancelled-moved: "&c因你移动,传送已取消!"
teleport-cancelled-moved-other: "&c因&e%player%&c移动,传送已取消!"
teleport-cancelled-offline: "&c因对方玩家离线,传送已取消。"
# 切换反馈消息
toggle-tpa-enabled: "&a你现在接受 TPA 请求。"
toggle-tpa-disabled: "&c你不再接受 TPA 请求。"
toggle-tpahere-enabled: "&a你现在接受 TPAHere 请求。"
toggle-tpahere-disabled: "&c你不再接受 TPAHere 请求。"
toggle-gui-enabled: "&aTPA 确认 GUI 已&2启用&a。"
toggle-gui-disabled: "&cTPA 确认 GUI 已&4禁用&c。"
toggle-auto-enabled: "&a自动接受 TPA 请求已&2启用&a。"
toggle-auto-disabled: "&c自动接受 TPA 请求已&4禁用&c。"
</details>
---
## ?️ 消息占位符
| 占位符 | 描述 |
| :--- | :--- |
| `%sender%` | 发送请求的玩家的用户名。 |
| `%target%` | 接收请求的玩家的用户名。 |
| `%player%` | 用于表示另一名玩家用户名的通用后备占位符。 |
| `%expire%` | 传送请求过期前剩余的秒数。 |
| `%time%` / `%delay%` | 冷却或准备倒计时剩余的秒数。 |
---
## ? 安装
1. 从 Modrinth 下载最新的 `DonutTPA-2.0.0.jar`。
2. 将 `.jar` 文件放入服务器的 `plugins/` 目录中。
3. 重启服务器以生成配置文件。
4. 自定义 `plugins/DonutTPA/config.yml`,并随时使用 `/dtpa reload` 命令应用更改。
---
## ?? 致谢与贡献者
* **Chéngzé** — *首席开发者 & 作者*
* **MonoromX & Ly_No** — *游戏内测试 & QA*
? DonutTPA — Modern Teleport Requests
DonutTPA is a sleek, DonutSMP-inspired teleport request plugin built for modern Paper, Purpur, Spigot, and Folia servers. It upgrades standard player-to-player teleportation with interactive confirmation GUIs, customizable sound effects, per-player toggle preferences, and live warmup countdowns while keeping server performance fast and lightweight.
✨ Key Features
- ?️ DonutSMP-Inspired Confirmation & Accept GUIs — Opens a clean 27-slot menu when sending or accepting requests, displaying:
- Slot 10: Cancel / Deny (
RED_STAINED_GLASS_PANE)
- Slot 12: Target's Player Head (
PLAYER_HEAD)
- Slot 13: Request Type Indicator (
ENDER_PEARL for /tpa or FEATHER for /tpahere)
- Slot 14: World Dimension Indicator (
GRASS_BLOCK for Overworld, NETHERRACK for Nether, END_STONE for The End)
- Slot 16: Confirm / Accept (
LIME_STAINED_GLASS_PANE)
- ? Interactive Chat Buttons — Incoming requests include clickable
[✔ Accept] and [✖ Deny] chat buttons with hover tooltips for instant responses.
- ? Per-Player Privacy & Preference Toggles — Players can individually toggle incoming
/tpa requests, /tpahere requests, confirmation GUIs, or enable automatic request acceptance (/tpauto).
- ⏱️ Live Per-Second Warmup Countdown — Displays a second-by-second countdown (
5, 4, 3, 2, 1...) with configurable sound ticks before teleporting.
- ? Smart Movement Cancellation — Cancels the active teleport warmup if the player walks or jumps, while still allowing them to look around freely with their mouse.
- ? Fully Configurable Sounds & Messages — Every chat message, GUI title, timer, and sound effect can be customized or translated in
config.yml.
- ⚡ Anti-Spam Cooldowns & Auto-Expiration — Prevents request spam with configurable cooldowns and automatically expires unanswered requests.

? Commands
| Command |
Aliases |
Permission |
Description |
/tpa <player> |
— |
donuttpa.use |
Open the confirmation GUI or send a teleport request to a player. |
/tpahere <player> |
— |
donuttpa.use |
Request another player to teleport to your location. |
/tpaccept [player] |
/tpaaccept, /tpyes |
donuttpa.use |
Open the accept GUI or accept an incoming teleport request. |
/tpdeny [player] |
/tpadeny, /tpno |
donuttpa.use |
Deny an incoming teleport request. |
/tpacancel |
— |
donuttpa.use |
Cancel your currently active outgoing teleport request. |
/tpatoggle |
— |
donuttpa.use |
Toggle receiving incoming /tpa requests on or off. |
/tpaheretoggle |
— |
donuttpa.use |
Toggle receiving incoming /tpahere requests on or off. |
/tpaguitoggle |
— |
donuttpa.use |
Toggle the confirmation and accept GUIs on or off for yourself. |
/tpauto |
— |
donuttpa.use |
Automatically accept incoming teleport requests. |
/dtpa reload |
— |
donuttpa.admin |
Reload the plugin configuration and messages in-game. |
? Permissions
| Permission Node |
Default |
Description |
donuttpa.use |
true (Everyone) |
Grants access to all player TPA and toggle commands. |
donuttpa.admin |
op |
Grants access to /dtpa reload and bypasses all restrictions. |
donuttpa.cooldown.bypass |
op |
Bypasses the cooldown timer between sending TPA requests. |
donuttpa.limit.bypass |
op |
Bypasses target player TPA toggle restrictions and pending limits. |
donuttpa.bypass.delay |
op |
Bypasses the teleport warmup countdown for instant teleportation. |
⚙️ Configuration (config.yml)
? Click to view default config.yml
# ==========================================
# DonutTPA v26.10.2 (DonutSMP Edition)
# ==========================================
settings:
request-expire-seconds: 60
teleport-delay-seconds: 5
cooldown-seconds: 10
cancel-on-move: true
use-gui-by-default: true
gui:
size: 27
confirm-title: "&8CONFIRM REQUEST"
accept-title: "&8ACCEPT REQUEST"
filler-enabled: true
filler-material: "GRAY_STAINED_GLASS_PANE"
sounds:
enabled: true
gui-click: "UI_BUTTON_CLICK"
request-sent: "ENTITY_EXPERIENCE_ORB_PICKUP"
request-received: "BLOCK_NOTE_BLOCK_PLING"
request-accepted: "ENTITY_PLAYER_LEVELUP"
request-denied: "ENTITY_VILLAGER_NO"
countdown-tick: "BLOCK_NOTE_BLOCK_HAT"
teleport-success: "ENTITY_ENDERMAN_TELEPORT"
teleport-cancelled: "ENTITY_VILLAGER_NO"
messages:
prefix: ""
no-permission: "&cYou do not have permission to use this command."
only-players: "&cOnly players can execute this command."
reload-success: "&aDonutTPA configuration reloaded successfully!"
usage-tpa: "&cUsage: /tpa <player>"
usage-tpahere: "&cUsage: /tpahere <player>"
player-not-found: "&cPlayer &e%player% &cis not online."
cannot-tpa-self: "&cYou cannot send a teleport request to yourself."
cooldown-active: "&cPlease wait &e%time%s &cbefore sending another request."
already-pending: "&cYou already have a pending request to &e%player%&c."
# Toggle Restriction Messages (DonutSMP Style)
target-tpa-disabled: "&cThat user is not accepting tpa requests."
target-tpahere-disabled: "&cThat user is not accepting tpahere requests."
# Request Sent & Received (DonutSMP Style)
request-sent: "&eYou sent &b%target% &ea tpa request."
request-sent-tpahere: "&eYou sent &b%target% &ea tpahere request."
request-received-tpa: "&b%sender% &esent you a tpa request."
request-received-tpahere: "&b%sender% &esent you a tpahere request."
# Interactive Chat Buttons
buttons-prefix: "&7Click an option: "
button-accept-text: "&a&l[✔ Accept]"
button-accept-hover: "&aClick to accept %sender%'s request"
button-deny-text: "&c&l[✖ Deny]"
button-deny-hover: "&cClick to deny %sender%'s request"
# Accept / Deny / Cancel / Expiration
no-pending-requests: "&cYou do not have any pending teleport requests."
no-outgoing-requests: "&cYou do not have any outgoing teleport requests to cancel."
request-accepted-target: "&aYour teleport request has been accepted."
request-accepted-sender: "&aYour teleport request has been accepted."
request-denied-target: "&cYou denied &e%sender%'s &cteleport request."
request-denied-sender: "&cYour teleport request to &e%target% &cwas denied."
request-cancelled: "&eYou cancelled your teleport request to &b%target%&e."
request-expired-sender: "&cThis teleport request might be expired."
request-expired-target: "&cThe teleport request from &e%sender% &chas expired."
# Per-Second Countdown & Status (DonutSMP Style)
teleport-countdown: "&7Teleporting in &b%time% &7seconds..."
teleport-success: "&aTeleported successfully!"
teleport-cancelled-moved: "&cTeleport cancelled because you moved!"
teleport-cancelled-moved-other: "&cTeleport cancelled because &e%player% &cmoved!"
teleport-cancelled-offline: "&cTeleport cancelled because the other player went offline."
# Toggle Feedback Messages
toggle-tpa-enabled: "&aYou are now accepting TPA requests."
toggle-tpa-disabled: "&cYou are no longer accepting TPA requests."
toggle-tpahere-enabled: "&aYou are now accepting TPAHere requests."
toggle-tpahere-disabled: "&cYou are no longer accepting TPAHere requests."
toggle-gui-enabled: "&aTPA Confirmation GUI has been &2enabled&a."
toggle-gui-disabled: "&cTPA Confirmation GUI has been &4disabled&c."
toggle-auto-enabled: "&aAuto-Accept TPA requests has been &2enabled&a."
toggle-auto-disabled: "&cAuto-Accept TPA requests has been &4disabled&c."
?️ Message Placeholders
| Placeholder |
Description |
%sender% |
The username of the player who sent the request. |
%target% |
The username of the player who received the request. |
%player% |
Universal fallback for the other player's username. |
%expire% |
Remaining seconds until the teleport request expires. |
%time% / %delay% |
Remaining cooldown or warmup countdown seconds. |
? Installation
- Download the latest
DonutTPA-2.0.0.jar from Modrinth.
- Drop the
.jar file into your server's plugins/ directory.
- Restart your server to generate the configuration files.
- Customize
plugins/DonutTPA/config.yml and apply changes anytime using /dtpa reload.
?? Credits & Contributors
- Chéngzé — Lead Developer & Author
- MonoromX & Ly_No — In-Game Testing & QA
评论 0
登录后参与评分
还没有评论,来抢沙发吧