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. **验证安装** - 查看控制台输出，确认看到 ` 插件已启用` - 输入 `/pl` 查看插件列表，确认 `TPA` 出现在列表中 --- ## 🧪 测试报告 ### 环境信息 | 项目 | 详情 | |------|------| | 服务端 | Purpur 1.21.11-2562-HEAD | | Java版本 | Java 24 (HotSpot 64-Bit) | | 操作系统 | Windows 11 10.0 (amd64) | ### 测试结果 | 测试项 | 预期结果 | 实际结果 | 状态 | |--------|----------|----------|------| | 插件加载 | 控制台显示"插件已启用" | ✅ 插件已启用 | 通过 | | 控制台执行 `/tpa` | 提示只能由玩家执行 | ✅ "此命令只能由玩家执行" | 通过 | | 发送请求 `/tpa Fuckmyass` | 请求成功发送 | ✅ 命令成功执行 | 通过 | | 取消请求 `/tpacancel` | 取消功能可用 | ✅ 命令成功执行 | 通过 | | 接受请求 `/tpaccept` | 传送成功 | ✅ 玩家确认传送成功 | 通过 | | 拒绝请求 `/tpadeny` | 拒绝功能可用 | ✅ 命令成功执行 | 通过 | | 别名 `/tpno` | 等同于拒绝命令 | ✅ 命令被正确识别 | 通过 | | 别名 `/tpcancel` | 等同于取消命令 | ✅ 命令被正确识别 | 通过 | ### 玩家反馈 ``` <Fuckmyass> omg <SeiclHal300> 成功了 ``` 玩家简短的对话，完美证明了传送功能的成功实现！ --- ## 🔮 未来规划 ### 短期计划（v1.1.0） - 添加配置文件，支持自定义提示消息 - 实现请求超时自动取消（默认60秒） - 添加传送前后的粒子效果 ### 中期计划（v1.2.0） - 传送保护机制（传送后5秒无敌） - 请求冷却