常见问题
先跑 /pg check 副本ID。
进不去副本 / 提示房间集不存在
Section titled “进不去副本 / 提示房间集不存在”副本 'my_dungeon' 引用的房间集 'grand' 不存在或为空，已跳过room-set 对应的文件夹不存在或没有 .schem。文件夹名要和 room-set（未写时为副本 ID）一致，且至少有起点、战斗、Boss 三种房间。用 /pg info、/pg rooms 房间集 检查。
商人 / NPC 没出来
Section titled “商人 / NPC 没出来”需要 npcs.yml 定义该 NPC，且房间 yml 里有对应 NPC 点。NPC 在首次进房时才生成。
宝箱 ID 必须存在于 chest_rewards.yml。
门的位置不对
Section titled “门的位置不对”编辑器里橙色粒子是默认门位置，那里保持实心墙、内侧别挡路。要改位置用铁门自定义。
控制台说「房间占地过小」
Section titled “控制台说「房间占地过小」”房间 'grand/tiny_room' 水平占地 5x5 过小，副本 'my_dungeon' 的门洞需要至少 7x7房间每边至少比门宽多 2 格。加大房间或调小 door-width。
走廊比设置的长
Section titled “走廊比设置的长”同一列有大房间时小房间居中，空隙变成走廊。让房间尺寸接近，或调小 corridor-length。
复活到了奇怪的地方
Section titled “复活到了奇怪的地方”在副本 config.yml 设原地复活：
revive: auto: at: in_place掉虚空时会改到起点房复活。
改了配置没生效
Section titled “改了配置没生效”执行 /pg reload 或 /dg admin reload。正在进行的副本不会变，要新开一局。
房间墙上有洞 / 控制台刷 Invalid BlockState
Section titled “房间墙上有洞 / 控制台刷 Invalid BlockState”Schematic was made in a newer Minecraft version (3465 > 2586). Data may be incompatible.Invalid BlockState in palette: minecraft:deepslate_tiles. Block will be replaced with air.房间用了当前版本没有的方块。在服务器版本上重做房间，或换掉这些方块。
1.16 服控制台有一行 No key layers / No key structures
Section titled “1.16 服控制台有一行 No key layers / No key structures”No key layers in MapLike[{}]; No key structures in MapLike[{}]可忽略。
第一次开服特别慢，控制台在刷百分比
Section titled “第一次开服特别慢，控制台在刷百分比”在生成空白地图模板，只有首次（或模板需要重建时）会这样，完成前不能开本。
网页工作台打不开
Section titled “网页工作台打不开”- 默认只能本机访问，外网访问见网页工作台
- 链接 5 分钟有效、只能用一次
选怪界面里没有我的怪
Section titled “选怪界面里没有我的怪”新怪要先重载 MythicMobs。名字含 Dummy、Death、Illusion、Totem 的不显示，用「手动输入」。
/pg room：当前房间状态/pg list：运行中的地牢- 控制台
[QueDP-ProcGen]警告会写明原因