Skip to content

限时活动目录

plugins/DungeonMaster/限时活动/ 这套能力在源码里已经有活动结构和调度器,但当前主流程还没有把这个目录自动加载进去。

就现阶段来说,这个目录更适合按预留功能看,不建议直接拿来当正式服核心玩法。

先看现状

  • 源码里已经有 ActivityScheduler 和活动配置解析器
  • 支持的字段和时间规则也已经写好
  • 但主启动流程里目前只会放出示例文件,还没有把目录内容真正送进调度器

如果后面源码把接线补上了,这页文档再按正式功能扩写会更合适。

当前解析器认哪些字段

yaml
周末挑战赛:
  显示名称: '&6周末挑战赛'
  启用: true
  类型: 每周
  星期:
    - 6
    - 7
  开始时间: '10:00'
  结束时间: '22:00'
  奖励倍率: 1.5
  适用副本: 示例副本
  开始脚本: |
    消息.全服("&6周末挑战赛已开启")
  结束脚本: |
    消息.全服("&7周末挑战赛已结束")

字段说明

字段作用
显示名称活动展示名
启用单个活动开关
类型支持 每日每周一次性
星期只给 每周 用,按 Java 星期规则,1 是周一,7 是周日
开始时间 / 结束时间时间格式 HH:mm
开始日期 / 结束日期只给 一次性 用,格式 yyyy-MM-dd
奖励倍率调度器会记录这个倍率,多个活动会累乘
适用副本当前源码读的是单个副本 ID,留空才是全副本
开始脚本 / 结束脚本活动进出窗口时执行的全局脚本

有两个地方容易踩坑

  • 默认示例里写的是 关联副本 列表,但当前源码读的是 适用副本 单值。
  • 默认示例里写 类型: 日期范围 也不准确,当前源码认的是 一次性

如果你只是想先设计活动

可以先把这目录当策划稿和配置草案区:

  • 把时间表先写好
  • 把活动文案和脚本先整理好
  • 等接线补上后再正式启用

这样后面迁过去很快,也不会把现在还没启用的功能写进正式服流程里。

TQ Minecraft Server Plugin Docs