MasterTPA

TPA Teleport Request Plugin

A minimalistic and efficient teleport request system for Minecraft servers running Bukkit/Paper 1.20+. This plugin allows players to request teleportation to each other with a simple and intuitive command system.

✨ Features

• Simple Commands - Easy to remember and use
• Complete Flow - Send, accept, deny, and cancel requests
• Command Aliases - Multiple aliases for each command
• No Configuration - Plug and play, zero setup required
• Lightweight - Minimal impact on server performance
• Multi-version Support - Compatible with 1.20 - 1.21.11
• Java 21 Optimized - Built with latest Java version

📋 Commands

Command	Description	Aliases
/tpa <player>	Send a teleport request	/tpa
/tpaccept	Accept the latest request	/tpyes
/tpadeny	Deny the latest request	/tpno
/tpacancel	Cancel your outgoing request	/tpcancel

🎮 How to Use

1. Send a request: /tpa Steve
2. Target receives: "Steve wants to teleport to you!"
3. Accept: /tpaccept - Teleports requester to you
4. Deny: /tpadeny - Rejects the request
5. Cancel: /tpacancel - Cancel your own request

🔐 Permissions

Permission	Description	Default
tpa.use	Use all teleport commands	true

All players have access by default - no complex permission setup needed!

📦 Installation

1. Download this plugins
2. Place it in your server's plugins folder
3. Restart the server or use a plugin manager
4. Done! No configuration required

💾 Technical Details

• Storage: Memory-based (no files generated)
• Compatibility: Paper, Purpur, Spigot 1.20+
• Java Version: 21 or higher
• Dependencies: None

TPA Teleport Request Plugin - Chinese

🌟 插件概述

TPA传送请求插件是一款专为Bukkit、Paper、Purpur等Minecraft服务端设计的轻量级传送管理工具。它实现了玩家之间简单、直观、安全的传送请求系统，让服务器中的社交互动和团队协作变得更加便捷流畅。

---

✨ 核心特色

特性	描述
🚀 轻量高效	无配置文件，即插即用，几乎不占用服务器资源
🌐 多版本支持	完美兼容 Minecraft 1.20 - 1.21.11
☕ Java 21优化	采用最新Java版本编译，性能与稳定性俱佳
🔧 开箱即用	无需复杂配置，放入plugins文件夹即可
🎯 直观命令	命令设计符合直觉，新手也能快速上手
🔄 完整流程	发送、接受、拒绝、取消，覆盖所有传送场景

---

📋 命令列表

基础命令

命令格式	功能描述	使用示例
/tpa <玩家名>	向指定玩家发送传送请求	/tpa Steve
/tpaccept	接受最新的传送请求	/tpaccept
/tpadeny	拒绝最新的传送请求	/tpadeny
/tpacancel	取消自己发送的传送请求	/tpacancel

便捷别名

为了方便不同习惯的玩家，插件提供了丰富的别名支持：

原命令	别名	用途
/tpa	/tpa	发送请求
/tpaccept	/tpyes	接受请求
/tpadeny	/tpno	拒绝请求
/tpacancel	/tpcancel	取消请求

所有别名均可正常使用，例如：

• /tpyes 等同于 /tpaccept
• /tpno 等同于 /tpadeny
• /tpcancel 等同于 /tpacancel

---

🔐 权限系统

插件采用极简的权限设计，只有一个核心权限节点：

权限节点	默认值	描述
tpa.use	true	允许使用所有传送相关命令

权限说明：

• 默认所有玩家都拥有此权限，开箱即用
• 管理员可通过权限插件（如LuckPerms）对特定玩家或组进行精细化控制
• 无需额外配置即可满足绝大多数服务器需求

---

🎮 使用场景示例

场景一：好友相约探险

玩家A（Alex）想要去找玩家B（Steve）：

Alex > /tpa Steve
[系统] 已向 Steve 发送传送请求！
Steve > [系统] Alex 对你发起传送
Steve > [系统] 使用 /tpaccept 接受，或 /tpadeny 拒绝
Steve > /tpaccept
[系统] 已接受 Alex 的传送请求！
[系统] Steve 已接受你的传送请求！

✨ Alex 瞬间传送到 Steve 身边，两人开始愉快的探险！

场景二：紧急救援

队员Bob在探险中掉入峡谷，呼叫队友Alice救援：

Bob > Alice救命！我掉坑里了！
Alice > /tpa Bob
[系统] 已向 Bob 发送传送请求！
Bob > /tpaccept
[系统] 已接受 Alice 的传送请求！
[系统] Bob 已接受你的传送请求！

✨ Alice 传送到 Bob 身边，成功实施救援！

场景三：取消误操作

玩家发送请求后改变主意：

Charlie > /tpa David
[系统] 已向 David 发送传送请求！
Charlie > 等等，我还没准备好...
Charlie > /tpacancel
[系统] 已取消你的传送请求！
David > [系统] Charlie 取消了他们的传送请求！

✨ 完美避免尴尬情况！

---

📦 安装指南

系统要求

组件	要求
服务端核心	Bukkit / Paper / Purpur 1.20+
Java版本	Java 21 或更高版本
操作系统	Windows / Linux / macOS

安装步骤

1. 获取插件文件

   • 从官方发布页面下载最新版本的 tpa-plugin-1.0.0.jar

2. 部署插件

   • 将 tpa-plugin-1.0.0.jar 复制到服务器的 plugins 文件夹
   • 重启服务器或使用插件管理工具加载

3. 验证安装

   • 查看控制台输出，确认看到 [TPA] 插件已启用
   • 输入 /pl 查看插件列表，确认 TPA 出现在列表中

---

🧪 测试报告

环境信息

项目	详情
服务端	Purpur 1.21.11-2562-HEAD
Java版本	Java 24 (HotSpot 64-Bit)
操作系统	Windows 11 10.0 (amd64)

测试结果

测试项	预期结果	实际结果	状态
插件加载	控制台显示"插件已启用"	✅ [TPA] 插件已启用	通过
控制台执行 /tpa	提示只能由玩家执行	✅ "此命令只能由玩家执行"	通过
发送请求 /tpa Fuckmyass	请求成功发送	✅ 命令成功执行	通过
取消请求 /tpacancel	取消功能可用	✅ 命令成功执行	通过
接受请求 /tpaccept	传送成功	✅ 玩家确认传送成功	通过
拒绝请求 /tpadeny	拒绝功能可用	✅ 命令成功执行	通过
别名 /tpno	等同于拒绝命令	✅ 命令被正确识别	通过
别名 /tpcancel	等同于取消命令	✅ 命令被正确识别	通过

玩家反馈

[21:17:30] <Fuckmyass> omg
[21:17:36] <SeiclHal300> 成功了

玩家简短的对话，完美证明了传送功能的成功实现！

---

🔮 未来规划

短期计划（v1.1.0）

• 添加配置文件，支持自定义提示消息
• 实现请求超时自动取消（默认60秒）
• 添加传送前后的粒子效果

中期计划（v1.2.0）

• 传送保护机制（传送后5秒无敌）
• 请求冷却时间防止滥用
• 更丰富的提示颜色配置

长期计划（v2.0.0）

• 支持跨世界传送
• 图形化配置界面
• 传送请求统计和排行榜
• 与主流经济插件联动（传送收费）

---

📊 与其他插件对比

特性	TPA插件	其他同类插件
配置文件	无（开箱即用）	通常需要配置
请求管理	内存管理，速度快	有的使用文件存储
命令别名	丰富完整	视具体插件而定
中文支持	全中文提示	部分需要汉化
使用门槛	极低	可能需要学习配置

---

❓ 常见问题解答

Q1: 插件支持哪些服务端核心？

A: 支持所有基于Bukkit/Paper的服务端，包括但不限于：Paper、Purpur、Spigot、Tuinity等。

Q2: 需要安装其他依赖插件吗？

A: 不需要，本插件独立运行，无任何外部依赖。

Q3: 如何修改提示消息的颜色和内容？

A: 当前版本暂不支持自定义，v1.1.0将添加配置文件功能，届时可在配置文件中自由修改所有提示文本。

Q4: 请求会一直保存吗？

A: 不会，请求仅保存在内存中，服务器重启后所有未处理的请求将自动清除。

Q5: 支持1.12.2等旧版本吗？

A: 本插件专为1.20+设计，使用了较新的API特性，旧版本请使用其他兼容版本。

Q6: 玩家可以同时发送多个请求吗？

A: 每个玩家同时只能有一个待处理的传出请求，新请求会覆盖旧请求，这是为了避免混乱的设计。

Q7: 控制台为什么不能用这些命令？

A: 传送请求涉及玩家实体操作，设计上仅限于玩家使用，这是合理的设计限制。

Q8: 插件会生成数据库文件吗？

A: 不会，插件完全基于内存运行，不会在服务器上生成任何额外文件。

Q9: 传送请求有距离限制吗？

A: 没有距离限制，即使在世界的不同角落也可以互相传送。

Q10: 插件收费吗？

A: 完全免费！本插件永久免费使用，没有任何隐藏收费或限制功能。

---

📝 使用建议

对服务器管理员

1. 权限管理：如果需要限制某些玩家使用传送功能，可以通过LuckPerms等权限插件设置
2. 配合其他插件：可与领地插件、经济插件等配合使用，打造更完善的游戏体验
3. 定期更新：关注插件新版本，及时获取新功能和优化
4. 反馈建议：如果遇到问题或有改进建议，欢迎通过官方渠道反馈

对玩家

1. 礼貌使用：发送请求前最好先询问对方是否方便
2. 及时处理：收到请求后尽快回应，避免让对方久等
3. 合理使用：不要在危险场景（如战斗中）传送，可能造成不必要的损失
4. 善用别名：熟悉并使用别名可以提高操作效率

---

🙏 致谢

感谢所有支持本插件的服务器管理员和玩家，感谢Minecraft社区源源不断的创意和热情，正是有了这样充满活力的社区，才能诞生出这样一个又一个便利的工具。

特别感谢测试玩家SeiclHal300和Fuckmyass，他们的实际使用和反馈为插件的完善提供了宝贵的第一手资料。

感谢所有使用本插件的服务器和玩家，你们的支持是持续改进的动力。

---

📬 联系与支持

• 问题反馈：通过发布平台的Issue功能提交
• 功能建议：欢迎提出新功能想法
• 使用交流：与其他服主和玩家交流使用心得
• 更新关注：关注发布页面获取最新版本信息

---

📄 使用条款

本插件为免费软件，允许：

• ✅ 自由下载和使用
• ✅ 在服务器上自由安装
• ✅ 分享给其他服主
• ✅ 用于商业服务器

无需：

• ❌ 无需注明出处（但感谢标注）
• ❌ 无需支付任何费用
• ❌ 无需申请授权

---

🎯 总结

TPA传送请求插件虽然功能简单，但它完美解决了Minecraft服务器中一个最基本也最常用的需求——玩家之间的便捷移动。它以极小的资源占用、直观的操作方式和稳定的运行表现，成为服务器基础插件的优秀选择。

从用户体验看，插件提供了：

• 清晰的提示消息，使用不同颜色区分状态
• 完整的命令别名支持，适应不同习惯
• 双向通知机制，确保信息对称
• 零配置要求，即装即用

无论是三五好友的小型私服，还是成百上千人的大型社区，这个插件都能为玩家带来便利，为服务器增添活力。它证明了优秀的工具不一定要功能繁杂，把一件事情做到极致，同样能赢得用户的认可。

现在就下载使用，让你的服务器玩家体验无缝传送的便捷吧！

---

版本: 1.0.0 适用游戏版本: Minecraft 1.20 - 1.21.11 发布日期: 2026年2月 插件类型: 免费软件