[综合]GuoScript —— 果式脚本，简单而强大的带流程控制的脚本插件[全版本] - 服务端插件

可畏

本帖最后由可畏于 2019-10-7 02:04 编辑

*GuoScript *

革新，才能超越

前言

我是GayaGuoguo，因为一些特殊问题，我的mcbbs账号被盗用后发布了一些违反论坛规定的内容，并且对我今后发布或更新插件都产生了不良影响，因此我决定弃用以前的论坛账号。

然后回坑后想要更新之前的插件，但在阅读我以前写的一些插件的代码之后我发现，无论是功能还是代码拓展性，它们都被限制得死死的，因此就有了编写这个插件的想法。我也考虑过，虽然这个插件的使用难度可能比以前的要大很多，但我相信，此插件的功能拓展性，值得您花时间深入研究，此插件也会实现并超越以往被弃用的插件的功能。

简介 & 功能

本插件实现了一套相对简单，格式固定的脚本语言，你可以通过正确的编写脚本后，使用此插件提供的调用方式来调用脚本，从而实现大量功能。

目前支持的调用方式有：
1. 指令调用（无玩家和有玩家）

计划中的调用方式：
绑定物品调用
交互方块调用
踩踏方块调用
战斗调用

计划中的脚本语句：
实现GrScriptBlock中的所有语句（现可通过已有语句实现）

指令 & 权限

此插件的所有命令都只允许OP使用，无任何权限节点

教程 & 详解

1. 脚本

是由你在文件中编写的字符串列表，其中每行字符串称为语句，脚本从上往下逐行运行，直至被停止或运行完成。运行过程是由与语句相对应的语句解释器处理，随后产生对应的效果。运行中的脚本拥有变量，条件，等属性，通过特定的语句创建和调用。

变量：拥有变量名和值，在执行一条语句前，语句中的所有%变量名%都会被替换为对应的变量值

条件：创建后，使用判断类的语句调用使用从而达到控制脚本运行的效果

2. 物品管理器

可以让你通过指令储存一些物品，用于特定的语句的调用，或是直接使用指令重新获得该物品，物品默认储存在items\default.yml中，你也可以在物品名前面加上“文件夹.”来使物品储存到不同文件中，但之后也要用“文件夹.物品名”的方式来调用该物品。

3. 数据管理器

可以通过指令，或者特定语句为玩家长久性（或是永久性）地储存一些数据，支持本地文件储存和Mysql储存，可以在配置文件中选择是否启用mysql储存。

数据，拥有“数据名”和“数据值”两种属性

其中“数据值”的类型是字符串，可以是数字字符串，也可以是文字字符串。对于数字字符串，可以使用/gsd add指令对其进行简单的加减而修改值，也可以编写脚本来对其进行更复杂的运算后修改值。

所有数据的默认值都为“0”，对于数据，插件还实现了一个用于PlaceholderAPI相关的变量，%gs_data_数据名%，返回的是该玩家的指定数据的值

4. 指令型脚本调用器

让你通过指令的方式，运行已载入的脚本。如果带有玩家参数，则在脚本运行前，预先添加一个变量，变量名为player，变量值为指令中玩家的名字。

我们先来看一个简单的例子

脚本1:
- 'message(hello world!)->*'
- '发送信息(你好，世界!)->*'

复制代码

打开插件目录下的command文件夹的example.yml，将该脚本写入后，使用指令/gs reload重载插件，然后使用指令 /gsc run 脚本1 运行他

随后，服务器中所有在线的玩家都会收到信息，就像这样

在例子中可以看到，为什么都是发送信息的功能的语句有2种写法？

在这里要提一下的是，考虑到英文单词较中文单词更难记忆的问题，我为所有的语句添加了英文，中文两种写法，当然，你也可以混合使用，只需要把配置文件中的scriptLang改为*即可

好了，现在你已经了解了本插件的大概运行流程，让我们来了解一下所有语句的具体用法吧！

效果执行类

影响游戏的效果

控制运行类

用于控制脚本的运行

变量类

用于创建变量

变量使之后所有语句中的%变量名%都替换为变量值

条件判断类

创建条件，并通过判断来执行其他语句

if(a)->b

判断(条件名)->语句

功能：

判断条件是否成立，如果成立则执行其后面的语句

参数：

a：条件名，由以下的解释器创建，可以在前面加"!"来进行非运算

b：语句，应为一条可独立运行的语句，也可以是if语句

例子:

if(a)->if(!b)->message(hello world)->*

如果条件a成立，条件b不成立，则对全服发送消息hello world

chance(a)->b

概率随机条件(概率)->条件名

功能：

创建条件，有指定概率使该条件成立

参数：

a：概率，应为数字，50表示50%概率

b：条件名

hasMoney(player:a)->b->c

拥有金钱(玩家名:数量)->条件名

功能：

创建条件，如果指定玩家在线而且拥有指定数量的钱，则该条件成立，否则创建一个变量，变量值为缺少的钱的数量

参数：

player：玩家名

a：数量

b：条件名

c：变量名

hasPerm(player:a)->b

拥有权限条件(玩家名:权限节点)->条件名

功能：

创建条件，如果指定玩家在线并拥有指定权限，则该条件成立

参数：

player：玩家名

a：权限节点

b：条件名

hasItem(player:a:b)->c->d

拥有物品条件(玩家名:物品名:数量)->条件名->变量名

功能：

创建条件，如果玩家拥有指定数量的指定物品，则该条件成立，否则创建

一个变量，变量值为缺少的物品数量

参数：

player：玩家名

a：物品名，这里的物品名应为“物品管理器”中储存的物品

b：数量，应为一个数字

c：条件名

d：变量名

relation(a)->b

关系表达式条件(关系表达式)->条件名

功能：

创建条件，如果关系表达式成立，则该条件成立

参数：

a：关系表达式，例如 100>=10 100==100 5<2

b：条件名

weighted<-a:aw...<-n:nw

加权随机条件<-条件1:条件1的权重...<-条件n:条件n的权重

功能：

进行一次权重随机，使一个随机到的条件名的条件成立

参数：

a：条件名

aw：条件名的权重值

备注：

该解释器参数数量不固定，但至少有一个

例子：

weighted<-a:50<-b:30<-c:20

进行一次权重随机，使a，b，c三个条件中的其中一个条件成立

a成立的概率是50 / (50 + 30 + 20)

b成立的概率是30 / (50 + 30 + 20)

c成立的概率是20 / (50 + 30 + 20)

实例

一、实现一个指令型脚本，要求用金钱换取执行一条指令

语句选配：

①. 判断玩家是否有足够的钱：

hasMoney(player:a)->b-c

复制代码

②. 通过执行指令发放物品：

console(a)

复制代码

③. 当购买成功时给予物品与提示信息 / 金钱不足购买失败时提示信息：

message(a)->target

复制代码

④. 扣除玩家的钱

addMoney(a)->player

复制代码

1. 判断玩家是否有足够的钱，通过调用方式自带变量的%player%，可以编写出以下脚本：

hasMoney(%player%:100)->enough->less

复制代码

这样，我们就能判断玩家余额是否足够 100 ，
当足够时，条件 enough 成立；当不足够时，返回变量%less%为不足金额。

2. 执行指令给予物品和扣除金钱

console(give %player% 1 1)
addMoney(-100)->%player%

复制代码

3. 判断购买成功与否

首先判断玩家余额足够与否(即步骤1)，将以上两步结合起来，
当钱足够时，发送物品与购买成功信息；不足够时，发送失败信息。通过 if(a)->b 可以编写出以下脚本：

if(enough)->console(give %player% 1 1)
if(enough)->message(&a购买成功!)->%player%

复制代码

当钱不足够时，即条件 enough 不成立时，返回失败信息，那么可以对enough进行非运算，即 if(!enough)，即：

if(!enough)->message(&c购买失败，石头的售价为&e100元&c，你还缺&e%less%元)->%player%

复制代码

4. 把以上脚本结合起来，可得

石头商店:

- 'hasMoney(%player%:100)->enough->less'
- 'if(enough)->console(give %player% 1 1)'
- 'if(enough)->message(&a购买成功!)->%player%'
- 'if(enough)->addMoney(-100)->%player%'
- 'if(!enough)->message(&c购买失败，石头的售价为&e100元&c，你还缺&e%less%元)->%player%'

复制代码

5. 不满足则停止

比起多次判断满足，我们可以选用“不满足则停止”的写法，像这样，功能一样，但更加简洁

石头商店:

- 'hasMoney(%player%:100)->enough->less'
- 'if(!enough)->message(&c购买失败，石头的售价为&e100元&c，你还缺&e%less%元)->%player%'
- 'if(!enough)->stop'
- 'console(give %player% 1 1)'
- 'message(&a购买成功!)->%player%'
- 'addMoney(-100)->%player%'

复制代码

6.当然，你也可以使用中文版本……

石头商店zh:
- '拥有金钱(%player%:100)->足够->缺少'
- '判断(!足够)->发送信息(&c购买失败，石头的售价为&e100元&c，你还缺&e%缺少%元)->%player%'
- '判断(!足够)->stop'
- '后台指令(give %player% 1 1)'
- '发送信息(&a购买成功!)->%player%'
- '给予金钱(-100)->%player%'

复制代码

7. 将该脚本写入插件目录下的command文件夹中的任意一个类型为.yml文件后，

使用/gs reload重载插件

使用/gsc run 石头商店 <玩家名> 调用该脚本

8.测试验证无误

二、编写一个指令型脚本，实现使用抽奖券抽奖，发放多个概率不同的奖励中的一项，其中

一等奖的概率为10%，

二等奖的概率为20%，

三等奖的概率为30%，

谢谢参与为40%。

1. 判断玩家是否拥有指定数量的指定道具，没有则发送一条信息并停止运行脚本，有则拿走它

hasItem(%player%:抽奖券:3)->拥有抽奖券->缺值
if(!拥有抽奖券)->message(&c进行抽奖需要&e3&c张抽奖券，你还缺少&e%缺值%&c张)->%player%
if(!拥有抽奖券)->stop
addItem(抽奖券:-3)->%player%

复制代码

2. 根据题意，选用加权随机条件来获得抽奖结果

weighted<-一等奖:10<-二等奖:20<-三等奖:30<-谢谢参与:40

复制代码

3. 处理所有结果

if(谢谢参与)->message(&c很遗憾，您什么都没有抽到，谢谢参与)->%player%
if(一等奖)->message(&a恭喜您抽到一等奖)->%player%
if(一等奖)->addItem(一等奖奖品:1)->%player%
if(二等奖)->message(&a恭喜您抽到二等奖)->%player%
if(二等奖)->addItem(二等奖奖品:1)->%player%
if(三等奖)->message(&a恭喜您抽到三等奖)->%player%
if(三等奖)->addItem(三等奖奖品:1)->%player%

复制代码

4. 组合以上脚本，得出

抽奖:
# 判断奖券
- 'hasItem(%player%:抽奖券:3)->拥有抽奖券->缺值'
- 'if(!拥有抽奖券)->message(&c进行抽奖需要&e3&c张抽奖券，你还缺少&e%缺值%&c张)->%player%'
- 'if(!拥有抽奖券)->stop'
- 'addItem(抽奖券:-3)->%player%'
# 随机条件
- 'weighted<-一等奖:10<-二等奖:20<-三等奖:30<-谢谢参与:40'
# 处理奖励
- 'if(谢谢参与)->message(&c很遗憾，您什么都没有抽到，谢谢参与)->%player%'
- 'if(一等奖)->message(&a恭喜您抽到一等奖)->%player%'
- 'if(一等奖)->addItem(一等奖奖品:1)->%player%'
- 'if(二等奖)->message(&a恭喜您抽到二等奖)->%player%'
- 'if(二等奖)->addItem(二等奖奖品:1)->%player%'
- 'if(三等奖)->message(&a恭喜您抽到三等奖)->%player%'
- 'if(三等奖)->addItem(三等奖奖品:1)->%player%'

复制代码

5. 在游戏中，使用物品管理器的相关指令添加道具供脚本调用

手持道具后输入指令

/gsi save 抽奖券

/gsi save 一等奖奖品

/gsi save 二等奖奖品

/gsi save 三等奖奖品

储存完后，可以使用指令/gsi list查询到已储存的物品

6. 写入文件，并调用

将该脚本写入插件目录下的command文件夹中的任意一个类型为.yml文件后，

使用/gs reload重载插件

使用/gsc run 抽奖 <玩家名> 调用该脚本

7. 测试验证无误

清空背包

使用指令/gsc run 抽奖 galeguoguo

使用指令/gsi get 抽奖券 17，获取17张抽奖券

使用6次指令/gsc run 抽奖 galeguoguo

下载

您的支持是我更新此插件的最大动力

您的建议是我更新此插件的主要方向

欢迎评分和回复

建议前置：Vault

建议前置：PlaceholderAPI

GuoScript-1.1.1.jar (105.05 KB, 下载次数: 1675)

更新记录

1.0.0 - 插件发布

1.0.1 - 修改语句

1.0.2 - 增加指令

1.1.0 - 修改语句，新增数据管理器，新增语句

1.1.1 - 优化数据管理器

- 现在每隔3分钟内插件会自动储存一次在线玩家的数据

- 新增了指令/gsd add

- 现在，数据值可以通过使用%gs_data_数据名%的PlaceholderAPI变量调用了

开源 & 声明

gitee仓库地址：https://gitee.com/guohub/GuoScript

本插件所用所有代码均为原创，不存在借用/抄袭/违反协议等行为

来自群组: 银河系气功协会

可畏

拓展API & 写给开发者

占楼编写中……

Cavalry_仰望

不错的插件支持一下

逍遥生丶

八字水帖，最为致命

逍遥生丶

八字水帖，最为致命

Neubulaeko

这个和MethodScript(EngineHub的出品)或者Skript这两个东西有什么彻底不一样的地方吗?

可畏

Neubulaeko 发表于 2019-10-1 21:00
这个和MethodScript(EngineHub的出品)或者Skript这两个东西有什么彻底不一样的地方吗? ...

MethodScrip是什么我没有了解过，
对比Skript的话，可能是简化了繁杂的功能吧

_諵城`Tr)L

player：玩家名
这里的玩家名是可以替换成 %player_name% 吧？

可畏

本帖最后由可畏于 2019-10-1 21:31 编辑

_諵城`Tr)L 发表于 2019-10-1 21:22
player：玩家名
这里的玩家名是可以替换成 %player_name% 吧？

%player% 如果gsc run 的时候有玩家对象的话，编辑一下就要重新等审核~不太敢改内容了呢

498525451

蒸鱼登岛尼。海浩窝梅芳奇

Neubulaeko

可畏发表于 2019-10-1 21:05
MethodScrip是什么我没有了解过，
对比Skript的话，可能是简化了繁杂的功能吧 ...

可以去EngineHub(开发了WorldEdit的那群人)的官网上面看一下, 感觉很类似啊从简介上看(
当然不是说已经有了轮子就没必要造，我倒是希望看见一个竞争对手或者一个功能更加完善的或者更亲民的插件的(

Nicekill

很棒的插件嗷~

下一页最后一页