常见问题

主命令到底是什么？

统一使用 /lidungeon。旧 /md、/mythicdungeons 不应再出现在玩家教程、NPC、菜单或公告中。

快捷命令 /leave、/stuck、/ready、/notready、/recruit、/rewards、/party、/p 仍保留。

玩家怎么进入地牢？

/lidungeon play <地牢>

join 是管理员进入某个玩家的实例：/lidungeon join <玩家>。

edit 会自动创建地牢吗？

不会。Paper 上先 create，再 edit。Folia 不能运行期建图，可在同版本 Paper 测试服创建后迁移，也可用 /lidungeon import 导入服务器根目录下未加载的离线世界。

副本是不是多世界？

是，但 Paper 与 Folia 实现不同。Paper 可使用传统动态世界；Folia 使用预加载多世界池，每个池世界同一时间承载一个实例。未配置有效池时会在一个已加载世界的远端区域隔离多个实例。

Folia 配几个世界？

按峰值并发和维度准备。例如普通维度计划同时运行 4 个实例，NORMAL 池至少准备 4 个有效世界，建议再留 1 个余量。全局和单地牢上限也要同步评估。

为什么控制台说回退，但地牢仍能玩？

回退模式是兼容方案，不是加载失败。它说明该维度没有有效独占池，插件改在单容器世界的远端区域运行。正式服建议修复世界加载/维度配置。

原插件到底有多少触发器？

当前完整运行清单为 15 个。MythicMobs 安装后普通生物死亡触发器被 Mythic 版本替换，所以仍是 15。房间门和进入/离开房间属于程序化场景。

基础环境另有 38 个功能和 9 个条件；MythicMobs、Citizens、PlaceholderAPI 会增加或替换对应项目。

为什么触发器列表里没有 PlaceholderAPI？

PlaceholderAPI 提供的是“占位符检查”条件，不是触发器。

“完成地牢”和“离开地牢”有什么区别？

完成功能会登记通关，可触发完成冷却和后续前置条件；离开功能只把玩家移出实例。玩家用 /leave 也不等于完成。

修改配置后要重启吗？

• 全局普通配置：/lidungeon reload。
• 单地牢配置：/lidungeon reload <地牢>。
• 世界池、世界加载顺序、增删依赖、libraries：完整重启。
• 活动实例：建议清空后重载并新开实例验证。

配置升级会覆盖我的中文消息或数值吗？

设计上只补齐缺失键和注释，不覆盖已有值、额外节点和自定义文本。但更新前仍必须备份，尤其是从旧 MythicDungeons 迁移时。

/lidungeon reload all 为什么要执行两次？

游戏内检测到活动实例时，第一次只警告并排队确认；再次执行才重载。控制台执行没有这层游戏内确认，生产服使用控制台前更要检查活动实例。

为什么保存成功后地图方块还是没落盘？

Folia 经典编辑会优先保存功能/触发器等元数据，完整方块区域可能在最后一名编辑者退出后提交。执行 save、等待提示、正常 leave，不要立即强制关服。

OP 为什么仍然进不去？

进入要求除了 Bukkit 权限，还可能包含人数、距离、等级、费用、钥匙、冷却和 Mythic JoinSkill。OP 不应被当作所有业务条件的自动绕过；查看具体提示和配置。

可以使用 PlugMan 或 /reload 吗？

不建议。LiDungeon 有调度任务、实例、监听器、世界容器、可选 API 和文件操作，热卸载容易留下状态。更换 Jar、依赖或世界池时完整重启。

会自动关服务器吗？

插件不会因为更新、地牢完成或配置迁移自动关闭操作系统。服务器关闭只会在管理员、面板或系统明确执行关机/停服操作时发生。

如何判断服务器加载的是新 Jar？

1. /lidungeon help 看版本。
2. 检查启动日志插件版本。
3. 确认 plugins/ 只有一个 LiDungeon Jar。
4. 检查 plugins/update/ 和面板自动同步目录。
5. 对实际 Jar 计算哈希并与发布文件对比。