原创 开源 世界管理 修复 Multiverse 多世界下界门回程跑错世界/生成错误 world 门 1.0.8

MVNetherReturnFix 是一个专门为 Multiverse 多世界服务器编写的下界门回程修复插件。
很多多世界服务器会遇到这样的问题：玩家或实体从 `plotworld`、生存世界、资源世界等非默认世界进入下界后，返回时被错误送回默认 `world`，甚至在 `world` 生成新的错误地狱门。
这个插件会在实体进入下界时记录它的入口世界和入口地狱门；当它从下界返回时，把目标修正回原来的入口世界和对应地狱门，避免 Multiverse/Bukkit 使用默认世界作为回退目标。
主要功能
- 修复 Multiverse 多世界下界门回程跑错世界。
- 阻止找不到入口记录时回退到默认 `world` 并生成错误地狱门。
- 支持玩家、矿车、船、生物、怪物、掉落物等实体。
- 支持掉落物穿门，并处理掉落物卡门来回传送问题。
- 支持服务器重启后的根记录恢复。
- 使用 YAML 持久化，延迟批量保存，性能开销低。
- 支持世界白名单、世界黑名单、实体类型白名单/黑名单。
- 支持 `/mvnrf` 管理命令。
- 使用 Spigot API 编译，不依赖 Paper 专属 API。
适合谁使用
- 有多个生存世界的服务器。
- 使用 Multiverse-Core 管理多世界的服务器。
- 有 Plot 世界、资源世界、生存世界，并且都需要使用下界门的服务器。
- 生电服，需要实体、矿车、船、掉落物等通过地狱门进行加载或传送。
- 想保留原版地狱门体验，但修复 MV 回程错误的服务器。
依赖
必需：
- Multiverse-Core
可选：
- Multiverse-NetherPortals
## 兼容版本
- Minecraft 1.20+
- Java 17+
- Bukkit / Spigot / Paper / Purpur
命令与权限
命令：
- `/mvnrf reload` - 重载配置
- `/mvnrf status <uuid|player>` - 查看根记录
- `/mvnrf clear <uuid|player>` - 清除根记录
- `/mvnrf cleanup` - 清理过期记录
权限：
- `mvnrf.admin`
## 配置说明
```yml
enabled-worlds: []
ignored-worlds: []
tracked-entity-types:
- "*"
ignored-entity-types: []
portal-search-radius: 16
save-delay-seconds: 5
stale-root-days: 7
fallback-safe-teleport: true
cancel-unknown-nether-returns: true
blocked-return-cooldown-ticks: 200
item-portal-cooldown-ticks: 300
debug: false
```
重点配置：
- `cancel-unknown-nether-returns: true`：找不到入口记录时取消下界返回，防止错误生成 `world` 地狱门。
- `item-portal-cooldown-ticks: 300`：掉落物穿门后的冷却，避免掉落物在门里来回弹。
- `tracked-entity-types: ["*"]`：默认监听全部实体。
- `ignored-entity-types`：如果不想处理某些实体，可以放进黑名单。
注意事项
- 插件只修复下界门，不处理末地门、命令传送、随机传送或自定义传送门。
- 建议只保留最新版 jar，不要多个版本同时放入 plugins。
- 如果需要排查问题，可以把 `debug` 改成 `true`，然后使用 `/mvnrf reload`。
开源协议
MIT License