IGNGTeleport传送集合插件
IGNGTeleport 传送集合插件教程
IGNGTeleport 是专为 IGNG Minecraft Java 后端深度定制的次世代传送集合插件，原生完美支持 Paper 与 Folia 分区域多线程调度架构。
本插件为玩家与服主提供了一站式的传送解决方案，涵盖 个人家园（Home）、公共传送点（Warp）、玩家互传（TPA） 以及 全维度安全随机传送（RTP）。数据按后端服务器严格隔离并采用异步安全事务持久化，确保极端并发下的平稳流畅。
核心特性与架构机制
- 多线程并发安全：针对 Folia 跨区调度机制深度优化，所有方块采样与实体传送均在所有权归属线程执行，彻底告别区块加载卡死与线程越界。
- 多服数据隔离：Home 与 Warp 数据依据当前服务器的
server_id进行逻辑隔离。不同子服拥有独立的家园列表与地标设置，互不干扰。 - 严格安全落地检测：传送前自动检测目标位置的地表支撑、头顶/脚下净空以及四周岩浆、深坑或虚空边缘，拒绝危险落地。
- 预热与防脚本打断机制：传送任务具备可配置的预热倒计时，玩家在预热期间移动、受伤、乘骑载具或退服将自动安全取消。
- 智能交互与分页浏览：聊天栏全量支持 MiniMessage 富文本交互，点击可直接传送或处理请求，并支持多条目流畅分页。
一、 个人家园系统（Home）
家园系统允许玩家记录自己的基地、矿洞或农场坐标，并在任意时刻安全返回。
1. 基础指令
/sethome [名称]
/home [名称]
/delhome <名称>
/homes [页码]
- /sethome [名称]：保存当前站立位置为一个 Home。若省略名称，默认命名为
home。 - /home [名称]：传送到指定的 Home。若未输入名称且仅有一个家或存在默认
home，系统会自动带你前往。 - /delhome <名称>：删除不再需要的指定 Home。
- /homes [页码]：以分页形式列出当前服务器保存的所有 Home，每页展示 8 个，并提供
[上一页]与[下一页]交互按钮。
2. 交互与特性
- 快捷点击传送：在输入
/homes打开列表后，点击聊天栏中的家园名称即可立即发起传送。 - 家园上限限制：普通玩家默认拥有基础家园上限（默认 5 个），拥有更高 VIP 或身份组权限的玩家可解锁 3、5、10 或无限制上限。
- 命名规范：家园名称支持中英文字符与空格（最长 32 个字符），系统会自动过滤零宽字符与欺骗性控制字符。
二、 公共地标系统（Warp）
公共传送点是由管理员预先设定的全服公用地标（如主城、资源区、副本大厅、公共交易区等）。
1. 玩家传送指令
/warp [名称]
/warps [页码]
- /warp [名称]：发起前往指定公共地标的传送。
- /warps [页码]：列出当前服务器开放的所有 Warp。支持分页浏览，并在聊天栏中直接点击名称快捷传送。
2. 管理员地标管理指令
/setwarp <名称>
/delwarp <名称>
- /setwarp <名称>：将管理员当前脚下位置设置为新的全服公共地标（需要
igngteleport.warp.set权限）。 - /delwarp <名称>：永久注销指定的公共地标（需要
igngteleport.warp.delete权限）。
三、 玩家互传系统（TPA / TPAHere）
玩家互传支持双向请求模式，并配备了防挂机骚扰与指令防脚本伪造机制。
1. 发起传送请求
/tpa <玩家>
/tpahere <玩家>
/tpacancel
- /tpa <目标玩家>：请求将自己传送到对方身边。
- /tpahere <目标玩家>：请求将对方拉取传送到自己身边。
- /tpacancel：主动撤回你当前正在等待对方处理的所有外发 TPA 请求，并同步终止预热中的互传任务。
2. 处理收到的请求
当其他玩家向你发送传送请求时，聊天栏会收到醒目的提示信息，并附带可交互按钮：
- 聊天栏快捷点击：直接点击
[接受]或[拒绝]按钮即可秒级响应。 - 指令手动响应：
若当前同时收到多个请求，可以附带玩家名字指定接受某位玩家的请求。/tpaccept [玩家] /tpdeny [玩家]
3. 接收设置开关
如果你正在专注建造、战斗或不希望被频繁打扰，可以切换接收状态：
/tpatoggle [on|off]
- 执行
/tpatoggle off将全局关闭 TPA 接收，其他玩家对你发起互传时会直接提示对方已关闭接收。 - 执行
/tpatoggle on可重新开放接收通道。设置会自动跨会话保存。
四、 全维度安全随机传送（RTP）
随机传送功能能帮助玩家瞬间探索未知的旷野，非常适合生存界面的开荒与资源采集。
1. 发起随机传送
在支持的世界中直接输入：
/rtp
2. 安全与地形机制
- 全维度环境原生支持：
- 主世界（Overworld）：在地表寻找安全的草地、石块等坚固方块，自动规避海洋、深渊、岩浆湖与树冠顶层。
- 下界（Nether）：在安全的岩浆海上方至基岩天花板下方之间寻找双层中空洞穴落地，严防窒息与下界顶部天花板。
- 末地（The End）：自动校验末地空岛与末影石平台，严禁将玩家丢入虚空或下落边缘。
- 边缘采样保护：在 Folia 多线程架构下，系统在校验安全半径（默认 2 格）前，会自动预加载目标点周边的所有涉及区块，杜绝跨区采样未加载区块引发的服务端异常。
- 搜索冷却与限制：RTP 包含独立的全局并发防卡顿限流与玩家个人冷却时间（默认 300 秒），防止频繁盲目刷取传送点造成服务器负载波动。
五、 传送状态与安全打断机制
为了保证游戏内 PVP 与生存玩法的公平性，所有需要预热的传送（默认 5 秒，VIP/OP 可减免）均受到安全状态机监控：
| 触发场景 | 处理结果 | 游戏内反馈 |
|---|---|---|
| 发生位移 | 传送取消 | 移动超出容差阈值（默认 0.2 格）即自动取消预热 |
| 受到任何伤害 | 传送取消 | 预热期间遭遇跌落、攻击、着火等伤害立即打断 |
| 角色死亡 / 退服 | 状态清理 | 传送终止，自动释放所有 TPA 状态锁并取消任务 |
| 乘骑或进入载具 | 传送取消 | 防止利用载具位移产生漏洞 |
| 落点存在危险 | 传送取消 | 目标落点有岩浆、水流、虚空或被方块封堵时取消并返还状态 |
六、 常见问题与排错指南
| 提示信息 | 产生原因 | 推荐解决方式 |
|---|---|---|
| 已达到 Home 数量上限 | 个人家园保存数量已达到当前权限组额度 | 使用 /delhome <名称> 删除多余的家，或提升权限等级 |
| 目标位置不安全，传送已取消 | 目标坐标被方块填塞、下方悬空或存在熔岩液体 | 重新挑选安全平整位置设置 Home/Warp，或再次执行 /rtp |
| 传送已取消（moved） | 预热倒计时期间玩家进行了移动或位移 | 输入传送指令后请保持静止，直到倒计时结束传送成功 |
| 对方已关闭 TPA 接收 | 对方使用了 /tpatoggle off 或将你加入了忽略列表 |
提醒对方输入 /tpatoggle on 开启接收功能 |
| RTP 冷却中，还需 X 秒 | 触发了随机传送的内置冷却计时 | 等待冷却倒计时结束后重试，或联系管理员获取冷却减免权限 |
| 该方向的 TPA 请求正在处理中 | 之前发起的同方向互传仍在预热或等待对方响应 | 输入 /tpacancel 撤销旧请求后再重新发起 |
七、 权限节点速查表
面向服主与服务器管理人员配置 LuckPerms 或权限组系统使用。
| 权限节点 | 默认分配 | 功能说明 |
|---|---|---|
igngteleport.home.use |
玩家默认 | 允许使用 /home 传送到家以及 /homes 查看列表 |
igngteleport.home.set |
玩家默认 | 允许使用 /sethome 保存个人家园 |
igngteleport.home.delete |
玩家默认 | 允许使用 /delhome 删除个人家园 |
igngteleport.warp.use |
玩家默认 | 允许使用 /warp 和 /warps 前往公共地标 |
igngteleport.tpa.send |
玩家默认 | 允许使用 /tpa、/tpahere 和 /tpacancel |
igngteleport.tpa.receive |
玩家默认 | 允许使用 /tpaccept 与 /tpdeny 处理收到的互传请求 |
igngteleport.tpa.toggle |
玩家默认 | 允许使用 /tpatoggle 切换互传接收状态 |
igngteleport.rtp.use |
玩家默认 | 允许使用 /rtp 进行安全随机传送 |
igngteleport.teleport.warmup.bypass |
OP拥有 | 免除传送预热倒计时，实现瞬间传送 |
igngteleport.rtp.cooldown.bypass |
OP拥有 | 免除 /rtp 随机传送的冷却等待时间 |
igngteleport.warp.set |
OP拥有 | 允许使用 /setwarp 创建新的公共地标 |
igngteleport.warp.delete |
OP拥有 | 允许使用 /delwarp 删除已有的公共地标 |
igngteleport.home.limit.3 |
自定义配置 | 将家园保存数量上限设置为 3 个 |
igngteleport.home.limit.5 |
自定义配置 | 将家园保存数量上限设置为 5 个 |
igngteleport.home.limit.10 |
自定义配置 | 将家园保存数量上限设置为 10 个 |
igngteleport.home.limit.unlimited |
OP拥有 | 拥有无限制的家园保存数量配额 |
igngteleport.admin.status |
OP拥有 | 允许执行 /igtp status 查看插件运行与连接状态 |
igngteleport.admin.reload |
OP拥有 | 允许执行 /igtp reload 热重载配置与提示消息 |
