基础配置 config.yml

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

完整配置

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

# ===== 世界配置 =====
world:
  template: dungeon_example      # 服务器根目录下的模板世界文件夹名
  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:数量
  item_check_mode: ALL           # ALL = 所有成员都需持有；LEADER = 仅队长持有
  required_permissions:
    - "quedp.dungeon.example"
  placeholder_conditions:        # PAPI 入场条件（需 PlaceholderAPI）
    - "%player_level% >= 30"     # 运算符：>= <= > < == !=

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

# ===== 时间限制 =====
time:
  limit: 1800                    # 秒（0 = 无限制）
  timeout_action: FAIL           # FAIL = 标记失败；KICK = 踢出玩家

# ===== 实例限制 =====
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	服务器根目录下的模板世界文件夹名
`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）；别名 `money`
`requirements.stamina_cost`	Int	0	消耗的体力值
`requirements.required_items`	List	空	进入时消耗的物品，格式 `物品ID:数量`
`requirements.item_check_mode`	Enum	ALL	`ALL`=所有成员都需持有；`LEADER`=仅队长持有
`requirements.required_permissions`	List	空	所需权限节点
`requirements.placeholder_conditions`	List	空	PAPI 入场条件（需 PlaceholderAPI），别名 `变量条件`

PAPI 条件格式为 "%占位符% 运算符值"，支持运算符 >= <= > < == !=。左右两边都会用 PlaceholderAPI 解析，两边均为数字时按数值比较，否则仅支持 == / !=；不写运算符时按布尔判断（结果为 true/1/yes 视为通过）。队伍进入时，每个在线成员都需满足。

时间与实例

字段	类型	默认值	说明
`time.limit`	Int	1800	时间限制（秒）
`time.timeout_action`	String	FAIL	超时处理：`FAIL`=标记失败并触发失败脚本；`KICK`=踢出玩家
`instance.max_instances`	Int	-1	同时运行的最大实例数（-1 = 无限制）
`death_check_mode`	String	strict	`strict`=必须有人存活才能复活，全员死亡立即触发 `all_death`；`lenient`=等待复活脚本执行完毕，不立即判定失败