[综合]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的话，可能是简化了繁杂的功能吧

下一页最后一页