[管理]TimerExecutor——给你的服务器加一些定时指令吧![1.8-1.12] - 服务端插件

轻光233

本帖最后由轻光233 于 2020-6-26 08:49 编辑

\u0046\u0042\u0049 WARNING

如果你是本插件1.7版本以前的用户

请一定要按照使用法重新配置

否则后果自负!

简介

这是一个轻量级的定时插件,来帮助服务器在一些固定时间执行一些指令

虽然可能mcbbs里面有很多的计时器(~~反正我是没看见一个~~)

所以我就来发一个这样的插件，来便利广大腐竹

使用方法

我默认你已经学会了YAML的语法

如果没有的话请去runoob学完再来看

如果你刚开始使用本插件,第一次加载之后你会plugin/TimerExecutor里看到一下内容:

timers/timer.yml，config.yml，cmdstack.yml，conds,yml

先来介绍一下timers里面的那个文件

如果你是刚开始使用的,你会在这个文件里看到如下内容

#这是示例的定时器,你可以自己按照上面的注释写一个
empTimer:
#设置定时器是否开启,未开启的定时器不会被加载和检测
enable: true
#这些是设置这个定时器什么时候执行,你可以使用的时间表达方式有8种
#年/月/日,时:分:秒表示一个确定时间点(也是这8种中的唯一一个确定时间)
#月/日,时:分:秒表示每年的某个时间点
#日,时:分:秒表示每月的某个时间点
#星期,时:分:秒表示每星期的某个时间点(星期那里填英文,大小写随便)
#时:分:秒表示每天的某个时间点
#分:秒表示每小时的某个时间点
#秒表示每分钟的某个时间点
#sec 表示每一秒(直接在那一行填一个sec就可以了)(这个填了之后其他的就可以删掉了)
#当你填写的任何一个时间判断成功,此定时器都会执行(在下面的unable_times中没有判断成功的时间的情况下)
enable_times:
- '2/5,00:00:00'
- '1,00:00:00'
- 'sunday,00:00:00'
- '00:00:00'
- '00:00'
- '00'
- 'sec'
#这些是设置这个定时器什么时候不执行(优先级大于上面的enable_times,如果这一项下面的时间里有判断成功的,那么就算上面的enable_times判断成功也不会执行)
#时间表达方式和上面的enable_times一样
unable_times:
- 'sec'
#注意,这里所有的指令都是根据config的默认设置来做的,如果你把config.yml的默认项改变,请把原先的格式换成你改变的格式后再看
#
#一些特殊的指令
#delay <milis> 表示在此处停止多少毫秒后再执行后面的指令(最大数值是9223372036854775807)(1000毫秒=1秒)
#sendmsg <msg> 给执行的玩家或者是控制台发送一条消息,你可以用'&'来代替彩色符号
#特殊的标识
#>cmd_stack_name_inFile 这个的意思是这一条指令指向指令块文件里的指定标识名的所有指令,cmd_stack_name_inFile表示指定的标识名
#特殊的变量(这里因为作者懒就不写了,配置文件里都有,应该很好理解)
#
#
#本插件定义了一个条件的概念,让一个条件代表一个或一些特定的玩家
#这里提供了一些指定的条件,你可以用这些条件来表示你要指定执行的玩家
#all_player:all 表示所有人
#ficman:ficman 表示假人
#random_player:random{条件} 表示在条件所指定的玩家里随机抽取一个人(eg.random{%world|#group})
#regation_players:rgt{条件} 表示除了条件所指定的玩家之外的所有人(eg.rgt{%world|#group})
#area_players:area{world_name,x1,z1,x2,z2} 此条件表示在一个指定世界的指定区域内的所有玩家,world_name表示世界名,x1和z1表示区域对角方块的坐标的x轴和z轴,x2,z2表示区域第二个对角方块的坐标的x轴和z轴(eg.location{world,10,10,-10,-10})
#range_players:range{world_name,x,y,z,radius} 此条件表示在一个指定坐标为圆心,在指定半径内的所有玩家,world_name表示世界名,x、y、z表示坐标的x、y、z轴,radius表示圆球的半径(eg.range{world,0,70,0,100})
#money_has_players:money{money,isOut} 此条件表示所有拥有指定金币的玩家,money表示指定金币,isOut是一个布尔值(true或者false),为true表示消耗金币,为false表示不消耗(eg.money{1000,true})
#gruop_players:#group_name 此条件表示在指定权限组里的所有玩家,group_name表示权限组名(eg.#group)
#permission_has_players:*permission 此条件表示拥有此权限的所有玩家,permission表示权限名(eg.*ess.op (随便编的2333))

复制代码

这就是以后你要编辑的东西，让我们一个一个看

开头你就可以看到一个 'empTimer'

这就是这个定时器的名字，你可以在这个文件里写其他的定时器，像这样

empTimer:
#some code...
otherTimer:
#some code...

复制代码

之后就有一个 'enable',用途上面的注释已经写的很明白了,我就不多赘述

然后往下看，我们可以看到 'enable_times' 和 'unable_times' 以及一大堆的注释

enable_times是一个list,里面填的就是注释上说的时间的表达方式

(应论坛里 @Zapic 的要求,我增加到了8个时间的表达方式)

随便挑一个举例: 日,时:分:秒

就代表了,这个定时器会在每个月的指定时间执行下面的指令

其他的五个表达方式和这个大同小异，只是范围的变化

两个特殊的挑出来说一下: '年/月/日,时:分:秒' 和 'sec'

第一个是一个真正的确定时间,到了这个时间,执行下面的指令之后就再也不会判断成功

第二个是在每一秒都会执行下面的指令

当这个list里面有任何一个时间判断成功都会执行下面的指令

unable_times也是一个list,填的东西和enable_times都一样

这个list里的时间有一个判断成功,无论enable_times判断成功与否,指令都不会执行

最后就是重头戏了 'commands'

这是一个list,里面填写的是你需要执行的指令

你可以在指令前面添加一些条件,并使用拼接符来连接这些条件来挑选执行指令的玩家

如果你没有添加条件,默认为控制台执行这些指令

(say指令控制台亲测无法执行,请使用bc或其他的指令代替)

我们拿一条指令来举例

#group|%world|random{all}:range{world,0,70,0,100}:give %player% diamond 64

复制代码

我们可以把这条指令抽象表示为

<条件>:<指令>

复制代码

(不要问我为什么:又当作指令和条件之间的分隔符又当作条件的拼接符,历史遗留问题,你只要知道当作分割符的:和当作拼接符的意思不一样就行了)

'#group' 指group权限组的玩家(下文所有玩家没有特殊声明都指在线玩家)

'%world' 指在world世界的玩家(这个名字是世界文件夹的名字)

'random{all}' 指此服务器的所有玩家中随便抽取一个玩家(这个之后会和rgt讲详细)

'range{world,0,70,0,100}' 指以world世界的坐标(0,70,0)为圆心的半径100格的圆球内的所有玩家

'%player%' 表示执行此指令的玩家

当然,除了这些条件,还有其他的条件,这里一个一个讲

'all' 指此服务器的所有玩家

'fakeman' 指假人,名字为伪随机UUID的前八位

'area{world,0,0,10,10}' 这个我用图解释一下

此条件就指的是这个方格区域内的所有玩家(不限y坐标),当然也可以用右上和左下这组对角

'money{10,true}' 指所有账户内拥有10元或以上的空闲余额的玩家,后面的true表示执行完指令后扣除10元,false表示不扣

'*timer_execute.use' 指所有拥有timer_execute.use权限的玩家

'qing_guang_233,D4t3,July_Summer' 指'qing_guang_233','D4t3','July_Summer'这三个玩家

将上述条件用连接符连接,可以达到特殊的效果

你可能会有疑问,明明上面的配置文件里有12种条件,为什么这里只有9种(random准确来说没说完)

别急,剩下的两种需要等连接符讲完了再说,耐心看完吧

有两个连接符可以选择,一个是':',一个是'|'

用':'连接的两个条件,将会得出一个两个条件都有的玩家集合,这里举个栗子

#group:%world:*pmss

复制代码

我们假设

group权限组中有玩家: 'p1','p2','p3'

world世界里有玩家: 'p1','p3','p4','p5'

拥有pmss权限的玩家有: 'p1','p4'

首先,条件'#group'和条件'%world'用':'连接之后得出的玩家集合为: {'p1','p3'}

因为'p2'和'p4','p5'在互相的玩家中没有,而'p1'和'p3'两个条件的玩家中都有,所以得出的玩家集合就是{'p1','p3'}

之后我们再看,{'p1','p3'}和后面的'*pmss'条件的玩家用':'连接后得出的玩家集合也为{'p1','p3'}

至此,这三个条件通过':'连接得出的玩家集合就为{'p1'}

然后我们再看'|'

用'|'连接的两个条件,将会得出一个两个条件所有的玩家的集合,这里举个栗子

#group|%world|*pmss

复制代码

假设和上面的一样

拥有pmss权限的玩家现在有:'p1','p4','p6'

首先,条件'#group'和条件'%world'用'|'连接之后得出的玩家集合为: {'p1','p2','p3','p4','p5'}

因为这个集合里的所有玩家在这两个条件的玩家中都出现过

之后再看,这个集合和后面的'*pmss'条件用'|'连接后得出的玩家集合就为{'p1','p2','p3','p4','p5','p6'}

至此,这三个条件通过'|'连接得出的玩家集合就为{'p1','p2','p3','p4','p5','p6'}

两个连接符一起用的话,会先让':'连接符判断完成,再判断'|'连接符

至此,一个条件就完成了,再用':'把条件和指令隔开,就是一条指令,你就可以把这一条指令写到commands下的list里面了

也就是开头的那个亚子

#group|%world|random{all}:range{world,0,70,0,100}:give %player% diamond 64

复制代码

有人可能会问,如果我想让'|'连接符先判断,该怎么办?

这个时候,conds.yml就要派上用场了

打开这个文件,如果你是刚刚开始用的话,只有这么两行

#这是一个示例的条件,左边是条件的标识名,右边是条件,你可以用'$标识名'来使用这个条件,记住,这里不能写指令!
empCond: '%world:#group|*permission:range{world,0,70,0,100}'

复制代码

'empCond'就代表这个条件的标识名,冒号后面的是一个条件,如果你想在其他的条件中使用这个条件

可以用'$empCond'来指向这个条件

拿开头的那条指令举栗子

#group|%world|random{all}:range{world,0,70,0,100}:give %player% diamond 64

复制代码

如果想让'#group|%world|random{all}'先判断的话,可以在conds.yml里面加一个

empCond2: '#group|%world|random{all}'

复制代码

然后把这条指令改成

$empCond2:range{world,0,70,0,100}:give %player% diamond 64

复制代码

就可以达到预期的效果,这就是那个'cond_in_file_cond'条件

现在就可以讲最后两个条件了

'random{条件}' 指此条件指定的所有玩家中随机取一个玩家

'rgt{条件}' 指此条件指定的所有玩家除外的其他所有玩家(取反操作)

最后就是条件后面的指令部分了

这里我们重新举个栗子

random{all}:give %player% diamond 64

复制代码

这里就可以随机抽一个玩家给64个钻石,类似与命令方块里的'give @r diamond 64'

当然,不可能声都不吭一下就给他一组钻石,这个时候就要给他一个提示

但是,由于是随机出来的玩家,不可能在commands里重新加一个'random{all}:sendmsg &6你是幸运儿'

否则有很大的几率会出现有提示没钻石的情况,这个时候就是cmdstack.yml的moment了

打开这个文件,如果你是刚刚开始使用的话会看到这些东西

#这是一个示例的指令块,上面是标识名,下面一些就是指令,你可以使用'>标识名'来使用这个指令块,注意,这里不能填条件!
empStack:
- 'sendmsg 你被选中了'

复制代码

其中的'empStack'表示这个指令块的标识名

下面的list就是这个指令块所代表的所有指令

如果想在其他地方用这个指令块的话可以把条件后面指令换成'>empStack'

这里只是默认的示范,要想达到上面我们所说的效果,可以另外写一个

empStack2:
- 'sendmsg &6你是幸运儿'
- 'give %player% diamond 64'

复制代码

然后把上面的指令换成

random{all}:>empStack2

复制代码

现在,我们所想到实现的效果就已经实现了

当然,如果你想在执行这些指令的时候停顿一下以实现类似倒计时的功能,这里也提供了一个指令

delay 1000

复制代码

这个指令加在其他的指令中间就代表在这里停顿1秒

后面的1000指的是1000毫秒,1秒==1000毫秒

具体的使用就像这样

commands:
- 'random{all}:>empStack2'
- 'delay 5000'
- 'bc 5秒前有一个玩家获得了一组钻石!'

复制代码

具体的效果就是给完玩家钻石,5秒之后全服通报一下

当然,这个'delay'也可以写在cmdstack.yml里

至此!定时器的编写就完成了,你可以使用/timer test <定时器名>来看看效果

如果你觉得上面的条件写起来很繁琐,你可以随时到config.yml去改

在那里面你也可以看到一些你可以在指令里使用的变量

啊对了,还有一个指令,如果你想给你的玩家发送一条信息的话,可以这样写

sendmsg &6&lHello world!

复制代码

就会发送一条金色(我也忘记啥颜色了)加粗的信息到玩家的聊天栏

颜色符号用&代替

写给1.7以前的服主

你们可能会惊讶,这和之前的好像很不一样,但是你如果进行了以下操作的话,和以前基本没两样

首先,把你之前的定时器里面的'year','month'和'day'这三个删掉,这个已经被'unable_times'代替了,如果想达到以前的效果请看下面

之后,把'timer_timeset'改成'enable_times'

最后,把

command_set:
commands:

复制代码

改成

commands:

复制代码

注意'commands'前面的空格,一定要只有2格

这样,你的定时器就和以前一样了

然后,如果你改了config.yml的话,请备份一份config.yml然后把原来的删掉,重新加载一次本插件

然后按照新的config.yml一个一个改就可以了

如果你觉得timer.yml里定时器太多了的话,你也可以新建一个文件继续写

总之,这个插件可以做到的有很多,就看你怎么用了

指令&权限

开源地址:

没人知道这是什么!

最后放出执行效果

没人看的更新日志

版本1.0

最初版本

版本1.1

增加仅此插件配置文件可用的指令delay <milis>,用来放在配置文件的commands节点里面,表示在这里停顿多少毫秒

版本1.2

删除command_sender的op选项,新增player选项,op选项合并在新增的player选项中

新增timer_type的选项day,具体用法请看注解

新增前置插件,用来完成player选项中的权限组设置

版本1.2.1

修复了player选项无法执行指令的bug

op选项彻底删除,改为random,具体看配置文件

现在执行指令无视权限,直接执行

增加world选项,具体看配置文件

(在这里特别感谢qq188586307给我反馈的bug和对此插件的关心)

版本1.3

修复了时间不准的bug,现在只要没有什么大问题时间都是精确在秒以内

player前面的组设置可以设置多个,用多个分号隔开,类似于条件,具体看配置文件

增加了一个内置指令sendmsg,具体看配置文件

增加了一个事件,具体看github的github.light.events.CommandsExecuteEvent类开源代码

(总算是填了我自己挖的坑,也再次感谢qq188586307帮助我测试这个插件)

版本1.4

增加代码块,具体看教程

增加测试计时器指令,具体看指令介绍

delay可以在前面加组,但是跟没加一样,为了迎合代码块功能

(代码部分)大幅度修改,指令执行部分由监听器完成,增加github.light.plugin.TimerExecuteCommand类封装一个指令,具体看github开源

版本1.5

合并player和cansole，现在command_sender选项作废,你可以把前面的组去掉(只要没有冒号)来代表控制台指令

random增加可选范围(random{条件},这个条件的意思是%world:#group这些的,会在挑选出所有条件都符合的玩家中随机选取一个)

现在再也不会出现异步问题或者同步让服务器直接卡死的重大bug了

(代码部分)再一次大幅度修改,更加模块化,便于开源项目的阅读

(之前跟某人说了11月的第一个周末我来更新和修bug,现在总算是已经搞好了)(另外,在1.2.1和1.3的测试员又来帮助我测试,在这里也是非常感谢)

版本1.5.1

新添加条件location,具体看配置文件

版本1.6

timer_type选项作废,现在你可以在timer_timeset里填所有的时间类型了

新增一个时间类型,具体看配置文件

新增"|"来连接条件

新增Conds.yml文件来储存条件

新增条件ficman(假人,有重大bug)、range、money、permission、condfile,random已删除,你可以用random{all}来达到原来的效果

新增了很多的时间变量

你现在可以在config.yml里自定义变量和条件的字符了

由于上面那条更新,现在储存计时器的文件名变成了Timers.yml,请在更新本插件的服主把原来的config.yml改名为Timers.yml

指令部分现在已经有了提示语和help指令

代码部分的修改从现在开始在github里公布

版本1.6.1

上学的时候突然想到有点大问题,括号里面如果有分隔符就把括号之间忽略,现在修复了

版本1.7

插件名更改为TimerExecutor

代码重构，指令解析速度加快

供外部使用的api删除(反正这插件也没有什么人写附属插件)

修复假人导致玩家无法进服的bug

新增条件取反

修改了配置文件的一些路径名，添加了一个变量，请一定要按照上面的使用方法改正

定时器现在被移动到timers文件夹里,如果你是1.7以前的用户会帮你把Timers.yml自动移动到timers文件夹里

新增了两个指令和一个基本权限

已知Bug

下个版本(1.8)更新内容:

本插件所用所有代码均为原创,不存在借用/抄袭等行为

本插件为非盈利性插件,免费发布,禁止销售和转卖

Sky_HanFeng

挺不错的，支持

wshycaa

这个插件有周和月的功能，好评！

轻光233

wshycaa 发表于 2018-8-21 12:33
这个插件有周和月的功能，好评！

为什么要这么惊讶？一般这些插件没有周和月？

轻光233

Sky_HanFeng 发表于 2018-8-21 11:41
挺不错的，支持

小心心~~~
~~不过小心黄牌,这是通用回复qwq~~

Mar_2955

正缺这个插件，用红石没那么多功能