Rptback —— 死亡 / 传送后一键返回，异步安全检测避免落进岩浆 [1.21 ~ 26.2] 1.0.0

R***

关于这个插件​Rptback 解决两个很常见的痛点：死了跑回去捡装备，以及被传送走后回不到原位。
​

• 玩家死亡时，聊天栏自动出现一个可点击的 [返回] 按钮，点一下就能回到死亡点，不用记指令、也不用翻聊天框找坐标。
• 玩家被其它插件传送走（回主城、参加活动、随机传送）之后，/back 可以回到传送前的位置。
  

返回之前会做一次异步安全检测：如果目标点是岩浆、火、虚空这类危险位置，插件会在附近自动寻找安全的落脚点，而不是把玩家直接丢进去送第二次死。
功能说明​1. 两种「上一地点」，自动记录​

触发	记录内容​	用途
玩家死亡	死亡时的位置	死亡后回去捡掉落物
玩家被传送（含被其它插件传送）	传送前的位置	被传走之后回到原地

插件自身执行的返回传送不会覆盖记录，所以连续使用 /back 不会把自己越传越偏。

2. 死亡后一键返回​

• 玩家死亡时，聊天栏会自动发出一条提示，后面跟着绿色的 [返回] 按钮。
• 鼠标悬停会显示「点击返回上一地点」，点击即执行返回（完全等价于输入 /back）。
• 玩家不需要记住任何指令，对新手非常友好。
  

3. 传送前的安全检测（核心特色）​返回之前，插件会在目标位置做一次完整的安全判定：

• 脚下必须有实心方块，并且不能是岩浆块或营火。
• 脚部与头部必须是空的（留有站立空间），且不能是危险方块：岩浆、火、灵魂火、甜浆果丛、细雪、凋灵玫瑰、仙人掌、滴水石锥、火珊瑚、末地传送门。
• 不会传送到世界高度限制之外（防掉出世界）。
  

如果目标点不安全，会在附近自动寻找落脚点：

情形	处理方式
目标点本身安全	直接传送
附近小范围有安全点	以目标为中心 ±3 格、上下 5 格环形搜索
小范围找不到	扩大到 半径 24 格，从地表向下逐格探测安全落脚（主世界 / 下界 / 末地通用）
整片区域都危险	退而使用该处最高方块的上方作为落点，并提示原地点存在危险
连最高方块都不可用（如虚空）	传送到原坐标，并明确提示「附近区域极其危险」

• 所有落脚点都会对齐到方块中心，避免玩家卡在方块边缘。
• 当落点偏离原目标超过约 1.4 格时，会提示「已将你安全传送到附近的落脚点」，不会静默改变位置。
  

4. 传送延迟与移动取消​

• teleport-delay 可配置延迟秒数（默认 3 秒，设为 0 则立即传送）。
• 等待期间显示倒计时提示「将在 N 秒后传送，请勿移动！」。
• 只要玩家跨过了方块（水平或垂直位移），传送立即取消并给出提示；同一方块内转头不算移动，不会误取消。
• 重复执行 /back 会提示「你已经在等待传送了」，不会叠加排队。
• 这套机制也顺带避免了战斗中靠 /back 跑路。
  

5. 完全适配 Folia​

• 已声明 folia-supported: true。
• 玩家相关数据全部调度到玩家所在区域线程执行；目标位置的安全检测在目标区域线程上运行，不跨线程访问方块数据。
• 实际传送走异步传送接口，不阻塞区域线程。
  

6. 多语言​

• 自带中文 / 英文语言文件（lang/zh.yml、lang/en.yml），用 language: zh 或 en 切换。
• 所有提示文案均可修改；帮助信息部分支持 MiniMessage 富文本格式。
  

支持版本与环境​

项目	说明
Minecraft 版本	1.21 ~ 26.2（实测通过：1.21 / 1.21.4 / 1.21.11 / 26.1.2 / 26.2）
服务端核心	Paper、Folia（已声明 folia-supported: true）
Java 运行环境	Java 21 及以上
不支持	1.20.x 及以下（插件 api-version 为 1.21，低版本核心会拒绝加载）
外部依赖	无。不依赖经济、数据库或任何其它插件

目标用户​

• 生存服 / 原版服服主 —— 死亡后跑尸捡装备是最折磨人的环节，一键返回的体验提升非常明显。
• 正在使用 Folia 核心的服主 —— 大量 /back 类插件在 Folia 上会因跨线程访问方块数据而报错，本插件从设计之初就按区域线程调度编写。
• 经常传送玩家的服务器 —— 回主城、活动传送、随机传送之后，玩家可以用 /back 回原位。
• 不希望玩家"传送逃课"的服主 —— 3 秒延迟 + 移动即取消，战斗中无法用它脱身。
  

是否付费​完全免费。 不需要授权、不需要联网校验，下载即用。
获取作者帮助​

途径	内容
交流群	QQ 群 1124248111
作者 QQ	2221899680
游戏内	输入 /rptb help 查看指令与说明

使用教程​安装​

• 将 Rptback-1.0.0.jar 放入服务端 plugins/ 目录。
• 重启服务端，首次启动会生成 plugins/Rptback/config.yml 与 lang/ 语言目录。
• 需要调整配置时执行 /rptb reload，无需重启服务端。
  

指令列表​

指令	权限	说明
/back	rptb.use	返回上一地点（死亡点或传送前位置）
/rptb reload	rptb.admin	重载配置与语言文件
/rptb help	默认	显示指令帮助

主指令为 /rptb，/rptback 为别名。

权限节点​

权限	默认值	说明
rptb.use	所有玩家	使用 /back 返回
rptb.admin	仅 OP	重载配置

主要配置项（config.yml）​

配置项	默认值	说明
language	zh	语言文件，可填 zh 或 en
teleport-delay	3	传送延迟秒数，设为 0 则立即传送

常见问题​

• 提示「没有找到可以返回的地点」？ 说明该玩家目前没有可返回的记录（例如刚上线、还没死过也没被传送过）。
• 提示「你移动了，传送已取消」？ 这是防逃课设计。等待传送时原地不要走动，等倒计时结束即可；转头不影响。
• 返回的落点为什么不是我死亡的位置？ 死亡点可能是岩浆、火、虚空等危险位置，插件会自动就近安置并给出提示，避免玩家一回去就再死一次。
• 返回之后还能继续返回吗？ 可以。插件自身的返回传送不会覆盖记录，连续返回不会越传越偏。
  

声明​

• 本插件为原创作品，保留所有权利，默认不允许转载与整合。如需转载或整合进服务端整合包，请先通过上方交流群或作者 QQ 联系获取授权。
• 本插件未使用任何混淆手段，欢迎安全审查。
• 本插件不含任何后门、病毒或远程控制代码，不收集任何玩家数据。