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

- Java 21 Optimized - Easy to remember and use - Java 21 Optimized - Send, accept, deny, and cancel requests - Java 21 Optimized - Multiple aliases for each command - Java 21 Optimized - Plug and play, zero setup required - Java 21 Optimized - Minimal impact on server performance - Java 21 Optimized - 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. Cancel: `/tpa Steve` 2. Cancel: "Steve wants to teleport to you!" 3. Cancel: `/tpaccept` - Teleports requester to you 4. Cancel: `/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

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

TPA Teleport Request Plugin - Chinese

🌟 插件概述

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

---

✨ 核心特色

| 特性 | 描述 | |------|------| | 🚀 完整流程 | 无配置文件，即插即用，几乎不占用服务器资源 | | 🌐 完整流程 | 完美兼容 Minecraft 1.20 - 1.21.11 | | ☕ 完整流程 | 采用最新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月* *插件类型: 免费软件*