基础配置 config.yml

config.yml 是每个地牢必需的配置文件，定义了地牢的基础信息和进入要求。

完整配置

# ===== 地牢信息 =====
dungeon:
  name: "&6&l示例地牢"           # 支持颜色代码
  icon: DIAMOND_SWORD            # Bukkit Material 名称
  difficulty: 普通
  description:
    - "&7一个简单的示例地牢"
    - "&7适合新手体验"

# ===== 世界配置 =====
world:
  template: my_map               # maps/ 目录下的地图模板名
  spawn: "0,64,0,0,0"            # x,y,z,yaw,pitch

# ===== 进入要求 =====
requirements:
  min_level: 1
  max_level: 100
  min_players: 1
  max_players: 4
  cooldown: 3600                 # 秒
  money_cost: 0                  # 需要 Vault（0 = 不消耗）
  stamina_cost: 0                # 0 = 不消耗体力
  required_items:                # 进入时消耗
    - "DIAMOND:1"                # 格式：物品ID:数量
  required_permissions:
    - "quedp.dungeon.example"

# ===== 副本内限制 =====
blacklist:
  commands:
    - "spawn"
    - "home"
  items:
    - "ENDER_PEARL"

# ===== 时间限制 =====
time:
  limit: 1800                    # 秒（0 = 无限制）
  timeout_action: FAIL           # FAIL = 失败

# ===== 实例限制 =====
instance:
  max_instances: -1              # -1 = 无限制

# ===== 死亡检查 =====
death_check_mode: strict
# strict  - 严格模式：全员死亡立即触发 all_death 脚本
# lenient - 宽松模式：等待复活脚本执行后再判定

字段说明

地牢信息

字段	类型	默认值	说明
dungeon.name	String	文件夹名	显示名称，支持 & 颜色代码
dungeon.icon	Material	DIAMOND_SWORD	菜单中显示的图标
dungeon.difficulty	String	普通	难度标签
dungeon.description	List	空	描述文本列表

世界配置

字段	类型	默认值	说明
world.template	String	world	maps/ 下的模板名
world.spawn	String	0,64,0,0,0	格式：x,y,z,yaw,pitch

进入要求

字段	类型	默认值	说明
requirements.min_level	Int	1	最低等级要求
requirements.max_level	Int	100	最高等级限制
requirements.min_players	Int	1	最少玩家数
requirements.max_players	Int	4	最多玩家数
requirements.cooldown	Int	3600	再次进入的冷却（秒）
requirements.money_cost	Double	0	入场费用（需 Vault）
requirements.stamina_cost	Int	0	消耗的体力值
requirements.required_items	List	空	进入时消耗的物品
requirements.required_permissions	List	空	所需权限节点

时间与实例

字段	类型	默认值	说明
time.limit	Int	1800	时间限制（秒）
time.timeout_action	String	FAIL	超时后的处理方式
instance.max_instances	Int	-1	同时运行的最大实例数
death_check_mode	String	strict	strict 或 lenient

提示

队伍进入地牢时，会检查所有在线队员是否满足等级、权限、物品和金币要求。