任务配置 tasks.yml

tasks.yml 定义了地牢中的自动化任务。支持三种类型：定时任务、循环任务和事件任务。

定时任务

在副本运行的特定时间点执行脚本。

tasks:
  countdown:
    type: 定时
    times:
      300:  # 第 300 秒时执行
        - "action.message('@all', '&e还剩 5 分钟！')"
      60:   # 第 60 秒时执行
        - "action.message('@all', '&c还剩 1 分钟！')"
        - "action.sound('@all', 'ENTITY_ENDER_DRAGON_GROWL')"
      10:   # 第 10 秒时执行
        - "action.title('@all', '&c10', '&7秒')"

循环任务

每隔固定时间重复执行脚本。

tasks:
  buff_timer:
    type: loop
    interval: 60                      # 每 60 秒执行一次
    script:
      - "action.apply_potion('@all', 'SPEED', '10s', 0)"
      - "action.message('@all', '&a速度增益已刷新')"

事件任务

在特定游戏事件发生时触发脚本。

tasks:
  kill_counter:
    type: event
    trigger: monster_kill             # 每次击杀怪物时触发
    script:
      - "action.actionbar('@trigger', '&a击杀！总击杀: {total_kills}')"

  wave_complete_task:
    type: event
    trigger: wave_complete            # 怪物组完成时触发
    trigger_target: wave_1            # 仅 wave_1 完成时触发（不指定则所有组都触发）
    script:
      - "action.message('@all', '&a波次完成！')"

事件触发类型

触发	说明
monster_kill	每次击杀怪物时触发
wave_complete	怪物组全部被击杀时触发

字段说明

字段	类型	适用类型	说明
type	String	全部	任务类型，默认 定时。循环：循环/loop；事件：事件/event；其余值均按定时处理
times	Map	定时	时间点到脚本列表的映射
interval	Int	loop	循环间隔（秒），默认 60
script	List	loop/event	执行的脚本
trigger	String	event	事件类型
trigger_target	String	event	指定触发的怪物组ID（可选）