更新日志

本页记录 QueDP 本体的版本更新内容。图标含义：✨ 新增功能 · ⚡ 优化改进 · 🐛 问题修复 · 🔌 API / 附属开发。

2026-07-05

🐛 修复低版本地图在高版本服务器上的区块损坏：此前副本世界通过 NMS 快速创建时固定使用种子 0，导致地图中从未生成过的区块、或加载失败的区块会按错误地形重新生成（常见表现为地图中凭空出现一堵「海洋墙」）。现已改为读取地图自带的世界种子，缺失区块的补全地形与原图一致，行为对齐 Multiverse 等多世界插件。
🐛 区块修复器不再误删数据：坐标修复工具在遇到无法解析的区块（如 1.20.5+ 的 LZ4 压缩区块、存放于外部 .mcc 文件的超大区块）时改为跳过并保留原始数据，不再当作损坏区块清除。
🐛 修复编辑 / 保存副本时偶发的区块损坏：世界保存为异步落盘，此前保存后立即复制世界文件有几率拷到尚未写完的区块数据，表现为「有时损坏、过一会儿又正常」。现在保存后会强制等待数据落盘再复制，并调整缓存写入顺序（以 level.dat 作为完整性标记），杜绝复制到半份世界。

✨ 副本进入条件支持 PlaceholderAPI 变量：可在进入条件中配置任意 PAPI 变量表达式作为准入门槛，且校验逻辑与入场扣费解耦——门槛校验（等级 / PAPI 等）与成本扣除（物品 / 金币）互相独立，门票单人入场时跳过扣费但仍会校验门槛。

✨ PlaceholderAPI 脚本变量透传：新增 %quedp_var_<变量名>%，可在计分板/Tab 等任意位置读取玩家当前副本实例的持久脚本变量。脚本或附属插件写入的状态（如房间进度、词缀、评级）都能直接显示。详见 PlaceholderAPI 变量。
✨ 兼容 Mohist 1.16.5：新增 1.16.5 专用 NMS 世界创建器，在该版本 Mohist 上也能秒级建出副本世界。
🔌 新增 QueDPAPI.Script.instanceContext(instance)，附属插件可访问与实例同生命周期的持久脚本上下文，写入的变量可被 track_task 与 %quedp_var_% 读取。

✨ 副本防逃逸系统：拦截末影珍珠、紫颂果、传送门等非法逃出副本的手段。支持 BLOCK（拦截）/ TELEPORT_BACK（拉回出生点）/ FAIL（判负）三种模式，命令与插件传送不受影响。详见配置文件 · 防逃逸。
✨ 新增脚本动作 trigger_interact：按名称触发 interacts.yml 中定义的交互点，条件/once/脚本全部走本体原生逻辑。详见地牢类动作。
✨ spawn_npc 支持坐标覆盖：可在引用配置的同时传入实际生成坐标，适配程序化副本等动态世界。详见 NPC 类动作。
✨ NMS 快速建世界支持自定义区块生成器，并新增虚空世界创建接口。
🐛 修复纯商店 / 纯对话 NPC 点击无响应：脚本生成的 NPC 现在始终注册点击回调。
🐛 修复路径穿越漏洞与副本创建时的并发隐患。
🐛 修复队伍成员界面无法解析 PlaceholderAPI 变量的问题。
🐛 启动横幅改为在插件启动阶段打印。
🔌 新增 QueDPReloadEvent 重载完成事件，/dg admin reload 后触发，供附属插件联动重载自身配置。
🔌 新增副本世界提供者 SPI 扩展点（DungeonWorldProvider），附属插件可接管副本世界的创建/销毁。
🔌 API 回调统一改用 java.util.function 类型，避免 TabooLib 重定向后外部插件签名不匹配。

✨ 队伍仓库开关：新增 party.storage.enabled 配置项，可整体关闭队伍仓库功能。
✨ 强制副本内共享：新增 party.force-dungeon-only-share-scope，开启后队伍战利品/经验共享范围被强制锁定为「仅副本内」。
⚡ revive 动作支持原地复活：传入 原地 / inplace 参数可在死亡位置复活，而非传送回出生点。详见玩家类动作。
🔌 新增怪物相关事件：DungeonMobSpawnEvent（怪物生成）、DungeonMonsterGroupStartEvent（怪物组即将启动，可取消用于跳波）。
🔌 扩展对外 API 与选择器工具，新增 MythicMobs 集成接口。

✨ BossBar 动态变色：boss_bar('update', ...) 新增 颜色=COLOR 参数，可在更新时动态改变进度条颜色。详见特效类动作。
🐛 副本清理时自动移除脚本创建的 BossBar，避免残留。
🐛 修正 world_time 的 HH:MM 换算：现在与现实钟表一致（Minecraft 的 0 tick 对应 06:00）。详见世界类动作。
⚡ 完善 Wiki 文档：新增权限节点页面、补全体力/更新配置说明、补充 dungeon 对象方法列表与 NPC 动作文档。