** UltimateTPA 插件 - 完整摘要
? 概览
| 属性 |
值 |
| 插件名称 |
UltimateTPA |
| 版本 |
1.0.0 |
| Minecraft 版本 |
1.21.1 - 1.21.x |
| 服务端软件 |
Paper(及其分支如 Purpur) |
| Java 版本 |
Java 21 |
| API |
Paper API 搭配 Kyori Adventure |
? 描述
UltimateTPA 是一款专为现代 Paper Minecraft 服务器设计的一站式传送插件。它将三种核心的传送系统整合到一个轻量级的 JAR 文件中:
- TPA 系统 - 玩家间的传送请求
- RTP 系统 - 随机/野外传送
- DeathTP 系统 - 返回死亡地点
该插件采用现代化的代码库,基于 Java 21 开发,全面支持 MiniMessage 以实现多彩且可点击的聊天组件,并提供高度可配置的设置,包括可选的等待时间计时器,若需即时传送也可完全禁用。
? 主要用途
| 使用场景 |
描述 |
| 生存服 |
允许玩家传送到好友身边并探索随机区域 |
| SMP 服 |
为多人游戏社区提供必要的传送功能 |
| Towny/Nations |
玩家可快速集结进行贸易或合作 |
| 冒险服 |
RTP 用于探索,死亡回溯用于回收物品 |
| 小游戏大厅 |
玩家间快速传送 |
| Vanilla+ 服 |
增加便利性而不破坏原版体验 |
✨ 特性
? 模块 1:TPA 系统(传送请求)
| 特性 |
描述 |
| 发送请求 |
/tpa <player> - 请求传送到其他玩家处 |
| 打开 GUI(仅限 TPA) |
/tpa - 打开 GUI,显示所有玩家;在 GUI 中点击其头像即可轻松发送 TPA 请求 |
| 接受/拒绝 |
接收者可通过命令或可点击按钮接受或拒绝请求 |
| 可点击聊天 |
聊天中显示交互式的 [ACCEPT] 和 [DENY] 按钮 |
| 请求过期 |
请求在可配置的时间后自动过期 |
| 冷却时间 |
防止刷屏,请求之间设有可配置的冷却时间 |
| 切换系统 |
玩家可以屏蔽所有传入的 TPA 请求 |
| 自动接受 |
玩家可以启用自动接受所有请求的模式 |
| 可选等待时间 |
传送前设有可配置的延迟(可禁用) |
| 移动取消 |
如果玩家在等待期间移动,等待将取消(可配置) |
命令:
/tpa - 打开 tpa GUI(仅适用于 tpa)
/tpa <player> - 发送传送请求
/tpaccept - 接受最新请求
/tpdeny - 拒绝最新请求
/tpacancel - 取消你发出的请求
/tpatoggle - 开启/关闭传入请求
/tpaauto - 切换自动接受模式
/tpreload - 重载配置
? 模块 2:RTP 系统(随机传送 / 野外)
| 特性 |
描述 |
| 随机位置 |
传送到世界中的随机安全位置 |
| 两种算法 |
CIRCLE(自然分布)或 SQUARE 模式 |
| 安全检查 |
绝不会落在岩浆、水、火或半空中 |
| 异步区块加载 |
非阻塞式位置查找,性能更佳 |
| 多世界支持 |
可为不同世界配置不同的设置 |
| 可配置半径 |
设置距中心点的最小/最大距离 |
| 自定义中心 |
定义 RTP 区域的原点坐标 |
| 可选等待时间 |
可配置的延迟(可禁用以实现即时传送) |
| 冷却时间 |
防止刷屏,设有可配置的冷却时间 |
| 管理员命令 |
强制指定玩家执行 RTP 并自定义参数 |
命令:
/wild - 传送到随机位置
/rtp - /wild 的别名
/randomtp - /wild 的别名
/wildrtp - /wild 的别名
/wild info - 显示当前世界的 RTP 设置
/wild reload - 重载配置
/wild help - 显示帮助信息
/customrtp <player> <world> <minR> <maxR> <x> <z> - 管理员 RTP
安全检查 - 避免以下情况:
- 岩浆和火焰
- 深水
- 半空出生
- 镁块
- 仙人掌和浆果丛
- 细雪
- 营火
☠️ 模块 3:DeathTP 系统
| 特性 |
描述 |
| 保存死亡位置 |
自动保存玩家的死亡地点 |
| 返回传送 |
/dback 返回到死亡地点 |
| 私密死亡消息 |
只有受害者能看到自己的死亡坐标 |
| 可点击返回 |
死亡消息中包含 [GO BACK] 按钮 |
| 隐藏全球死亡 |
可选择取消公开死亡消息 |
| 持久化位置 |
即使重新登录,死亡位置也会保存 |
命令:
/dback - 传送到死亡地点
/deathback - /dback 的别名
/back - /dback 的别名
/deathtp - /dback 的别名
⚙️ 配置亮点
即时与延时传送
即时传送(无等待时间)
tpa:
warmup:
enabled: false
rtp:
warmup:
enabled: false
延时传送(带等待时间)
tpa:
warmup:
enabled: true
seconds: 3
cancel-on-move: true
rtp:
warmup:
enabled: true
seconds: 5
多世界 RTP 配置
rtp:
worlds:
world:
enabled: true
min-radius: 100
max-radius: 5000
center-x: 0
center-z: 0
algorithm: CIRCLE
world_nether:
enabled: true
min-radius: 50
max-radius: 1000
algorithm: CIRCLE
world_the_end:
enabled: false
MiniMessage 格式化
messages:
prefix: "<gray>[<gradient:00ff88:00aaff>UltimateTPA</gradient>]</gray> "
tpa:
sent: "<green>TPA request sent to <white>{player}</white>."
received: "<green>{player}</green> <yellow>wants to teleport to you!"
click:
accept: "<green><bold>[ACCEPT]</bold></green>"
deny: "<red><bold>[DENY]</bold></red>"
? 权限
玩家权限(默认:true)
| 权限 |
描述 |
ultimatetpa.tpa |
发送 TPA 请求 |
ultimatetpa.tpa.accept |
接受 TPA 请求 |
ultimatetpa.tpa.deny |
拒绝 TPA 请求 |
ultimatetpa.tpa.cancel |
取消已发送的请求 |
ultimatetpa.tpa.toggle |
切换传入请求开关 |
ultimatetpa.tpa.auto |
切换自动接受开关 |
ultimatetpa.rtp |
使用随机传送 |
ultimatetpa.rtp.info |
查看 RTP 信息 |
ultimatetpa.deathtp |
使用死亡传送 |
管理员权限(默认:op)
| 权限 |
描述 |
ultimatetpa.reload |
重载配置 |
ultimatetpa.rtp.custom |
使用 /customrtp 命令 |
ultimatetpa.tpa.bypass.cooldown |
绕过 TPA 冷却时间 |
ultimatetpa.rtp.bypass.cooldown |
绕过 RTP 冷却时间 |
通配符权限
| 权限 |
描述 |
ultimatetpa.* |
所有权限 |
ultimatetpa.tpa.* |
所有 TPA 权限 |
ultimatetpa.rtp.* |
所有 RTP 权限 |
? 音效
| 事件 |
默认音效 |
| 传送 |
ENTITY_ENDERMAN_TELEPORT |
| 收到请求 |
ENTITY_EXPERIENCE_ORB_PICKUP |
| 倒计时滴答声 |
BLOCK_NOTE_BLOCK_HAT |
| 取消倒计时 |
ENTITY_VILLAGER_NO |
| 成功 |
ENTITY_PLAYER_LEVELUP |
| 错误 |
ENTITY_VILLAGER_NO |
所有音效均可自定义音量和音调。
使用的设计模式
| 模式 | 用途 |
|---------|-------|
| **单例模式** | ConfigManager 用于全局配置访问 |
| **管理器模式** | 每个模块拥有独立的管理器 |
| **构建者模式** | MiniMessage 组件构建 |
| **观察者模式** | 游戏事件的事件监听器 |
| **策略模式** | RTP 算法(圆形/方形) |
性能优化
| 优化项 | 描述 |
|--------------|-------------|
| **异步区块加载** | RTP 使用 Paper 的异步区块 API |
| **高效移动检测** | 仅检查方块变化,忽略头部旋转 |
| **ConcurrentHashMap** | 线程安全的数据结构 |
| **延迟清理** | 定期清理过期的请求 |
| **内存占用最小化** | 内存存储并自动清理 |
---
? 快速入门指南
安装
1. 下载或编译 `UltimateTPA-1.0.0.jar`
2. 放入服务器的 `plugins/` 文件夹
3. 启动/重启服务器
4. 根据需要编辑 `plugins/UltimateTPA/config.yml`
5. 运行 `/tpreload` 或 `/wild reload` 以应用更改
推荐的初始配置
```yaml
对于大多数服务器,建议从以下设置开始:
tpa:
warmup:
enabled: true 防止传送滥用
seconds: 3
cancel-on-move: true
request-expiry: 60
cooldown: 30
rtp:
warmup:
enabled: true
seconds: 5
cooldown: 120 2分钟以防止卡顿
max-attempts: 15
deathtp:
cancel-death-message: false 保留原版死亡消息
private-message: true 私密添加坐标
即时传送配置
如果您希望没有任何延迟:
tpa:
warmup:
enabled: false
cooldown: 10
rtp:
warmup:
enabled: false
cooldown: 60
? 与类似插件的比较
| 功能 |
UltimateTPA |
EssentialsX |
其他 TPA 插件 |
| TPA 系统 |
✅ |
✅ |
✅ |
| RTP 系统 |
✅ |
❌ (需单独插件) |
❌ |
| 死亡回溯 |
✅ |
✅ |
❌ |
| 可点击聊天 |
✅ |
❌ |
部分支持 |
| MiniMessage |
✅ |
❌ |
罕见 |
| 可选倒计时 |
✅ |
✅ |
部分支持 |
| 异步 RTP |
✅ |
N/A |
部分支持 |
| 多世界 RTP |
✅ |
N/A |
部分支持 |
| 单个 JAR 包 |
✅ |
❌ (体积大) |
✅ |
| Paper 1.21 原生支持 |
✅ |
✅ |
视情况而定 |
| 轻量级 |
✅ |
❌ |
视情况而定 |
? 许可证与致谢
- 插件: UltimateTPA
- 版本: 1.0.0
- 目标平台: Paper 1.21.x
- Java 版本: 21
- 依赖项: 无(独立运行)
- 软依赖: Vault, LuckPerms(可选)
? 支持检查清单
在报告问题之前,请验证:
- 服务器正在运行 Paper 1.21.x
- 已安装 Java 21
- 插件 JAR 文件位于
/plugins/ 文件夹中
- 服务器启动时控制台无错误
- 玩家拥有正确的权限
- 配置文件语法为有效的 YAML
- 修改配置后运行了
/tpreload
UltimateTPA - 现代 Minecraft 服务器的终极传送解决方案 ?✨
** UltimateTPA Plugin - Complete Summary
? Overview
| Property |
Value |
| Plugin Name |
UltimateTPA |
| Version |
1.0.0 |
| Minecraft Versions |
1.21.1 - 1.21.x |
| Server Software |
Paper (and forks like Purpur) |
| Java Version |
Java 21 |
| API |
Paper API with Kyori Adventure |
? Description
UltimateTPA is an all-in-one teleportation plugin designed for modern Paper Minecraft servers. It combines three essential teleportation systems into a single, lightweight JAR file:
- TPA System - Player-to-player teleport requests
- RTP System - Random/Wild teleportation
- DeathTP System - Return to death location
The plugin features a modern codebase using Java 21, full MiniMessage support for colorful and clickable chat components, and highly configurable settings including optional warmup timers that can be completely disabled for instant teleportation.
? Primary Uses
| Use Case |
Description |
| Survival Servers |
Allow players to teleport to friends and explore randomly |
| SMP Servers |
Essential teleportation features for multiplayer communities |
| Towny/Nations |
Players can quickly meet up for trading or collaboration |
| Adventure Servers |
RTP for exploration, death back for recovering items |
| Mini-game Lobbies |
Quick teleportation between players |
| Vanilla+ Servers |
Adds convenience without breaking vanilla feel |
✨ Features
? Module 1: TPA System (Teleport Requests)
| Feature |
Description |
| Send Requests |
/tpa <player> - Request to teleport to another player |
| Open GUI (for TPA only) |
/tpa - Open GUI that shows all players click on their head in GUI and tpa request sent easily |
| Accept/Deny |
Recipients can accept or deny with commands or clickable buttons |
| Clickable Chat |
Interactive [ACCEPT] and [DENY] buttons in chat |
| Request Expiry |
Requests automatically expire after configurable time |
| Cooldowns |
Prevent spam with configurable cooldown between requests |
| Toggle System |
Players can block all incoming TPA requests |
| Auto-Accept |
Players can enable automatic acceptance of all requests |
| Optional Warmup |
Configurable delay before teleporting (can be disabled) |
| Cancel on Move |
Warmup cancels if player moves (configurable) |
Commands:
/tpa - Open tpa GUI (only works for tpa)
/tpa <player> - Send teleport request
/tpaccept - Accept latest request
/tpdeny - Deny latest request
/tpacancel - Cancel your sent request
/tpatoggle - Toggle incoming requests on/off
/tpaauto - Toggle auto-accept mode
/tpreload - Reload configuration
? Module 2: RTP System (Random Teleport / Wild)
| Feature |
Description |
| Random Location |
Teleport to a random safe location in the world |
| Two Algorithms |
CIRCLE (natural distribution) or SQUARE pattern |
| Safety Checks |
Never land in lava, water, fire, or mid-air |
| Async Chunk Loading |
Non-blocking location finding for better performance |
| Multi-World |
Configure different settings per world |
| Configurable Radius |
Set min/max distance from center point |
| Custom Center |
Define origin coordinates for RTP area |
| Optional Warmup |
Configurable delay (can be disabled for instant TP) |
| Cooldowns |
Prevent spam with configurable cooldown |
| Admin Command |
Force RTP players with custom parameters |
Commands:
/wild - Teleport to random location
/rtp - Alias for /wild
/randomtp - Alias for /wild
/wildrtp - Alias for /wild
/wild info - Show RTP settings for current world
/wild reload - Reload configuration
/wild help - Show help message
/customrtp <player> <world> <minR> <maxR> <x> <z> - Admin RTP
Safety Checks - Avoids:
- Lava and fire
- Deep water
- Mid-air spawns
- Magma blocks
- Cacti and berry bushes
- Powder snow
- Campfires
☠️ Module 3: DeathTP System
| Feature |
Description |
| Death Location Saved |
Automatically saves where players die |
| Teleport Back |
/dback to return to death location |
| Private Death Message |
Only the victim sees their death coordinates |
| Clickable Return |
[GO BACK] button in death message |
| Hide Global Death |
Option to cancel public death messages |
| Persistent Locations |
Death location saved even after relog |
Commands:
/dback - Teleport to death location
/deathback - Alias for /dback
/back - Alias for /dback
/deathtp - Alias for /dback
⚙️ Configuration Highlights
Instant vs Delayed Teleportation
INSTANT TELEPORTATION (No warmup)
tpa:
warmup:
enabled: false
rtp:
warmup:
enabled: false
DELAYED TELEPORTATION (With warmup)
tpa:
warmup:
enabled: true
seconds: 3
cancel-on-move: true
rtp:
warmup:
enabled: true
seconds: 5
Multi-World RTP Configuration
rtp:
worlds:
world:
enabled: true
min-radius: 100
max-radius: 5000
center-x: 0
center-z: 0
algorithm: CIRCLE
world_nether:
enabled: true
min-radius: 50
max-radius: 1000
algorithm: CIRCLE
world_the_end:
enabled: false
MiniMessage Formatting
messages:
prefix: "<gray>[<gradient:00ff88:00aaff>UltimateTPA</gradient>]</gray> "
tpa:
sent: "<green>TPA request sent to <white>{player}</white>."
received: "<green>{player}</green> <yellow>wants to teleport to you!"
click:
accept: "<green><bold>[ACCEPT]</bold></green>"
deny: "<red><bold>[DENY]</bold></red>"
? Permissions
Player Permissions (Default: true)
| Permission |
Description |
ultimatetpa.tpa |
Send TPA requests |
ultimatetpa.tpa.accept |
Accept TPA requests |
ultimatetpa.tpa.deny |
Deny TPA requests |
ultimatetpa.tpa.cancel |
Cancel sent requests |
ultimatetpa.tpa.toggle |
Toggle incoming requests |
ultimatetpa.tpa.auto |
Toggle auto-accept |
ultimatetpa.rtp |
Use random teleport |
ultimatetpa.rtp.info |
View RTP information |
ultimatetpa.deathtp |
Use death teleport |
Admin Permissions (Default: op)
| Permission |
Description |
ultimatetpa.reload |
Reload configuration |
ultimatetpa.rtp.custom |
Use /customrtp command |
ultimatetpa.tpa.bypass.cooldown |
Bypass TPA cooldown |
ultimatetpa.rtp.bypass.cooldown |
Bypass RTP cooldown |
Wildcard Permissions
| Permission |
Description |
ultimatetpa.* |
All permissions |
ultimatetpa.tpa.* |
All TPA permissions |
ultimatetpa.rtp.* |
All RTP permissions |
? Sound Effects
| Event |
Default Sound |
| Teleport |
ENTITY_ENDERMAN_TELEPORT |
| Request Received |
ENTITY_EXPERIENCE_ORB_PICKUP |
| Warmup Tick |
BLOCK_NOTE_BLOCK_HAT |
| Warmup Cancel |
ENTITY_VILLAGER_NO |
| Success |
ENTITY_PLAYER_LEVELUP |
| Error |
ENTITY_VILLAGER_NO |
All sounds are fully configurable with custom volume and pitch.
Design Patterns Used
| Pattern | Usage |
|---------|-------|
| **Singleton** | ConfigManager for global config access |
| **Manager Pattern** | Separate managers for each module |
| **Builder Pattern** | MiniMessage component building |
| **Observer Pattern** | Event listeners for game events |
| **Strategy Pattern** | RTP algorithms (CIRCLE/SQUARE) |
Performance Optimizations
| Optimization | Description |
|--------------|-------------|
| **Async Chunk Loading** | RTP uses Paper's async chunk API |
| **Efficient Move Check** | Only checks block changes, ignores head rotation |
| **ConcurrentHashMap** | Thread-safe data structures |
| **Lazy Cleanup** | Expired requests cleaned periodically |
| **Minimal Memory** | In-memory storage with automatic cleanup |
---
? Quick Start Guide
Installation
1. Download or build `UltimateTPA-1.0.0.jar`
2. Place in server's `plugins/` folder
3. Start/restart the server
4. Edit `plugins/UltimateTPA/config.yml` as needed
5. Run `/tpreload` or `/wild reload` to apply changes
Recommended First Configuration
```yaml
For most servers, start with these settings:
tpa:
warmup:
enabled: true Prevent TP abuse
seconds: 3
cancel-on-move: true
request-expiry: 60
cooldown: 30
rtp:
warmup:
enabled: true
seconds: 5
cooldown: 120 2 minutes to prevent lag
max-attempts: 15
deathtp:
cancel-death-message: false Keep vanilla death messages
private-message: true Add coordinates privately
For Instant Teleportation
If you want no delays at all:
tpa:
warmup:
enabled: false
cooldown: 10
rtp:
warmup:
enabled: false
cooldown: 60
? Comparison with Similar Plugins
| Feature |
UltimateTPA |
EssentialsX |
Other TPA Plugins |
| TPA System |
✅ |
✅ |
✅ |
| RTP System |
✅ |
❌ (separate) |
❌ |
| Death Back |
✅ |
✅ |
❌ |
| Clickable Chat |
✅ |
❌ |
Some |
| MiniMessage |
✅ |
❌ |
Rare |
| Optional Warmup |
✅ |
✅ |
Some |
| Async RTP |
✅ |
N/A |
Some |
| Multi-World RTP |
✅ |
N/A |
Some |
| Single JAR |
✅ |
❌ (large) |
✅ |
| Paper 1.21 Native |
✅ |
✅ |
Varies |
| Lightweight |
✅ |
❌ |
Varies |
? License & Credits
- Plugin: UltimateTPA
- Version: 1.0.0
- Target: Paper 1.21.x
- Java: 21
- Dependencies: None (standalone)
- Soft Dependencies: Vault, LuckPerms (optional)
? Support Checklist
Before reporting issues, verify:
- Server is running Paper 1.21.x
- Java 21 is installed
- Plugin JAR is in
/plugins/ folder
- No errors in server console on startup
- Players have correct permissions
- Config syntax is valid YAML
- Ran
/tpreload after config changes
UltimateTPA - The Ultimate Teleportation Solution for Modern Minecraft Servers ?✨**
评论 0
登录后参与评分
还没有评论,来抢沙发吧