生成配置 procgen.yml

位置：plugins/QueDP/dungeons/<副本ID>/procgen.yml。所有项都可省略，空文件也能运行。

常用写法：

length: standard       # short / standard / long
mob-level: "1-3"
modifiers: 0.35
spawn-telegraph: true

改完 /pg reload，再 /pg check 副本ID。也可以用网页工作台配置。

房间

项	默认	说明
`room-set`	副本 ID	房间集文件夹名
`length`	—	副本长度，见下表
`counts`	—	各房型精确数量，覆盖 `length`

`length`	战斗	商店	宝藏	精英	事件	休息
`short` / `短线`	3	1	1	0	0～1	0
`standard` / `标准`	4～5	1	1	0～1	0～1	0～1
`long` / `长线`	6～7	1	1～2	1	1	1
都不写	4	1	1	0～1	0～1	0～1

每局固定 1 起点、1 Boss。房间集没有的房型自动跳过。

counts:
  combat: "5-7"    # 固定数字或范围
  elite: 1

可写：combat、shop、treasure、elite、event、rest。

战斗

项	默认	说明
`mob-level`	`1`	MythicMobs 等级，范围时每波随机
`seal-combat-doors`	`true`	战斗房封门
`seal-material`	`IRON_BARS`	封门方块
`wave-delay`	`40`	波次间隔（tick）
`elite.level-bonus`	`2`	精英房额外等级

词缀 modifiers

modifiers: 0.35        # 概率，true 等于 0.35，不写为关闭
# 或
modifiers:
  chance: 0.5
  pool: [atlantis, bounty]   # 词缀 ID 或词缀包文件名，默认全部
  include-boss: false        # 默认 true

见房间词缀。

刷怪预兆 spawn-telegraph

spawn-telegraph: true
# 或
spawn-telegraph:
  delay: 20                                # tick，0～100
  particle: BUBBLE_COLUMN_UP               # 默认 PORTAL，只能用无参数粒子
  sound: entity.player.splash.high_speed   # 默认 entity.evoker.prepare_summon
  volume: 0.8
  pitch: 1.0

走廊和门

项	默认	说明
`door-width` / `door-height`	`5` / `5`	门洞尺寸，高度也是走廊内高
`corridor-length`	`6`	走廊基准长度，0 为房间相贴
`corridor-template`	—	走廊模板名
`corridor-floor` / `-wall` / `-ceiling`	`STONE_BRICKS`	无模板时的走廊方块

挑战与评级

challenges（默认关闭）和 grading（默认开启）的写法见玩法机制。

地图种子 seed-mode

值	效果
`random`	默认，每次随机
`daily`	全服每天同一张图
`fixed`	固定，配合 `seed-value: 12345`

进阶

项	默认	说明
`grid-size`	`9`	布局网格边长
`cell-size`	自动	行列间距，默认按最大房间计算
`base-y`	`64`	房间地板高度
`paste-budget-ms`	`6`	每 tick 粘贴耗时上限，1～6

全局默认值

附属 config.yml 的 defaults 可设置布局、门、走廊类配置（base-y、door-*、grid-size、paste-budget-ms、corridor-*），各副本只写不同的部分。房间数量、词缀、战斗、挑战、评级不继承。

完整示例

counts: {combat: 3, elite: 1, event: 1, rest: 1}
modifiers:
  chance: 0.55
  pool: [atlantis]
  include-boss: false
spawn-telegraph:
  particle: BUBBLE_COLUMN_UP
  sound: entity.player.splash.high_speed
corridor-template: atlantis_arch
seal-material: CYAN_STAINED_GLASS
elite: {level-bonus: 0}
grading: {par-seconds-per-room: 95}
challenges:
  timed: {chance: 0.25, seconds: 100}
  encore: true
  reward: AT_Challenge

附属目录的 procgen-example.yml 是带注释的完整示例。