定时器配置
✨喜欢这个插件吗?
你的支持是我们持续维护的动力,点击查看赞助详情
定时器配置默认存放在 /plugins/SweetTimer/timer 目录中,使用 .yml 文件,一个文件就是一个定时器。
# 默认定时器设置你可以粗浅地理解为每天 8:00 执行一次
schedule-time:
# 起始时刻,不填默认为本地时间 2026年元旦早上八点
start-time: '2026-01-01 08:00:00'
# 结束时刻,不填默认为本地时间 2099年
end-time: '2099-12-31 23:59:59'
# 定时器间隔时间,不填则默认为 24 小时
period-duration: '24h'
# 如果这一轮已经与目标轮次错过了,且超过多长时间,则放弃执行,等待下一轮运行
giving-up-gap: '5m'
# 允许总共成功运行轮次,-1 为无限制
success-run-round: -1
# 每次执行定时器之前,进行的条件判断
conditions:
# 表达式条件,留空(不输入或者使用空字符串)则代表不执行表达式判定
# 可以使用 PAPI 变量(不指定玩家),例如 %server_online%
# 相关文档:https://ezylang.github.io/EvalEx/references/operators.html
# 示例:'%server_online% > 0'
eval: ''
# 概率条件,有多少概率可以判定通过
# 可以使用小数格式(1.0=100%),或者百分比格式,超过 100% 将自动限制
# 使用 100% 或 1.0 则代表不进行概率判定
rate: '100%'
# 星期条件,只有星期几可以判定通过,不区分大小写
# Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday
# 分为正向星期条件和反向星期条件,正向星期前面没有感叹号(!),反向星期前面有感叹号(!)
# 当没有任何一个正向星期存在时,自动填充所有星期,然后解析反向星期,获得星期条件列表
# 换句话说:
# [ !Monday ] 代表只有周一不判定通过
# [] 代表不管星期几都能判定通过
weeks: [ Monday, Tuesday, Wednesday, Thursday, Friday, Saturday, Sunday ]
# 月份条件,只有哪个月可以判定通过
# 跟星期条件一样,分为正向条件和反向条件,不多赘述
months: [ 1, 2, 3, 4, 5, 6, 7, 8, 9, 10, 11, 12 ]
# 任何条件不满足时,执行的操作
deny-actions: []
# 定时任务执行器
executor:
# 要固定执行的定时任务操作
# 例如 - '[console]broadcast 这是一条公告'
run-actions: []
# 随机挑一个执行的定时任务操作
random-actions:
# 键名不重要,只要不重复就行
a: []
b: []
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
上次更新: 2026/02/20, 12:40:50