BBSPK晋级赛 MCBBS纪念版

[[/]][PCD]Skript帮助文档全翻译

作者: cc7w

日期: 2016-08-14 19:32:00 版块: 翻译&Wiki

本帖最后由 cc7w 于 2020-3-1 12:30 编辑

来自群组： PCD

Skript 官方帮助文档

-=-=-=翻译进度=-=-=-

完成

-=-=-=原文地址=-=-=-

-=-=-=翻译地址=-=-=-

-=-=-=内容=-=-=-

[groupid=1330]PluginsCDTribe[/groupid]

回复:

feiyifan999

支持一下，Skript发展潜力很大

2016-08-14 19:43:00

幻境雲達達

为什么我没见过你

2016-08-14 19:43:00

cc7w

XJue_DaDa 发表于 2016-8-14 19:43
为什么我没见过你

因为我是新来的：D

2016-08-14 19:46:00

cc7w

feiyifan999 发表于 2016-8-14 19:43
支持一下，Skript发展潜力很大

所以翻译~~骗精华~~

2016-08-14 19:56:00

feiyifan999

1345979462 发表于 2016-8-14 19:56
所以翻译~~骗精华~~

所以说你会Skript么- -这是个问题

2016-08-14 20:00:00

幻境雲達達

1345979462 发表于 2016-8-14 19:46
因为我是新来的：D

喔。欢迎大佬

2016-08-14 20:47:00

cc7w

feiyifan999 发表于 2016-8-14 20:00
所以说你会Skript么- -这是个问题

看我签名档我发过x件的。

2016-08-15 08:29:00

cc7w

本帖最后由 1345979462 于 2016-8-20 14:15 编辑

介绍
Skript是一个流行的服务器插件。

它允许服务器管理员在不写任何Java语言的情况下简单的管理Minecraft。

这是用触发器、条件和效果三个部分做到的。

当触发器触发，所有条件均满足，效果就会被触发。

Skript的基础想法是——自定义 —— 每个服务器都能在没有自定义插件的情况下表现不同。

这比你自己钻研插件和找人写插件快的多。

同时你也不需要那么多小插件了，这一个插件就够了。

你可以在[[https://github.com/bensku/Skript/releases 这里]] 原文给的是DropBox地址无法访问，这里是作者的GitHub地址下载最新版本的Skript

已经提及了，Skript的触发器提供了这个插件的基本功能。

触发器很普通，并由一些条件和效果组成，就像这个简单的掉落修复脚本:

on break of glass:
drop glass
译者注:
当打破玻璃的时候:
掉落玻璃

Skript也能用来做自定义命令。

这些基本的触发器已被改成了执行特定的命令。

下面的简单触发器允许玩家在手持物品输入/id时显示它的ID。

command /id:
description: Find the ID of the item you're holding
trigger:
      message "You're holding a %type of tool% whose ID is %id of tool%."
译者注:
当使用/id时:
描述: 获取你当前持有物的ID
触发器:
      给玩家发送消息 "你现在正在拿着一个%type of tool%[工具类型] ，它的ID是 %id of tool%[工具ID]"

Skript同时也有直接从聊天栏执行效果的选项，输出一个可配置的符号打头(!是默认的)的聊天信息。

这经常被指令使用。例如，
!repair tool
，将会修复你的工具。因为这些指令非常强大且用的地方很多。

只有在玩家拥有
skript.effectcommands
权限是才能使用(OP默认不拥有!)

Skript的语法不仅限制于上面的简单指令，还包括一些循环，包含等语法。

下面的脚本是一个很简单的从附近箱子抽调燃料的例子——

on burn of fuel:
fuel slot of the block is empty
loop blocks in radius 1:
      loop-block is chest
      loop items of type fuel:
         loop-block contains loop-item
         remove loop-item from loop-block
         set fuel of the event-block to loop-item
         stop trigger
译者注:
当燃料燃烧时:
熔炉的燃料槽空了
在周围半径一格寻找方块:
      寻找箱子
      寻找物品是燃料类型
         箱子包含燃料
         从箱子中移除燃料
         把燃料移到燃料槽
         停止触发器

更多信息请前往[[https://dev.bukkit.org/bukkit-plugins/skript/ BukkitDev]] 译者注:作者的BukkitDev已经停止更新，请前往GitHub，在文章开始处，然后也请阅读下面的辅导材料和帮助文档。

辅导材料是新手的必读品。它解释了如何写一个脚本。这里是[[https://dev.bukkit.org/bukkit-pl ... s/general-tutorial/ 另一段辅导材料]] 译者注: 两段都翻译了

帮助文档是所有触发器的集合，这里面有所有关于脚本的东西。

[[http://dev.bukkit.org/bukkit-plugins/skript/ 链接到BukkitDev]]

[[http://dev.bukkit.org/bukkit-plugins/skript/forum/ 链接到作者论坛]]

2016-08-15 10:16:00

cc7w

本帖最后由 1345979462 于 2016-8-20 14:37 编辑

教程
作者在自带页面给出的教程

开始
在你开始写脚本之前你应该先安装Skript插件
下载最新的Skript插件，把它放入plugins，重启服务器来生成配置和一些示例脚本。
写触发器
在你打开你的编辑器之前我推荐你知道你要写什么脚本，但你可以简单地开始写了。
在这个教程材料中我会说明如何写一个用锄头来直接撒播种子的脚本。
它应该包括当一个人手持锄头右键泥土时自动种植作物。
首先，打开你的文档编辑器[例如NotePad++] 译者注:经测试，不推荐使用微软自带的记事本!
现在思考怎么样能让你的触发器被触发，所以我们写下第一行：

on right click:
译者注：
在右键时:

如果你不知道有哪些条件可以触发的话，点击[[http://njol.ch/projects/skript/doc/events/ 这里]]译者注:这里是下面帮助文档的Events 事件大类
但是我们不想让人们右键都触发，只是在泥土上用锄头而已。
所以我们应该改变一下——

on right click on soil holding a hoe:
译者注:
当持有锄头右键泥土时:

我们也可以用这个事件+条件来替代——

on right click:
block is soil
player is holding a hoe
译者注:
当右键时：
方块是泥土
玩家手持锄头

这两种都可以，但我在这篇文档中将使用第一种。
然后我们来检测玩家有无种子:

on right click on soil holding a hoe:
player has seeds
译者注:
当用锄头右键泥土时：
玩家拥有种子

请注意第二行的缩进。这会使读取器认为这是一个触发器中的语句，并且使脚本更简单的阅读。
如果你不注意这个缩进的话你的插件就会报错因为插件认为他们不属于一个触发器。
在那之后我们应该种植作物了——

on right click on soil holding a hoe:
player has seeds
set block above the clicked block to crops
译者注:
当手持锄头右键泥土时：
玩家拥有种子
将泥土上方的方块设置为作物

这不是很精确因为可能我们点击的泥土方块上方有方块(如下图)
[_] <- 其他方块
[_] <- 泥土方块
如果我们只是设置的话我们会覆盖掉原有方块。
这可能是别的玩家领地中的物品甚至是基岩。
这样的问题看起来并不明显但会有BUG的存在。你可以在你服务器上使用之前先在一个测试服务器上尝试运行。
这个问题可以用检测泥土上方的方块来解决——

on right click on soil holding a hoe:
player has seeds
block above the clicked block is air
set block above the clicked block to crops
当手持锄头右击方块时:
玩家拥有种子
被点击方块的上面是空气
把点击方块上面的方块设置为作物

然后不要忘了移除玩家的种子，不然他们就有免费作物了：D

on right click on soil holding a hoe:
player has seeds
block above the clicked block is air
set block above the clicked block to crops
remove seeds from player
当手持锄头右击方块时:
玩家拥有种子
被点击方块的上面是空气
把点击方块上面的方块设置为作物
移除玩家的种子

最后一件事是把你的脚本储存到
./plugins/Skript/scripts
里，你可以取任何名字。
但请不要以
-
号打头，因为这会使脚本无法读取。
文件的扩展名必须是
.sk
，例如，你可以把这个脚本储存为
hoe.sk

现在开启你的服务器[可能是测试的]，检查后台有无错误信息，如果有，尝试修复。
然后登入服务器测试脚本查看是不是都可以运行。
如果你测试完毕，你可以上传到你的主服务器让玩家使用了。
你也可以使用
/sk reload 脚本名称
来使脚本重载。这方便你调试脚本，不要重启服务器。
所有的错误将会发送给使用指令的玩家。
如果后台使用，将发送给后台。

BukkitDev给出的教程材料

Skript的目标就是让不会语法的程序员们写他们自己的小插件[称之为脚本]。
我感觉这个目的渐渐的被人淡化因为人们也不会写脚本。
这个教程材料教写脚本的新人，如何让这个绝妙的插件在TA的服务器上工作。
[[http://njol.ch/projects/skript/doc 帮助文档]]解释了你服务器所需要的所有的脚本构成。

我不是这里单一的教程帖子了，我将会引用一些他们的东西。
这个插件在你自己编程的时候非常有用，你可以做你想做的东西，以及它不需要完美的语法。
帮助文档可以在这篇文章的最上方找到。
变量，循环，指令，条件和事件——
你写脚本的时候，你最少要用到一个，甚至你可能都需要。
下面我会详细介绍每个是干什么的，什么时候用他们——
事件
事件就是当一件事情发生的时候，例如玩家点击了一些东西，打出伤害，狗带，或一个怪物做了一些事情，甚至是环境自己改变。
这允许你做一些另外的事情——例如:

on explode:
      cancel event
当爆炸时:
      取消事件的发生

注意空格，事件后都有一个冒号。你可以用4个或8个空格译者从来没有试过8个，都是4个。
你不能使用tab或空格来换行。我偏向于使用tab来缩进因为我只需要点一次译者喜欢4个空格因为这样语法感觉更好
真正的事件其实非常简单。当一个爆炸发生，取消它。
这能很好地防止TNT 苦力怕的爆炸，甚至防止末影龙。
记住这个会真正的取消爆炸，就是玩家也不会受到伤害。
所以这个脚本非常简单，你可以简单的变换结局。
例如杀死服务器上的所有玩家这个人怎么想的=-=
[size]条件[size]
条件是任何脚本的基础。他们是执行下一部分的条件代码。一个权限示例如下——

on rightclick:
      player has permission "skript.boom"
      create explosion with force 3 at targeted block
当右键时:
      玩家拥有"skript.boom"权限
      在指向方块处创造力量为3的爆炸

这会创建一个比TNT更小的爆炸，但只会在玩家拥有对应权限时工作。
条件能被用来检查玩家是否拥有物品，或牌子上写的东西。
你甚至可以用多个条件来限制效果。

on rightclick:
      block is a sign
      line 1 of sign is "[Shop]"
      player has permission "skript.shop"
      player has 2 gold nuggets
      remove 2 gold nuggets from player
      give player 1 bread
      message "<light green>You bought a bread."

在这个脚本中玩家必须右击一个第一行为[Shop]的牌子，拥有权限，2个金粒，然后才能有效果。
指令
每个服务器的管理员都知道指令，这是你运营服务器的方式。 Skript允许你自己自定义指令。这些命令与事件写法大体相似，除了事件需要被你自定义。
这个事件简单的版本是通过玩家输入指令来自定义效果。如果想获取更好的想法，看我下面的例子。

command /hi:
      permission: skript.hi
      trigger:
            message "hi"

这个简单的命令给发送/hi的玩家发送消息。第一行是事件。首先我们说要自定义一个命令，然后我们写什么命令。
然后我们给它一个权限和使用方法。最后，我们增加触发器，使我们想要指令做的事情。
你可以看网页提及的自定义命令的部分。
你也可以做一些可以获取信息的指令，或者指定被作用效果的玩家。看下面的指令:

command /hi <player>:
      permission: skript.hi
      trigger:
            send "hi" to argument

这个命令和之前一样发送同样的消息，但这次将会发送给别的玩家。
我们使用这个发送效果的原因是因为消息效果只发送消息给事件中的玩家，而不是输入指令的玩家。
有了发送效果，我们就能够给别的玩家发送信息了。
argument是指令中的玩家，所以当你使用/hi demon_penguin时，将会给 demon_penguin 发送hi。
同时你也可以查看网页来了解更多关于自定义命令的信息。
循环
循环任务可以用来完成复杂的任务。例如如果你想检测在你附近是不是有个箱子，你可能要检测你周围所有的方块来查看它是不是箱子。这可以用一个简单的循环解决——

command /chest:
      trigger:
            loop blocks in radius 3 around player:
                     loop-block is a chest
                     message "There is a chest at %location of loop-block%"

牌子上的变量会取代它的文本。这里有 x y z三个变量来代替 %location of loop-block%。
循环代码的一部分是任何方块的循环检查。循环将会在玩家3格半径的范围内寻找箱子
因为我们在用一个自定义指令，我们可以增加寻找的范围和arguments来允许玩家选择距离。

command /chest <integer=3>:
      trigger:
            loop blocks in radius argument around player:
                     loop-block is a chest
                     message "There is a chest at %location of loop-block%"

这里我们为指令设置了默认值，如果在玩家没有选择的情况下为3.在循环表达中我们将argument代替了数字。
这意味着无论你输入什么数字，指令都会把其读取。如果没有输入数字，3将会成为默认值。
如果你想要看精确的半径的话，做一个圆球脚本，你就能看见尺寸了。

command /sphere <integer=3>:
      trigger:
            loop blocks in radius argument around player:
                     loop-block is air
                     set loop-block to stone
            set {clear.block} to location of player
            set {clear.radius} to argument
command /clear:
      trigger:
            loop blocks in radius {clear.radius} around {clear.block}:
                     loop-block is stone
                     set loop-block to air

/clear指令将会轻松删掉你设置的圆球。同样因为你在圆球的中心，你要想一个让自己出去的方法。
这个指令可能会对地面造成一些伤害，所以请飞行来使用。
{}中的东西叫做变量，下节会说到。如果你想了解更多关于循环的知识请看帮助文档。
变量
变量是用来在名字下储存数据的。它像一个盒子上的标签，如果你想要知道盒子里的信息，只要找到正确的标签就可以。Skript的变量就是这样。你可以像这样储存变量:

set {variable.name.goes.here} to true

变量值可以是true/false ，一个坐标，或数字。这样的原因是我们可以晚些获得这个信息。所以也许我们可以检查玩家是否输入过指令，我们可以这样做：

command /sethome:
      trigger:
            set {home} to location of player
command /home:
      trigger:
            teleport player to {home}

你的变量必须用{}括起来，因为这才能告诉Skript这是一个变量。上面是一个非常简单的家园脚本。
我们记录玩家的位置在一个叫做{home}的'盒子'里。当玩家输入/home时因为有变量所以我们知道把玩家传送去哪里。这不会把变量清除，它更偏向于只读类型。
即读取后放回原处。但在你写脚本中，你必须思考用户可能出错的方式。
例如玩家并没有设置他的家，那么在用/home后会发生什么？他们会被传送到哪里？
这你需要使用if来检测。检测是否有一些错误，如果没有，再继续执行脚本。
上面的脚本并不会给玩家发送信息，所以你需要自己创建——

command /sethome:
      trigger:
            set {home} to location of player
command /home:
      trigger:
            if {home} is not set:
                     message "<red>You need to set a home first!"
                     stop trigger
            teleport player to {home}

现在当玩家尝试用/home时他们会受到错误提示并且剩下的脚本不会运行。
如果你忘记停止脚本，剩下的事件将照常继续运行。同时如果同时如果if判断的是false,那么剩下的代码便不会运行，玩家也收不到错误消息。
现在我们这个脚本主要的问题是当一个人/sethome后，另一个人使用/home可以直接到达这个位置。
然后在另一个人设置家后，便会覆盖前一个人家的记录。
修复它的方法是使用表达式。这些可以读取触发事件的人。
在这样输入指令后，会记录谁输入的指令。
所以让每个人都有不同的家，我们其实可以用玩家的名字作为变量。例如这样——

command /sethome:
      trigger:
            set {home.%player%} to location of player
command /home:
      trigger:
            if {home.%player%} is not set:
                     message "<red>You need to set a home first!"
                     stop trigger
            teleport player to {home.%player%}

现在玩家的名字在变量中了，所以当检测是否存在时，对我将会检测{home.demon_penguin}，对别人将会检测 {home.whateveryouruseernameis}。

在这个脚本中每个人都会有他们自己家的位置了。
注意事项
记住你学到的命令部分下所有的东西，都可以使用在任何触发器中。
这其中包括许多事件。
如果你想了解更多，看帮助文档吧下面的内容。
如果你关于我说的有任何疑问，或要寻求帮助等，请在这里发帖 [[http://dev.bukkit.org/server-mods/skript/forum/help/ 传送点]]
-Demon 原作者
-c7w 翻译者

2016-08-15 19:48:00

cc7w

本帖最后由 1345979462 于 2016-8-20 14:29 编辑

WIKI帮助文档
总帮助

高级语法

条件

循环

事件
下面的列表内容是你可以开始一个触发器的事件。
每个触发器只能有一个事件，你不能在给出的语法外自行创造事件。
请注意每个事件前面的on都是完全可选的，不过我加上会感觉更好：D
请注意如果事件只有一种触发方式的话就没有例子。

At time

模型:
at %time% [in %worlds%]
加入的版本:
1.3.4
关于Minecraft中所有/任一世界的时间
示例:
at 18:00
at 7am in "world"

On Bed Enter

模型:
[on] bed enter[ing]
[on] [player] enter[ing] [a] bed
加入的版本:
1.0
当玩家上床时

On Bed Leave

模型:
[on] bed leav(e|ing)
[on] [player] leav(e|ing) [a] bed
加入的版本:
1.0
当玩家离开床

On Block Damage

模型:
[on] block damage
加入的版本:
1.0
当玩家开始打方块，你可以用来探测左键

On Break / Mine

模型:
[on] [block] (min(e|ing)) [[of] %item types%]
加入的版本:
1.0 (break), unknown (mine)
当方块被玩家破坏。如果使用on mine的话，只有掉落东西才会触发触发器。
示例:
on mine
on break of stone
on mine of any ore

On Bucket Empty

模型:
[on] bucket empty[ing]
[on] [player] empty[ing] [a] bucket
加入的版本:
1.0
当玩家把桶里的东西倒出，可以检测水和岩浆的放置事件。

On Bucket Fill

模型:
[on] bucket fill[ing]
[on] [player] fill[ing] [a] bucket
加入的版本:
1.0
当玩家在桶里装东西，可以检测水和岩浆的破坏事件。

On Burn
模型:
[on] [block] burn[ing] [[of] %item types%]
加入的版本:
1.0
当方块被火燃烧
示例:
on burn
on burn of wood, fences, or chests

On Can Build Check
模型:
[on] [block] can build check
加入的版本:
1.0 (基础), 2.0 (可以取消事件发生)
当玩家手持一个方块或能防止的物品时右击方块被触发。你可以取消这个事件，来防止方块被放置。
只支持物品ID的检查，不允许数据值

On Chat
模型:
[on] chat
加入的版本:
1.4.1
当玩家聊天时.

On Chunk Generate
模型:
[on] chunk (generat|populat)(e|ing)
加入的版本:
1.0
当区块被创建

On Chunk Load
模型:
[on] chunk load[ing]
加入的版本:
1.0
当区块读取

On Chunk Unload
模型:
[on] chunk unload[ing]
加入的版本:
1.0
当区块被卸载，可以取消事件

On Click
模型:
[on] [(right|left)[( |-)]][mouse[( |-)]]click[ing] [on %entity type/item type%] [(with|using|holding) %item type%]
[on] [(right|left)[( |-)]][mouse[( |-)]]click[ing] (with|using|holding) %item type% on %entity type/item type%
加入的版本:
1.0
当玩家空手点击方块、空气和实体
在玩家没有看向方块/手拿东西时是无法检测的
示例:
on click
on rightclick holding a fishing rod
on leftclick on a stone or obsidian
on rightclick on a creeper
on click with a sword

On Combust
模型:
[on] combust[ing]
加入的版本:
1.0
当实体开始燃烧

On Command
模型:
[on] command [%text%]
加入的版本:
2.0
当玩家输入一个指令
使用这个事件不如自定义命令，改变权限的方式不能预防某些指令，记录命令，检测其他插件。
示例:
on command
on command "/stop"
on command "pm Njol "

On Connect
模型:
[on] [player] connect[ing]
加入的版本:
2.0
当玩家连接服务器，这在玩家加入服务器之前运行。
示例:
on connect:
      player doesn't have permission "VIP"
      number of players is larger than 20
      kick the player due to "The last 5 slots are reserved for VIP players."

On Consume
模型:
[on] [player] ((eat|drink)[ing]|consum(e|ing)) [[of] %item types%]
加入的版本:
2.0
当玩家吃/喝一些东西

On Craft
模型:
[on] [player] craft[ing] [[of] %item types%]
加入的版本:
unknown
当玩家合成物品

On Creeper Power
模型:
[on] creeper power
加入的版本:
1.0
当苦力怕被充能

On Damage
模型:
[on] damag(e|ing) [of %entity type%]
加入的版本:
1.0
当实体接受攻击
示例:
on damage
on damage of a player

On Death
模型:
[on] death [of %entity types%]
加入的版本:
1.0
实体死亡
示例:
on death
on death of player
on death of a wither or ender dragon:
      broadcast "A %entity% has been slain in %world%!"

On Dispense
模型:
[on] dispens(e|ing) [[of] %item types%]
加入的版本:
unknown
发射器发射物品

On Drop
模型:
[on] [player] drop[ing] [[of] %item types%]
加入的版本:
unknown
玩家扔掉物品

On Enderman/Sheep
模型:
[on] enderman place
[on] enderman pickup
[on] sheep eat
加入的版本:
unknown
末影人搬运方块/羊吃草

On Experience Spawn
模型:
[on] [e]xp[erience] [orb] spawn
[on] spawn of [a[n]] [e]xp[erience] [orb]
加入的版本:
2.0
当经验值生成时，不能检测其他插件生成的经验。
示例:
on xp spawn:
      world is "minigame_world"
      cancel event

On Explode
模型:
[on] explo(d(e|ing)|sion)
加入的版本:
1.0
当发生爆炸时

On Explosion Prime
模型:
[on] explosion prime
加入的版本:
1.0
爆炸前的准备

On Fade
模型:
[on] [block] fad(e|ing) [[of] %item types%]
加入的版本:
1.0
融化
示例:
on fade of snow or ice

On First Join
模型:
[on] first (join|login)
加入的版本:
1.3.7
玩家第一次加入游戏

On Fishing
模型:
[on] [player] fish[ing]
加入的版本:
1.0
玩家钓到了一些东西

On Flow
pre><模型:
[on] [block] flow[ing]
[on] block mov(e|ing)
加入的版本:
1.0
液体流动[/code]
On Form
模型:
[on] [block] form[ing] [[of] %item types%]
加入的版本:
1.0
当一个不是玩家放置的方块创建[下雪，结冰]
示例:
on form of snow
on form of a mushroom

On Fuel Burn
模型:
[on] fuel burn[ing]
加入的版本:
1.0
熔炉的燃料开始烧

On Gamemode Change
模型:
[on] game[ ]mode change [to %gamemode%]
加入的版本:
1.0
玩家切换游戏模式
示例:
on gamemode change
on gamemode change to adventure

On Grow
模型:
[on] grow [of %tree type%]
加入的版本:
1.0
树/蘑菇长大
示例:
on grow
on grow of a tree
on grow of a huge jungle tree

On Heal
模型:
[on] heal[ing]
加入的版本:
1.0
实体被治疗

On Hunger Meter Change

模型:
[on] (food|hunger) (level|met(er|re)|bar) chang(e|ing)
加入的版本:
1.4.4
当玩家的饥饿值改变

On Ignition
模型:
[on] [block] ignit(e|ion)
加入的版本:
1.0
方块被燃烧

On Item Break
模型:
[on] [player] tool break[ing]
[on] [player] break[ing] [(a|the)] tool
加入的版本:
2.1.1
玩家的工具没耐久，自然损坏[这个不能被取消事件]

On Item Spawn
模型:
[on] item spawn[ing] [[of] %item types%]
加入的版本:
unknown
当有掉落物生成

On Join
模型:
[on] [player] (login|logging in|join[ing])
加入的版本:
1.0
当玩家加入游戏
示例:
on join:
      message "Welcome on our awesome server!"
      broadcast "%player% just joined the server!"

On Kick
模型:
[on] [player] (kick|being kicked)
加入的版本:
1.0
当一个玩家被T出游戏

On Leaves Decay
模型:
[on] leaves decay[ing]
加入的版本:
1.0
树叶消失

On Level Change
模型:
[on] [player] level [change]
加入的版本:
unknown
玩家等级改变

On Lightning Strike
模型:
[on] lightning [strike]
加入的版本:
1.0
发生闪电

On Move On
模型:
[on] (step|walk)[ing] (on|over) %*item types%
加入的版本:
2.0
玩家踩上指定方块
示例:
on walking on dirt or grass
on stepping on stone

On Physics
模型:
[on] [block] physics
加入的版本:
1.4.6
物理变化
示例:
# prevents sand from falling
on block physics:
      block is sand
      cancel event

On Pick Up
模型:
[on] [player] (pick[ ]up|picking up) [[of] %item types%]
加入的版本:
unknown
玩家捡起物品

On Pig Zap
模型:
[on] pig[ ]zap
加入的版本:
1.0
猪变成僵尸猪人

On Piston Extend
模型:
[on] piston extend[ing]
加入的版本:
1.0
当活塞被激活

On Piston Retract
模型:
[on] piston retract[ing]
加入的版本:
1.0
当活塞收回

On Place
模型:
[on] [block] (plac(e|ing)|build[ing]) [[of] %item types%]
加入的版本:
1.0
放置方块
示例:
on place
on place of a furnace, workbench or chest

On Portal
模型:
[on] [player] portal
加入的版本:
1.0
使用地狱门/末地门

On Portal Create
模型:
[on] portal create
加入的版本:
1.0
当传送门被创建.

On Portal Enter
模型:
[on] portal enter
[on] entering [a] portal
加入的版本:
1.0
玩家进入传送门

On Pressure Plate / Trip
模型:
[on] [step[ping] on] [a] [pressure] plate
[on] (trip|[step[ping] on] [a] tripwire)
加入的版本:
1.0 (pressure plate), 1.4.4 (tripwire)
压力板

On Projectile Hit
模型:
[on] projectile hit
加入的版本:
1.0
当发射物击中实体或方块[箭雪球骷髅头火球鸡蛋]

On Quit
模型:
[on] (quit[ting]|disconnect[ing]|log[ ]out|logging out)
加入的版本:
1.0
当玩家离开游戏

On Redstone
模型:
[on] redstone [current] [chang(e|ing)]
加入的版本:
1.0
红石流通

On Region Enter/Leave
模型:
cannot be used directly
加入的版本:
2.1
进入/离开区域[需要区域插件]
示例:
on region exit:
      message "Leaving %region%."

On Respawn
模型:
[on] [player] respawn[ing]
加入的版本:
1.0
当玩家重生时

On Script Load/Unload
模型:
[on] [script] (load|init|enable)
[on] [script] (unload|stop|disable)
加入的版本:
2.0
当脚本被读取/卸载
示例:
on load:
      set {running.%script%} to true
on unload:
      set {running.%script%} to false

On Shoot
模型:
[on] [projectile] shoot
加入的版本:
1.0
当一个发射物被发射

On Sign Change
模型:
[on] sign (chang[e]|edit)[ing]
[on] [player] (chang[e]|edit)[ing] [a] sign
加入的版本:
1.0
牌子被玩家结束编辑
示例:
on sign change:
      line 2 is empty
      set line 1 to "<red>%line 1%"

On Skript Start/Stop
模型:
[on] (server|skript) (start|load|enable)
[on] (server|skript) (stop|unload|disable)
加入的版本:
2.0
当插件被读取/卸载
示例:
on Skript start
on server stop

On Smelt
模型:
[on] [ore] smelt[ing]
[on] smelt[ing] of ore
加入的版本:
1.0
当熔炉开始烧炼矿物

On Sneak Toggle
模型:
[on] [player] toggl(e|ing) sneak
[on] [player] sneak toggl(e|ing)
加入的版本:
玩家是否潜行
示例:
# make players that stop sneaking jump
on sneak toggle:
      player was sneaking
      push the player upwards at speed 0.5

On Spawn
模型:
[on] spawn[ing] [of %entity types%]
加入的版本:
1.0
当一个实体生成
示例:
on spawn of a zombie
on spawn of an ender dragon:
      broadcast "A dragon has been sighted in %world%!"

On Spawn Change
模型:
[on] [world] spawn change
加入的版本:
1.0
当世界的重生点被切换

On Spread
模型:
[on] spread[ing]
加入的版本:
1.0
当一个新方块生成，原方块可以传播，例如蘑菇和水

On Sprint Toggle
模型:
[on] [player] toggl(e|ing) sprint
[on] [player] sprint toggl(e|ing)
加入的版本:
unknown
当玩家切换疾跑状态

On Tame
模型:
[on] [entity] tam(e|ing)
加入的版本:
1.0
当玩家驯服狼/豹猫

On Target
模型:
[on] [entity] target
[on] [entity] un[-]target
加入的版本:
1.0
当怪物锁定一个实体进行攻击

On Teleport
模型:
[on] [player] teleport[ing]
加入的版本:
1.0
当玩家被传送

On Throwing of an Egg
模型:
[on] throw[ing] [of] [an] egg
[on] [player] egg throw
加入的版本:
1.0
当玩家扔鸡蛋

On Tool Change
模型:
[on] [player['s]] (tool|item held|held item) chang(e|ing)
加入的版本:
1.0
当玩家的工具切换

On Vehicle Create
模型:
[on] vehicle create
[on] creat(e|ing|ion of) [a] vehicle
加入的版本:
1.0
当一个载具被创建.

On Vehicle Damage
模型:
[on] vehicle damage
[on] damag(e|ing) [a] vehicle
加入的版本:
1.0
载具被攻击

On Vehicle Destroy
模型:
[on] vehicle destroy
[on] destr(oy[ing]|uction of) [a] vehicle
加入的版本:
1.0
载具被摧毁

On Vehicle Enter
模型:
[on] vehicle enter
[on] enter[ing] [a] vehicle
加入的版本:
1.0
实体进入载具

On Vehicle Exit
模型:
[on] vehicle exit
[on] exit[ing] [a] vehicle
加入的版本:
1.0
实体离开载具

On Weather Change
模型:
[on] weather change [to %weather types%]
加入的版本:
1.0
一个世界的天气被切换
示例:
on weather change
on weather change to sunny

On World Init
模型:
[on] world init
加入的版本:
1.0
一个新的世界被创建

On World Load
模型:
[on] world load[ing]
加入的版本:
1.0
世界被加载

On World Save
模型:
[on] world sav(e|ing)
加入的版本:
1.0
世界被存储

On World Unload
模型:
[on] world unload[ing]
加入的版本:
1.0
世界被卸载

On Zombie Break Door
模型:
[on] zombie break[ing] [a] [wood[en]] door
加入的版本:
unknown
僵尸破坏门

Periodical
模型:
every %time span% in [worlds] %worlds%
加入的版本:
1.0
每隔一定的现实时间
示例:
every second
every minecraft hour
every tick # 警告:卡的一比
every minecraft day in "world"

条件

Can Build
模型:
不能直接使用
加入的版本:
2.0
检测玩家是否可以在区域中放置方块，需要一个区域插件
示例:
command /setblock <material>:
      description: set the block at your crosshair to a different type
      trigger:
            player cannot build at the targeted block:
                     message "You do not have permission to change blocks there!"
                     stop
            set the targeted block to argument

Can Hold
模型:
%inventories% (can hold|ha(s|ve) [enough] space (for|to hold)) %item types%
%inventories% (can(no|')t hold|(ha(s|ve) not|ha(s|ve)n't|do[es]n't have) [enough] space (for|to hold)) %item types%
加入的版本:
1.0
检测玩家的背包或箱子是否有足够的空间
示例:
block can hold 200 cobblestone
player has enough space for 64 feathers

Chance
模型:
chance of %number%[\%]
加入的版本:
1.0
脚本成功或失败的几率
示例:
chance of 50%:
      drop a diamond
chance of {var}% # {var} between 0 and 100
chance of {var} # {var} between 0 and 1

Comparison
模型:
[neither] %objects% ((is|are) ((greater|more|higher|bigger|larger) than|above)|>) %objects%
[neither](neither)|isn't|aren't) ((less|smaller) than|below)|>=) %objects%
[neither] %objects% ((is|are) ((less|smaller) than|below)|<) %objects%
[neither](neither)|isn't|aren't) ((greater|more|higher|bigger|larger) than|above)|<=) %objects%
[neither](neither)|isn't|aren't|!=) [equal to] %objects%
[neither] %objects% (is|are|=) [(equal to|the same as)] %objects%
[neither] %objects% (is|are) between %objects% and %objects%
[neither](is not|are not|isn't|aren't) between %objects% and %objects%
加入的版本:
1.0
非常常规的脚本，比较两量关系。通常你可以使用平等(如 block is/isn't of <type>), 但一些值可以使用更多/更少。
在这种情况下，你也可以测试一个对象是否在两个其他量之中。
注意：这只是一些形式。事实上，另外两套类似的模式，但（was|were）或将代替（is|are）分别检测不同时间状态的表达。
示例:
the clicked block is a stone slab or a double stone slab
time in the player's world is greater than 8:00
the creature is not an enderman or an ender dragon

Contains
模型:
%inventories% ha(s|ve) %item types% [in [(the[ir]|his|her|its)] inventory]
%inventories/texts/objects% contains %item types/texts/objects%
%inventories% do[es](n't| not) have %item types% [in [(the[ir]|his|her|its)] inventory]
%inventories/texts/objects% do[es](n't| not) contain %item types/texts/objects%
加入的版本:
1.0
检查有无物品，一段对话有无一些字，或列出变量表是否包含某变量。
示例:
block contains 20 cobblestone
player has 4 flint and 2 iron ingots

Damage Cause
模型:
[the] damage [(n('|o)]t) [been] (caused|done|made) by %damage cause%
加入的版本:
2.0
检查是什么造成的伤害，来源可以查看变量表。
示例:
# make players use their potions of fire resistance whenever they take any kind of fire damage
on damage:
      damage was caused by lava, fire or burning
      victim is a player
      victim has a potion of fire resistance
      cancel event
      apply fire resistance to the victim for 30 seconds
      remove 1 potion of fire resistance from the victim
# prevent mobs from dropping items under certain circumstances
on death;
      entity is not a player
      damage wasn't caused by a block explosion, an attack, a projectile, a potion, fire, burning, thorns or poison
      clear drops

Exists/Is Set
模型:
%~objects% (exists|(is|are) set)
%~objects% (do[es](n't| not) exist|(is|are)(n't| not) set)
加入的版本:
1.2
检查一个表达式是否被创建
示例:
{teamscript.%player%.preferred team} is not set
on damage:
      projectile exists
      broadcast "%attacker% used a %projectile% to attack %victim%!"

Has Permission
模型:
[%players/console%] (do[es]n't|don't|do[es] not) have [the] permissions %texts%
[%players/console%] ha(s|ve) [the] permissions %texts%
加入的版本:
1.0
检查玩家有无权限
示例:
player has permission "skript.tree"
victim has the permission "admin":
      send "You're attacking an admin!" to attacker

Has Played Before
模型:
%offline player% [(has|did)] [already] play[ed] [on (this|the) server] (before|already)
%offline player% (has not|hasn't|did not|didn't) [(already|yet)] play[ed] [on (this|the) server] (before|already|yet)
加入的版本:
1.4
检查玩家之前是否玩过游戏
示例:
player has played on this server before
player hasn't played before

Is Alive
模型:
%living entities% (alive|dead)
%living entities% (alive|dead)
加入的版本:
2.0
检查实体是否存活
示例:
{villagerbuddy.%player%} is dead

Is Banned
模型:
%offline players/texts% (is|are) banned
%players/texts% [(is|are) IP(-| )]banned
%offline players/texts% (isn't|is not|aren't|are not) banned
%players/texts% [(isn't|is not|aren't|are not) IP(-| )]banned
加入的版本:
1.4
检查一个玩家或IP是否被BAN掉
示例:
player is banned
victim is not IP-banned
"127.0.0.1" is banned

Is Blocking
模型:
%players% (is|are) (blocking|defending)
%players% (isn't|is not|aren't|are not) (blocking|defending)
加入的版本:
unknown
检查玩家是否在格挡
示例:
victim is blocking

Is Burning
模型:
%entities% (is|are) (burning|ignited|on fire)
%entities% (isn't|is not|aren't|are not) (burning|ignited|on fire)
加入的版本:
1.4.4
检查实体是否在燃烧
示例:
# increased attack against buring targets
victim is burning:
      increase damage by 2

Is Empty
模型:
%inventories/slots/texts% (is|are) empty
%inventories/slots/texts% (isn't|is not|aren't|are not) empty
加入的版本:
unknown
检查物品栏/装备栏/文本是空的
示例:
player's inventory is empty

Is Enchanted
模型:
%item types% (is|are) enchanted [with %enchantment type%]
%item types% (isn't|is not|aren't|are not) enchanted [with %enchantment type%]
加入的版本:
1.4.6
检查物品有无附魔
示例:
tool of the player is enchanted with efficiency 2
helm, chestplate, leggings or boots are enchanted

Is Flying
模型:
%players% (is|are) flying
%players% (isn't|is not|aren't|are not) flying
加入的版本:
1.4.4
检查玩家飞行
示例:
player is not flying

Is Holding
模型:
[%living entities%] ha(s|ve) %item types% in hand
[%living entities%] (is|are) holding %item types%
[%living entities%] (ha(s|ve) not|do[es]n't have) %item types% in hand
[%living entities%] (is not|isn't) holding %item types%
加入的版本:
1.0
检查玩家是否持有特定物品。不能在末影人上使用，请使用'entity is [not] an enderman holding <item type>'
示例:
player is holding a stick
victim isn't holding a sword of sharpness

Is in World
模型:
%entities% (is|are) in [[the] worlds] %worlds%
%entities% (is not|isn't|are not|aren't) in [[the] worlds] %worlds%
加入的版本:
1.4
检查玩家是否在世界里
示例:
player is in "world"
argument isn't in world "world_nether"
the attacker is in the world of the victim

Is Member/Owner of Region
模型:
不能直接使用
加入的版本:
2.1
检查玩家是否为这个区域的成员或主人，需要一个区域插件。
示例:
on region enter:
      player is the owner of the region
      message "Welcome back to %region%!"
      send "%player% just entered %region%!" to all members of the region

Is of Type
模型:
%item stacks/entities% (is|are) of types %item types/entity types%
%item stacks/entities% (isn't|is not|aren't|are not) of types %item types/entity types%
加入的版本:
1.4
检查物品或实体是否为给定的类型。这经常对变量很有效，你也可以用is来代替。(如. 'victim is a creeper').
示例:
tool is of type {*selected type}
victim is of type {villager type}

Is Online
模型:
%offline players% ((is|are) online|(is not|isn't|are not|aren't) offline)
%offline players% ((is|are) offline|(is not|isn't|are not|aren't) online)
加入的版本:
1.4
检查玩家是否在线
示例:
player is online
player-argument is offline

Is Poisoned
模型:
%living entities% (is|are) poisoned
%living entities% (isn't|is not|aren't|are not) poisoned
加入的版本:
1.4.4
检测实体是否中毒
示例:
player is poisoned:
      cure the player from posion
      message "You have been cured!"

Is Riding
模型:
%entities% (is|are) riding [%entity types%]
%entities% (isn't|is not|aren't|are not) riding [%entity types%]
加入的版本:
2.0
检查实体有无骑着其他实体
示例:
player is riding a saddled pig

Is Sleeping
模型:
%players% (is|are) sleeping
%players% (isn't|is not|aren't|are not) sleeping
加入的版本:
1.4.4
检查玩家是否在睡觉
示例:
# cut your enemies' throats in their sleep >=)
on attack:
      attacker is holding a sword
      victim is sleeping
      increase the damage by 1000

Is Sneaking
模型:
%players% (is|are) sneaking
%players% (isn't|is not|aren't|are not) sneaking
加入的版本:
1.4.4
检测玩家是否在潜行
示例:
# prevent mobs from seeing sneaking players if they are at least 4 meters apart
on target:
      target is sneaking
      distance of target and the entity is bigger than 4
      cancel the event

Is Sprinting
模型:
%players% (is|are) sprinting
%players% (isn't|is not|aren't|are not) sprinting
加入的版本:
1.4.4
检查玩家是否在疾跑
示例:
player is not sprinting

Is Wearing
模型:
%living entities% (is|are) wearing %item types%
%living entities% (isn't|is not|aren't|are not) wearing %item types%
加入的版本:
1.0
Checks whether a player is wearing some armour.
示例:
player is wearing an iron chestplate and iron leggings
player is wearing all diamond armour

PvP
模型:
(is PvP|PvP is) enabled [in %worlds%]
(is PvP|PvP is) disabled [in %worlds%]
加入的版本:
1.3.4
检查PVP状态
示例:
PvP is enabled
PvP is disabled in "world"

Region Contains
模型:
不能直接使用
加入的版本:
2.1
区域中有XXX，必须有区域插件
示例:
player is in the region {regions::3}
on region enter:
      region contains {flags.%world%.red}
      message "The red flag is near!"

Time
模型:
%date% (was|were)( more|(n't| not) less) than %time span% [ago]
%date% (was|were)((n't| not) more| less) than %time span% [ago]
加入的版本:
2.0
给予变量时间
示例:
command /command_with_cooldown:
      trigger:
            {command.%player%.lastused} was less than a minute ago:
                     message "Please wait a minute between uses of this command."
                     stop
            set {command.%player%.lastused} to now
            # ... actual command trigger here ...

Weather
模型:
is %weather types% [in %worlds%]
加入的版本:
1.0
检查世界的天气
示例:
is thundering
is raining in "world" or "world2"

效果

Ban
模型:
ban %texts/offline players% [(by reason of|because [of]|on account of|due to) %text%]
unban %texts/offline players%
ban %players% by IP [(by reason of|because [of]|on account of|due to) %text%]
unban %players% by IP
IP(-| )ban %players% [(by reason of|because [of]|on account of|due to) %text%]
(IP(-| )unban|un[-]IP[-]ban) %players%
加入的版本:
1.4, 2.1.1 (ban reason)
BAN掉玩家或IP
必须满足Skript 2.1.1及Bukkit 172 R0.4以上，可以使用原因来ban出玩家。
如果是一个不支持的原因[如没有创建的变量]，玩家仍旧会被BAN，但会使用默认原因。
示例:
unban player
ban "127.0.0.1"
IP-ban the player because "he is an idiot"

Broadcast
模型:
broadcast %texts% [(to|in) %worlds%]
加入的版本:
1.0
在服务器公告内容
示例:
broadcast "Welcome %player% to the server!"
broadcast "Woah! It's a message!"

Cancel Event
模型:
cancel [the] event
uncancel [the] event
加入的版本:
1.0
取消事件的发生
示例:
on damage:
      victim is a player
      victim has the permission "skript.god"
      cancel the event

Change: Set/Add/Remove/Delete/Reset
模型:
(add|give) %objects% to %~objects%
increase %~objects% by %objects%
give %~objects% %objects%
set %~objects% to %objects%
remove (all|every) %objects% from %~objects%
(remove|subtract) %objects% from %~objects%
reduce %~objects% by %objects%
(delete|clear) %~objects%
reset %~objects%
加入的版本:
1.0 (set, add, remove, delete), 2.0 (remove all)
改变表达式，非常常规的效果
示例:
# set:
Set the player's display name to "<red>%name of player%"
set the block above the victim to lava
# add:
add 2 to the player's health # preferably use '<a href='#heal'>heal</a>' for this
add argument to {blacklist::*}
give a diamond pickaxe of efficiency 5 to the player
increase the data value of the clicked block by 1
# remove:
remove 2 pickaxes from the victim
subtract 2.5 from {points.%player%}
# remove all:
remove every iron tool from the player
remove all minecarts from {entitylist::*}
# delete:
delete the block below the player
clear drops
delete {variable}
# reset:
reset walk speed of player
reset chunk at the targeted block

Colour Armour
模型:
(dye|colour|paint) %slots/item stack% %color%
(dye|colour|paint) %slots/item stack% (%number%, %number%, %number%)
加入的版本:
2.0
给当前装备染色，你可以使用RGB代码。
示例:
dye player's helmet blue
colour the player's tool red

Command
模型:
[execute] [the] command %texts% [by %players/console%]
[execute] [the] %players/console% command %texts%
(let|make) %players/console% execute [[the] command] %texts%
加入的版本:
1.0
使用指令
示例:
make player execute command "/suicide"
execute console command "/say Hello everyone!"

Damage/Heal/Repair
模型:
damage %slots/living entities/item stack% by %number% [hearts]
heal %living entities% [by %number% [hearts]]
repair %slots/item stack% [by %number%]
加入的版本:
1.0
攻击/治疗/修复
示例:
damage player by 5 hearts
heal the player
repair tool of player

Delay
模型:
(wait|halt) [for] %time span%
加入的版本:
1.4
等待一定的事件，不能作为tempban使用
示例:
wait 2 minutes
halt for 5 minecraft hours
wait a tick

Drop
模型:
drop %item types/experience point% [%directions% %locations%]
加入的版本:
1.0
掉落一个或多个物品
示例:
on death of creeper:
      drop 1 TNT

Enchant/Disenchant
模型:
enchant %~item stack% with %enchantment types%
disenchant %~item stack%
加入的版本:
2.0
给物品附魔或解除附魔
示例:
enchant the player's tool with sharpness 5
disenchant the player's tool

Equip
模型:
equip [%living entity%] with %item types%
make %living entity% wear %item types%
加入的版本:
1.0
给玩家穿戴装备，会覆盖当前装备。
Skript 2.1 起怪物也能穿戴装备了，猪可以穿戴鞍，马可以穿戴鞍，马铠和箱子。
示例:
equip player with diamond helmet
equip player with all diamond armour
equip the clicked horse with diamond horse armour and a saddle
make the last spawned pig wear a saddle

Exit
模型:
(exit|stop) [trigger]
(section|loop|conditional)
(section|loop|conditional)s
(section|loop|conditional)s
加入的版本:
unknown
停止循环的触发器
示例:
if player has any ore:
      stop
message "%player% has no ores!"
loop blocks above the player:
      loop-block is not air:
            exit 2 sections
      set loop-block to water

Explosion
模型:
[(create|make)] [an] explosion (of|with) (force|strength|power) %number% [%directions% %locations%]
[(create|make)] [a] safe explosion (of|with) (force|strength|power) %number% [%directions% %locations%]
[(create|make)] [a] fake explosion [%directions% %locations%]
[(create|make)] [an] explosion[ ]effect [%directions% %locations%]
加入的版本:
1.0
用给出的力量制造爆炸。
力量是0时可以制造一场假爆炸，如第三行。
从 Bukkit 1.4.5 / Skript 2.0 开始你可以使用第二行，即安全爆炸，不会破坏方块。
示例:
create an explosion of force 10 at the player
create a fake explosion at the victim

Ignite/Extinguish
模型:
(ignite|set fire to) %entities% [for %time span%]
(set|light) %entities% on fire [for %time span%]
extinguish %entities%
加入的版本:
1.4
在实体上制造火焰/打雷
示例:
ignite the player
extinguish the player

Kick
模型:
kick %players% [(by reason of|because [of]|on account of|due to) %text%]
加入的版本:
1.0
把玩家从服务器踢出
示例:
on place of TNT, lava, or obsidian:
      kick the player due to "You may not place %block%!"
      cancel the event

Kill
模型:
kill %entities%
加入的版本:
1.0
击杀一个或多个实体。
注意: 这个效果不是把实体的生命设置为0，并不会触发死亡消息，而且不会掉落物品，而是用它最大生命的100倍去伤害它。
示例:
kill the player
kill all creepers in the player's world
kill all endermen, witches and bats

Lightning
模型:
[[ ]effect] %directions% %locations%
加入的版本:
1.4
在位置生成一道闪电
示例:
strike lightning at the player
strike lightning effect at the victim

Log
模型:
log %texts% [(to|in) [files] %texts%]
加入的版本:
2.0
写一个log文件。你可以在 /plugins/Skript/logs 里找到
使用 'server.log' 将如此记录 '[Skript] [<script>.sk] <message>'
示例:
on place of TNT:
      log "%player% placed TNT in %world% at %location of block%" to "tnt/placement.log"

Message
模型:
(message|send [message]) %texts% [to %players/console%]
加入的版本:
1.0
发送消息
示例:
message "A wild %player% appeared!"
message "This message is a distraction. Mwahaha!"
send "Your kill streak is %{kill streak.%player%}%." to player
if the targeted entity exists:
      message "You're currently looking at a %type of the targeted entity%!"

op/deop
模型:
[de[-]]op %offline players%
加入的版本:
1.0
给予/拿走玩家的OP权限
示例:
op the player
deop all players

Open Inventory
模型:
[(open|show) ((crafting [table]|workbench) (view|window|inventory)]|%inventory%) (to|for) %players%
close [the] inventory [view] (to|of|for) %players%
close %players%'s inventory [view]
加入的版本:
2.0, 2.1.1 (closing)
为玩家打开背包
SHOW为不能移动东西
OPEN为可以移动
示例:
show the victim's inventory to the player
open the player's inventory for the player
close the player's inventory

Play Effect
模型:
(play|show) %visual effects% (on|%directions%) %entities/locations% [to %players%]
加入的版本:
2.1
播放声音
示例:
play wolf hearts on the clicked wolf
show mob spawner flames at the targeted block to the player

Poison/Cure
模型:
poison %living entities% [for %time span%]
(cure|unpoison) %living entities% [(from|of) poison]
加入的版本:
1.3.2
中毒
示例:
poison the player
poison the victim for 20 seconds
cure the player from poison

Potion Effects
模型:
apply [potion of] %potions% [potion] [[[of] tier] %number%] to %living entities% [for %time span%]
加入的版本:
2.0
药水效果
示例:
apply swiftness 2 to the player
remove haste from the victim
on join:
      apply potion of strength of tier {strength.%player%} to the player for 999 days

Push
模型:
(push|thrust) %entities% %direction% [(at|with) (speed|velocity|force) %number%]
加入的版本:
1.4.6
推开实体
示例:
push the player upwards
push the victim downwards at speed 0.5

PvP
模型:
enable PvP [in %worlds%]
disable PVP [in %worlds%]
加入的版本:
1.3.4
检测PVP状态
示例:
enable PvP #(current world only)
disable PvP in all worlds

Replace
模型:
replace [(all|every)] %texts% in %text% with %text%
replace [(all|every)] %texts% with %text% in %text%
加入的版本:
2.0
把一些文本替换
示例:
replace "<item>" in {textvar} with "%tool of player%"
replace every "&" with "§" in line 1
# The following acts as a simple chat censor, but it will e.g. censor mass, hassle, assassin, etc. as well:
on chat:
      replace all "fuc[k"<ref>这是译者为了过审而加的</ref>, "bit]c][h" and "ass" with "****" in the message

Shear
模型:
shear %living entities%
un[-]shear %living entities%
加入的版本:
2.0
为羊剪羊毛，请注意不会掉落物品
示例:
on rightclick on a sheep holding a sword:
      shear the clicked sheep

Shoot
模型:
shoot %entity types% [from %living entities/locations%] [(at|with) (speed|velocity) %number%] [%direction%]
(make|let) %living entities/locations% shoot %entity types% [(at|with) (speed|velocity) %number%] [%direction%]
加入的版本:
1.4
从实体身上发射物品
示例:
shoot an arrow
make the player shoot a creeper at speed 10
shoot a pig from the creeper

Spawn
模型:
spawn %entity types% [%directions% %locations%]
spawn %number% of %entity types% [%directions% %locations%]
加入的版本:
1.0
召唤一个实体
示例:
spawn 3 creepers at the targeted block
spawn a ghast 5 meters above the player

Teleport
模型:
teleport %entities% (to|%direction%) %location%
加入的版本:
1.0
传送实体到某个位置
示例:
teleport the player to {homes.%player%}
teleport the attacker to the victim

Toggle
模型:
(close|turn off|de[-]activate) %blocks%
(toggle|switch) [[the] state of] %blocks%
(open|turn on|activate) %blocks%
加入的版本:
1.4
切换某个方块的状态，如开门
示例:
# use arrows to toggle levers, doors, etc.
on projectile hit:
projectile is arrow
toggle the block at the arrow

Tree
模型:
(grow|create|generate) tree [of type %tree type%] %directions% %locations%
(grow|create|generate) %tree type% [tree] %directions% %locations%
加入的版本:
1.0
生成树，需要有足够空间
示例:
grow a tall redwood tree above the clicked block

Vehicle
模型:
(make|let|force) %entities% [to] (ride|mount) [(in|on)] %entity/entity types%
[(make|let|force) %entities% [to] (dismount|(dismount|leave) (from|of)] [(any|the[ir]|his|her)] vehicles)
[(eject|dismount) (any|the)] passengers (of|from) %entities%
加入的版本:
2.0
使实体坐上载具。
示例:
make the player ride a saddled pig
make the attacker ride the victim

2016-08-18 14:37:00

cc7w

本帖最后由 1345979462 于 2016-8-20 14:33 编辑

表达式
表达式是表示某个对象的语法元素,如一个玩家一个数字多个物体服务器世界或列表中的方块。
表达式在Skript脚本中可以被用在任何地方如 set {var} to <value> 或 teleport <entity expression> to <location expression>.
值的另一个可能是使用统计值，如 ‘6’ 和 ‘a pickaxe and a shovel’.
这里有两种基础的表达式:
简单的表达式，其中只有一些简短的单词，如‘player’, ‘world’, or ‘last spawned entity’, 并且经常的依赖发生的事件, 它们的值会随着事件的改变而改变。
如player表达式会表达为当前触发事件的玩家。
属性表达式，从另一个表达式中获取值。如 data value of <item>, altitude of <location>, <entity>'s world.
但也有一些例外, e.g. distance between <location> and <location> or the direction expression.
表达式可以在循环中被使用，来循环执行某些代码，格式为

loop <expression>:

复制代码

请前往循环页来获取更多。

Advanced
从Skript 2.0开始, 表达式可以用圆括号来表示它们之间的关系，如, set {var} to 10 emeralds and an apple or 5 stone 会报错，
但 set {var} to 10 emeralds and (an apple or 5 stone) 便不会 (如果没有括号这个特殊的例子会报错).
如果你在表达式中使用另一个表达式请使用()括起，如 all players in "world" and "world_nether" 应写成 all players in ("world" and "world_nether"),
否则，就会被读取为 (all players in "world") and ("world_nether").
Altitude

模型:
[the] altitude[s] of %locations%
%locations%'[s] altitude[s]
加入的版本:
1.4.3
是Y坐标的简写形式，这会表示Y坐标为0以上的Y坐标。
示例:
on damage:
altitude of the attacker is higher that the altitude of the victim
set damage to damage * 1.25

复制代码

Amount

模型:
(amount|number|size) of %objects%
加入的版本:
1.0
一些东西的数量
请注意 amount of <items> 并不会返回物品的数量，而是物品的组数如 1 表示 64 个
示例:
message "There are %number of all players% players online!"

复制代码

Amount of Items

模型:
[the] (amount|number) of %item types% (in|of) %inventories%
加入的版本:
2.0
在给出的物品栏计数物品
示例:
message "You have %number of ores in the player's inventory% ores in your inventory."

复制代码

Argument

模型:
[the] last arg[ument][s]
[the] arg[ument][s](-| )<(d+)>
[the] <(d*1)st|(d*2)nd|(d*3)rd|(d*[4-90])th> arg[ument][s]
[the] arg[ument][s]
[the] %*type%( |-)arg[ument][( |-)<d+>]
[the] arg[ument]( |-)%*type%[( |-)<d+>]
加入的版本:
1.0
只在命令中工作。持有给予参数的值,如指令 "/tell " 会这样使用 "/tell Njol Hello Njol!", 第一个参数是玩家 "Njol" 第二个参数是 "Hello Njol!".
同时也可以使用参数的类型来代替它的值如上面的 'player-argument' 与第一个参数相同
示例:
give the item-argument to the player-argument
damage the player-argument by the number-argument
give a diamond pickaxe to the argument
add argument 1 to argument 2
heal the last argument

复制代码

Arithmetic

模型:
%number%[ ]+[ ]%number%
%number%[ ]-[ ]%number%
%number%[ ]*[ ]%number%
%number%[ ]/[ ]%number%
%number%[ ]^[ ]%number%
加入的版本:
1.4.2
代数运算, 如. 1+2, (2 - health of player)/3
支持的运算有addition (+), subtraction (-), multiplication (*), division (/), and exponentiation 次方 (^). ''Negation is not available yet, use 0 - expr instead.''
示例:
set the player's health to 10 - the player's health
loop (argument + 2)/5 times:
message "Two useless numbers: %loop-num*2 - 5%, %2^loop-num - 1%"
message "You have %health of player * 2% half hearts of HP!"

复制代码

Armour Slot

模型:
[the] (boot[s]|shoe[s]|leg[ging][s]|chestplate[s]|helm[et][s]) [slot] of %living entities%
%living entities%'[s] (boot[s]|shoe[s]|leg[ging][s]|chestplate[s]|helm[et][s]) [slot]
加入的版本:
1.0
玩家装备栏的一个部分
在SK 2.1之后兼容怪物的物品栏
示例:
set chestplate of the player to a diamond chestplate
helmet of player is neither a helmet nor air # player is wearing a block, e.g. from another plugin

复制代码

Attacked

模型:
[the] (attacked|damaged|victim) [<(.+)>]
加入的版本:
1.3
一个受伤害的事件
示例:
on damage:
victim is a creeper
damage the attacked creeper by 1 heart

复制代码

Attacker

模型:
[the] (attacker|damager)
加入的版本:
1.3
受伤害事件中的攻击者
攻击者可以是自然如. a cactus or lava, 但这种情况下将不会有表达式
示例:
on damage:
attacker is a player
health of attacker is less than or equal to 2
damage victim by 1 heart

复制代码

Bed

模型:
[the] bed[s] [location[s]] of %players%
%players%'[s] bed[s] [location[s]]
加入的版本:
2.0
玩家床的位置
示例:
bed of player exists:
teleport player the the player's bed
else:
teleport the player to the world's spawn point

复制代码

Biome

模型:
[the] biome (of|%direction%) %location%
%location%'[s] biome
加入的版本:
1.4.4
当前位置的生物群系。请注意至于X Z坐标有关，Y坐标不会有关系。
示例:
# damage player in deserts constantly
every real second:
loop all players:
biome at loop-player is desert
damage the loop-player by 1

复制代码

Block

模型:
[the] [event-]block
[the] block %direction% [%location%]
加入的版本:
1.0
事件中的方块，如点击的方块和破坏的方块
同时支持方块的位置, 如 'block above' or 'block in front of the player'.
示例:
block is ore
set block below to air
spawn a creeper above the block
loop blocks in radius 4:
loop-block is obsidian
set loop-block to water
block is a chest:
clear the inventory of the block

复制代码

Block Sphere

模型:
[(all|the)] blocks in radius %number% [(of|around) %location%]
[(all|the)] blocks around %location% in radius %number%
加入的版本:
1.0
玩家半径内的所有方块，经常用在循环中
示例:
loop blocks in radius 5 around the player:
set loop-block to air
set all blocks in radius 5 around the player to air

复制代码

Blocks

模型:
[the] blocks %direction% [%locations%]
[the] blocks from %location% [on] %direction%
[the] blocks from %block% to %block%
[the] blocks between %block% and %block%
加入的版本:
1.0
相对于其他方块的方块或其他方块之间的方块。经常用于循环中
示例:
loop blocks above the player:
loop blocks between the block below the player and the targeted block:
set the blocks below (the player, the victim and the targeted block) to air

复制代码

Blocks in Region

模型:
cannot be used directly
加入的版本:
2.1
区域中的方块，需要区域插件
示例:
loop all blocks in the region {arena.%{faction.%player%}%}:
clear the loop-block

复制代码

Chunk

模型:
[the] chunk[s] (of|%directions%) %locations%
%locations%'[s] chunk[s]
加入的版本:
2.0
区块
示例:
add the chunk at the player to {protected chunks::*}

复制代码

Clicked Block/Entity

模型:
[the] clicked (block|%*item type/entity type%)
加入的版本:
1.0
点击的方块/实体
示例:
message "You clicked on a %type of clicked entity%!"
clicked block is a chest:
show the inventory of the clicked block to the player

复制代码

Colour of

模型:
[the] colo[u]r[s] of %item stacks/entities%
%item stacks/entities%'[s] colo[u]r[s]
加入的版本:
1.2
物品的染色色彩。如 "<%colour of ...%>this text is coloured!".
示例:
on click on wool:
message "This wool block is <%colour of block%>%colour of block%<reset>!"
set the colour of the block to black

复制代码

Coloured / Uncoloured

模型:
(colo[u]r-|colo[u]red )%texts%
(un|non)[-](colo[u]r-|colo[u]red )%texts%
加入的版本:
2.0
在文本中添加或移除颜色
这个表达式会替换本地的颜色与格式。它不会取代英语，这使得它适用于颜色命令参数和聊天消息。
示例:
on chat:
set message to coloured message
command /fade <player>:
trigger:
set display name of the player-argument to uncoloured display name of the player-argument

复制代码

Command

模型:
[the] (full|complete|whole) command
[the] command [label]
[the] arguments
加入的版本:
2.0
触发指令事件的指令
使用'full command'来查看包括参数的指令, 'arguments' 来查看参数部分。
这个事件不能胜任一些自定义命令. See the article on custom commands to find out how to define new commands.
示例:
# prevent any commands except for the /exit command during some game
on command:
{game.%player%.is playing} is true
command is not "exit"
message "You're not allowed to use commands during the game"
cancel the event

复制代码

Command Sender

模型:
[the] [command['s]] (sender|executor)
加入的版本:
2.0
发送指令的人或控制台
示例:
make the command sender execute "/say hi!"
on command:
log "%executor% used command /%command% %arguments%" to "commands.log"

复制代码

Compass Target

模型:
[the] compass target of %players%
%players%'[s] compass target
加入的版本:
2.0
玩家的指南针指向
你可以使指南针指向一个实体，但只是指向这个当前的位置。
示例:
# make all player's compasses target a player stored in {compass target.%player%}
every 5 seconds:
loop all players:
set the loop-player's compass target to location of {compass target.%loop-player%}

复制代码

Console

模型:
[the] (console|server)
加入的版本:
1.3.1
服务器控制台
示例:
execute console command "/stop"
send "message to console" to the console

复制代码

Coordinate

模型:
[the] (x|y|z)(-| )(coord[inate]|pos[ition]|loc[ation])[s] of %locations%
%locations%'[s] (x|y|z)(-| )(coord[inate]|pos[ition]|loc[ation])[s]
加入的版本:
1.4.3
表示位置的一个坐标
示例:
player's y-coordinate is smaller than 40:
message "Watch out for lava!"

复制代码

Creature/Entity/Player/Projectile/Villager/Powered Creeper/etc.

模型:
[the] [event-]<.+>
加入的版本:
1.0
触发事件的实体
你可以使用实体的类型，如在 'death of a creeper' 中你可以使用 'the creeper' 来代替 'the entity'.
示例:
give a diamond sword of sharpness 3 to the player
kill the creeper
kill all powered creepers in the wolf's world
projectile is an arrow

复制代码

Damage

模型:
[the] damage
加入的版本:
1.3.5
在伤害事件中的伤害值,可能忽略护甲, 附魔。可以被更改[注意在Skript中1是满心，不是半心]
示例:
increase the damage by 2

复制代码

Damage Cause

模型:
[the] damage (cause|type)
加入的版本:
2.0
伤害事件中造成伤害的来源
示例:
damage cause is lava, fire or burning

复制代码

Data Value

模型:
[the] ((data|damage)[s] [value[s]]|durabilit(y|ies)) of %item stacks/slots%
%item stacks/slots%'[s] ((data|damage)[s] [value[s]]|durabilit(y|ies))
加入的版本:
1.2
一个物品的数据值
你一般不需要这个表达式，因为你可以直接检测类型。但是这个表达式可以改变数据值，如 "add 1 to data of <item>", 如循环使用羊毛颜色
示例:
add 1 to the data value of the clicked block

复制代码

Difference

模型:
difference (between|of) %object% and %object%
加入的版本:
1.4
两个值之间的差异
示例:
difference between {command.%player%.lastuse} and now is smaller than a minute:
message "You have to wait a minute before using this command again!"
stop

复制代码

Direction

模型:
[%number% [(north[(east|west)][(south[(east|west)][(east|west)[(above|over|up|down)[ward(below|under[neath]|beneath) [%direction%]
[%number% [[(direction|horizontal direction|facing|horizontal facing) of %entity/block% (of|from)]
[%number% [[(direction|horizontal direction|facing|horizontal facing) (of|from)]
[%number% [(in[ ]front [of]|forward[s]|behind|backwards|right|left) [of])
[%number% [(in[ ]front [of]|forward[s]|behind|backwards|right|left) [of])
加入的版本:
1.0 (basic), 2.0 (extended)
当前位置类型的一个帮助表达式
示例:
thrust the player upwards
set the block behind the player to water
loop blocks above the player:
set {_rand} to a random integer between 1 and 10
set the block {_rand} meters south east of the loop-block to stone
block in horizontal facing of the clicked entity from the player is air
spawn a creeper 1.5 meters horizontally behind the player
spawn a TNT 5 meters above and 2 meters horizontally behind the player
thrust the last spawned TNT in the horizontal direction of the player with speed 0.2
push the player upwards and horizontally forward at speed 0.5
push the clicked entity in in the direction of the player at speed -0.5
open the inventory of the block 2 blocks below the player to the player
teleport the clicked entity behind the player
grow a regular tree 2 meters horizontally behind the player

复制代码

Distance

模型:
[the] distance between %location% and %location%
加入的版本:
1.0
两点之间的距离
方块的距离经常按照中心来计算，实体按照脚的距离
示例:
distance between the player and {%player%.home} is smaller than 20:
message "You're very close to your home!"

复制代码

Drops

模型:
[the] drops
加入的版本:
1.0
死亡事件中的掉落物
掉落物可以如此被移除 "remove ... from drops",如 "remove all pickaxes from the drops", 或 "clear drops" 如果你不想要任何掉落物的话
示例:
clear drops
remove 4 planks from the drops

复制代码

Element of

模型:
([the] first|[the] last|[a] random) element [out] of %objects%
加入的版本:
2.0
最后的参数是随机元素的列表,如变量列表
示例:
give a random element out of {free items::*} to the player

复制代码

Enchantment Level

模型:
[the] (%enchantment% level|level of [[the] enchant[ment]] %enchantment%) o(f|n) %item types%
%item types%'[s] (%enchantment% level|level of [[the] enchant[ment]] %enchantment%)
加入的版本:
2.0
附魔的等级
示例:
player' tool is a sword of sharpness:
message "You have a sword of sharpness %level of sharpness of the player's tool% equipped"

复制代码

Ender Chest

模型:
[the] ender[ ]chest[s] of %players%
%players%'[s] ender[ ]chest[s]
加入的版本:
2.0
玩家的末影箱. 这个项目在打开背包时可以使用，其中的物品可以被修改，它也可以被任何玩家打开。(不只是它的主人).
示例:
open the player's ender chest to the player

复制代码

Entities

模型:
[all] %*entity types% [(in|of) [world[s]] %worlds%]
[all] entities of type[s] %entity types% [(in|of) [world[s]] %worlds%]
[all] %*entity types% (within|[with]in radius) %number% [(block[s]|met(er|re)[s])] (of|around) %location%
[all] entities of type[s] %entity types% in radius %number% (of|around) %location%
加入的版本:
1.2.1
在所有世界/单个世界/半径中的所有实体,如. 'all players', 'all creepers in the player's world', 或 'players in radius 100 of the player'.
示例:
kill all creepers in the player's world
send "Psst!" to all players witin 100 meters of the player
give a diamond to all ops
heal all tamed wolves in radius 2000 around {town center}

复制代码

Experience

模型:
[the] [(spawned|dropped)] [e]xp[erience] [orb[s]]
加入的版本:
2.1
在一个经验生成事件中生成的经验数量，可以被修改
示例:
on experience spawn:
add 5 to the spawned experience

复制代码

Facing

模型:
[the] [horizontal] facing of %living entities/blocks%
%living entities/blocks%'[s] [horizontal] facing
加入的版本:
1.4
实体或方块面朝的方向
示例:
# makes a bridge
loop blocks from the block below the player in the horizontal facing of the player:
set block to cobblestone

复制代码

Food Level

模型:
[the] (food|hunger)[[ ](level|met(er|re)|bar)] [of %player%]
%player%'[s] (food|hunger)[[ ](level|met(er|re)|bar)]
加入的版本:
1.0
玩家的饥饿值0-10 别名—— food/hunger level/meter/bar.
示例:
set the player's food level to 10

复制代码

Former/Future State

模型:
[the] (former|past|old) [state] [of] %~object%
%~object% before [the event]
[the] (future|to-be|new) [state] [of] %~object%
%~object%(-to-be| after[(wards| the event)])
加入的版本:
1.1
什么鬼？last？
''
Represents the value of an expression before an event happened or the value it will have directly after the event, e.g. the old or new level respectively in a level change event.
Note: The past, future and present states of an expression are sometimes called 'time states' of an expression.
Note 2: If you don't specify whether to use the past or future state of an expression that has different values, its default value will be used which is usually the value after the event.''
示例:
on teleport:
former world was "world_nether" # or 'world was'
world will be "world" # or 'world after the event is'
on tool change:
past tool is an axe
the tool after the event will be air
on weather change:
set {weather.%world%.old} to past weather
set {weather.%world%.current} to the new weather

复制代码

Furnace Slot

模型:
[the] (ore|fuel|result)[s] [slot[s]] of %blocks%
%blocks%'[s] (ore|fuel|result)[s] [slot[s]]
加入的版本:
1.0
熔炉的一个槽位
示例:
set the fuel slot of the clicked block to a lava bucket
set the block's ore slot to 64 iron ore
give the result of the block to the player
clear the result slot of the block

复制代码

Game Mode

模型:
[the] game[ ]mode of %players%
%players%'[s] game[ ]mode
加入的版本:
1.0
游戏模式
示例:
player's gamemode is survival
set the player's gamemode to creative

复制代码

Hash

模型:
[md5][( |-)hash(ed|[( |-)]code] of) %texts%
加入的版本:
2.0
''Hashes the given text using the MD5 algorithm. This is useful for storing passwords or IP addresses without having to store them literally.
Please note that an MD5 hash is irreversible, i.e. you won't be able to get the original text back (which is the point of storing passwords like this). Brute force and rainbow table attacks can still be performed on hashes though which can easily crack short or insecure passwords.''
示例:
command /setpass <text>:
trigger:
set {password.%player%} to hashed text-argument
command /login <text>:
trigger:
{password.%player%} is hashed text-argument:
message "login successful."
else:
message "wrong password!"

复制代码

Head location

模型:
[the] (head|eye[s]) [location[s]] of %living entities%
%living entities%'[s] (head|eye[s]) [location[s]]
加入的版本:
2.0
实体头颅的坐标
只对两个及以上高的实体有用如 players, endermen, zombies, skeletons, etc.,但以下没用 sheep, pigs or cows.
示例:
set the block at the player's head to air
set the block in front of the player's eyes to glass
loop blocks in front of the player's head:

复制代码

Health

模型:
[the] health of %living entities%
%living entities%'[s] health
加入的版本:
1.0
实体的血量
示例:
message "You have %health% HP left."

复制代码

模型:
[the] id[s] of %item type%
%item type%'[s] id[s]
加入的版本:
1.0
一个物品的ID，你不需要这个表达式因为你可以使用别称
示例:
message "the ID of %type of the clicked block% is %id of the clicked block%."

复制代码

Index Of

模型:
[the] [(first|last)] index of %text% in %text%
加入的版本:
2.1
''The first of last index of a character (or text) in a text, or -1 if it doesn't occur in the text. Indices range from 1 to the length of the text.''
示例:
set {_@} to the first index of "@" in the text argument
if {_s} contains "abc":
set {_s} to the first (index of "abc" in {_s} + 3) characters of {_s} # removes everything after the first "abc" from {_s}

复制代码

Inventory

模型:
[the] inventor(y|ies) of %inventoryholders%
%inventoryholders%'[s] inventor(y|ies)
加入的版本:
1.0
一个方块或玩家的物品栏
示例:
add a plank to the player's inventory
clear the player's inventory
remove 5 wool from the inventory of the clicked block

复制代码

模型:
IP[s][( |-)address[es]] of %players%
%players%'[s] IP[s][( |-)address[es]]
加入的版本:
1.4
玩家的IP
示例:
IP-ban the player # is equal to the next line
ban the IP-address of the player
broadcast "Banned the IP %IP of player%"

复制代码

Item

模型:
[the] item
加入的版本:
unknown
事件中的物品
示例:
on dispense:
item is a clock
set the time to 6:00

复制代码

Items

模型:
[(all|every)] item(s|[ ]types)
items of type[s] %item types%
[(all|every)] block(s|[ ]types)
blocks of type[s] %item types%
加入的版本:
unknown
特殊类型的物品或方块，经常用于循环
示例:
loop items of type ore and log:
block contains loop-item
message "There's at least one %loop-item% in this block"
stop loop
drop all blocks at the player # drops one of every block at the player

复制代码

Items In

模型:
[all] items (inventor(y|ies)) %inventories%
加入的版本:
2.0
物品栏内的物品，经常用于循环
请注意不会记录他们的位置
示例:
loop all items in the player's inventory:
loop-item is enchanted
remove loop-item from the player
set {inventory.%player%::*} to items in the player's inventory

复制代码

Join & Split

模型:
(concat[enate]|join) %texts% [(with|using|by) [[the] delimiter] %text%]
split %text% (at|using|by) [[the] delimiter] %text%
%text% [split] (at|using|by) [[the] delimiter] %text%
加入的版本:
2.1
''Joins several texts with a common delimiter (e.g. ", "), or splits a text into multiple texts at a given delimiter.''
示例:
message "Online players: %join all players with " | "%" # %all players% would use the default "x, y, and z"
set {_s::} to the string argument split at ","

复制代码

Last Spawned/Shot Entity

模型:
[the] [last[ly]] (spawned|shot) %*entity type%
加入的版本:
1.3 (spawned entity), 2.0 (shot entity)
最近生成的实体
示例:
spawn a priest
set {%spawned priest%.healer} to true
shoot an arrow from the last spawned entity
ignite the shot projectile

复制代码

Length

模型:
[the] length of %texts%
%texts%'[s] length
加入的版本:
2.1
文本的长度
示例:
set {_l} to length of the string argument

复制代码

Level

模型:
[the] level of %players%
%players%'[s] level
加入的版本:
unknown
玩家的等级
示例:
reduce the victim's level by 1
set the player's level to 0

复制代码

Level Progress

模型:
[the] level progress of %players%
%players%'[s] level progress
加入的版本:
2.0
升到下一级还有的百分比[0-1]
改变这个值会使玩家的等级发生改变
示例:
# use the exp bar as mana
on rightclick with a blaze rod:
player's level progress is larger than 0.2
shoot a fireball from the player
reduce the player's level progress by 0.2
every 2 seconds:
loop all players:
level progress of loop-player is smaller than 0.9:
increase level progress of the loop-player by 0.1
else:
set level progress of the loop-player to 0.99
on xp spawn:
cancel event

复制代码

Light Level

模型:
[(sky|sun|block)[ ]]light[ ]level [(of|%direction%) %location%]
加入的版本:
1.3.4
光亮等级 0-14
示例:
# set vampire players standing in bright sunlight on fire
every 5 seconds:
loop all players:
{vampire.%loop-player%} is true
sunlight level at the loop-player is greater than 10
ignite the loop-player for 5 seconds

复制代码

Location

模型:
[the] [event-](location|position)
[the] (location|position) %direction% [%location%]
加入的版本:
2.0
事件发生的坐标
示例:
drop 5 apples at the event-location # exactly the same as writing 'drop 5 apples'
set {_loc} to the location 1 meter above the player

复制代码

Location At

模型:
[the] (location|position) [at] [(][x[ ][=[ ]]]%number%, [y[ ][=[ ]]]%number%, [and] [z[ ][=[ ]]]%number%[)] [[(in|of) [[the] world]] %world%]
加入的版本:
2.0
从三个坐标和世界来创建一个坐标位置
这个表达式可能不能正确使用
示例:
set {_loc} to the location at arg-1, arg-2, arg-3 of the world arg-4
distance between the player and the location (0, 0, 0) is less than 200

复制代码

Location Of

模型:
(location|position) of %location%
%location%'[s] (location|position)
加入的版本:
unknown
玩家或方块的位置，如果是实体的话是实体的脚的位置
示例:
set {home.%player%} to the location of the player
message "Your home was set to %player's location% in %player's world%."

复制代码

Loop value

模型:
[the] loop-<.+>
加入的版本:
1.0
当前的循环值
示例:
# countdown:
loop 10 times:
message "%11 - loop-number%"
wait a second
# generate a 10x10 floor made of randomly coloured wool below the player:
loop blocks from the block below the player to the block 10 east of the block below the player:
loop blocks from the loop-block to the block 10 north of the loop-block:
set loop-block-2 to any wool

复制代码

Lore

模型:
[the] line %number% of [the] lore of [%item stack/item type%]
[the] line %number% of %item stack/item type%'[s] lore
[the] %number%(st|nd|rd|th) line of [the] lore of [%item stack/item type%]
[the] %number%(st|nd|rd|th) line of %item stack/item type%'[s] lore
加入的版本:
2.1
一个物品的Lore
示例:
set the 1st line of the item's lore to "<orange>Excalibur 2.0"

复制代码

Max Health

模型:
[the] max[imum] health of %living entities%
%living entities%'[s] max[imum] health
加入的版本:
2.0
一个实体最大的生命值
示例:
on join:
set the maximum health of the player to 100
spawn a giant
set the last spawned entity's max health to 1000

复制代码

Maximum Stack Size

模型:
[the] max[imum] stack[[ ]size] of %item stack%
%item stack%'[s] max[imum] stack[[ ]size]
加入的版本:
2.1
一个物品最大的堆叠值
示例:
send "You can only pick up %max stack size of player's tool% of %type of (player's tool)%" to player

复制代码

模型:
me
my[self]
加入的版本:
2.1.1
只能在效果命令中使用
示例:
!heal me
!kick myself
!give a diamond axe to me

复制代码

Message

模型:
[the] [chat( |-)]message
[the] (join|log[ ]in)( |-)message
[the] (quit|leave|log[ ]out|kick)( |-)message
[the] death( |-)message
加入的版本:
消息
示例:
on chat:
player has permission "admin"
set message to "<red>%message%"
on first join:
set join message to "Welcome %player% to our awesome server!"
on join:
player has played before
set join message to "Welcome back, %player%!"
on quit:
set quit message to "%player% left this awesome server!"
on death:
set the death message to "%player% died!"

复制代码

Money

模型:
cannot be used directly
加入的版本:
2.0
检测玩家拥有多少钱
需要Vault和一个经济插件
示例:
message "You have %player's money%" # the currency name will be added automatically
remove 20$ from the player's balance # replace '
Name / Display Name
[code]模型:
[the] (player|tab)[ ]list name[s] of %players%
%players%'[s] (player|tab)[ ]list name[s]
[the] (display|nick|chat)[ ]name[s] of %slots/item stacks/living entities/players%
%slots/item stacks/living entities/players%'[s] (display|nick|chat)[ ]name[s]
[the] name[s] of %slots/item stacks/living entities/players%
%slots/item stacks/living entities/players%'[s] name[s]
加入的版本:
玩家名/物品/实体名
示例:
on join:
player has permission "name.red"
set the player's display name to "<red>[admin]<gold>%name of player%"
set the player's tablist name to "<green>%name of player%"
set the name of the player's tool to "Legendary Sword of Awesomeness"

复制代码

Named Item

模型:
%item types% (named|with name[s]) %text%
加入的版本:
2.0
当前物品的名字，你可以这样改变set name of <item> to <text>.
示例:
give a diamond sword of sharpness 100 named "<gold>Excalibur" to the player
set tool of player to the player's tool named "<gold>Wand"
set the name of the player's tool to "<gold>Wand"

复制代码

Now

模型:
now
加入的版本:
1.4
当前系统时间
示例:
broadcast "Current server time: %now%"

复制代码

Numbers

模型:
[(integers) (between|from) %number% (and|to) %number%
%number% times
加入的版本:
1.4.6
两个数字之间的数字,经常用于循环
示例:
loop 5 times: # loops 1, 2, 3, 4, 5
loop numbers from 2.5 to 5.5: # loops 2.5, 3.5, 4.5, 5.5
loop integers from 2.9 to 5.1: # same as '3 to 5', i.e. loops 3, 4, 5

复制代码

Parse

模型:
%text% parsed as (%*type%|"<.*>")
加入的版本:
2.0
''Parses text as a given type, or as a given pattern.
This expression can be used in two different ways: One which parses the entire text as a single instance of a type, e.g. as a number, and one that parses the text according to a pattern.
If the given text could not be parsed, this expression will return nothing and the parse error will be set if some information is available.
Some notes about parsing with a pattern:
- The pattern must be a Skript pattern, e.g. percent signs are used to define where to parse which types, e.g. put a %number% or %items% in the pattern if you expect a number or some items there.
- You have to save the expression's value in a list variable, e.g. set {parsed::*} to message parsed as "...".
- The list variable will contain the parsed values from all %types% in the pattern in order. If a type was plural, e.g. %items%, the variable's value at the respective index will be a list variable, e.g. the values will be stored in {parsed::1::*}, not {parsed::1}.''
示例:
set {var} to line 1 parsed as number
on chat:
set {var::*} to message parsed as "buying %items% for %money%"
if parse error is set:
message "%parse error%"
else if {var::*} is set:
cancel event
remove {var::2} from the player's balance
give {var::1::*} to the player

复制代码

Parse Error

模型:
[the] [last] [parse] error
加入的版本:
2.0
导致最后一个解析操作失败的错误，如果使用了模式，而模式与所提供的文本不匹配，这可能无法设置。
示例:
set {var} to line 1 parsed as integer
if {var} is not set:
parse error is set:
message "<red>Line 1 is invalid: %last parse error%"
else:
message "<red>Please put an integer on line 1!"

复制代码

Passenger

模型:
[the] passenger[s] of %entities%
%entities%'[s] passenger[s]
加入的版本:
2.0
一个载具的乘客
示例:
passenger of the minecart is a creeper or a cow
the saddled pig's passenger is a player

复制代码

Prefix/Suffix

模型:
cannot be used directly
加入的版本:
2.0
聊天插件中的前缀和后缀
示例:
on chat:
cancel event
broadcast "%player's prefix%%player's display name%%player's suffix%: %message%" to the player's world
set the player's prefix to "[<red>Admin<reset>] "

复制代码

Random
模型:
[a] random %*type% [out] of %objects%
加入的版本:
1.4.9
随机
示例:
give a diamond to a random player out of all players
give a random item out of all items to the player
Random Number
模型:
[a] random (integer|number) (from|between) %number% (to|and) %number%
加入的版本:
1.4
A random number or integer between two given numbers. Use 'number' if you want any number with decimal parts, or use use 'integer' if you only want whole numbers.
Please note that the order of the numbers doesn't matter, i.e. random number between 2 and 1 will work as well as random number between 1 and 2.
示例:
set the player's health to a random number between 5 and 10
send "You rolled a %random integer from 1 to 6%!" to the player[/code]
Region

模型:
cannot be used directly
加入的版本:
2.1
区域，需要一个区域插件
示例:
on region enter:
region is {forbidden region}
cancel the event

复制代码

Region Members & Owners

模型:
cannot be used directly
加入的版本:
2.1
区域成员/主人
示例:
on entering of a region:
message "You're entering %region% whose owners are %owners of region%".

复制代码

Regions At

模型:
cannot be used directly
加入的版本:
2.1
区域的位置
示例:
On click on a sign:
line 1 of the clicked block is "[region info]"
set {_regions::*} to regions at the clicked block
if {_regions::*} is empty:
message "No regions exist at this sign."
else:
message "Regions containing this sign: <gold>%{_regions::*}%<r>."

复制代码

Remaining Air

模型:
[the] remaining air of %living entities%
%living entities%'[s] remaining air
加入的版本:
unknown
剩余的氧气值
示例:
player's remaining air is less than 3 seconds:
send "hurry, get to the surface!" to the player

复制代码

Rounding

模型:
floor(%number%)
[(a|the)] round[ed] down %number%
round(%number%)
[(a|the)] round[ed] %number%
ceil[ing](%number%)
[(a|the)] round[ed] up %number%
加入的版本:
2.0
''Rounds numbers normally, up (ceiling) or down (floor) respectively.''
示例:
set {var} to rounded health of player
set line 1 of the block to round(1.5 * player's level)
set {_x} to floor({_y}) - ceil({_x})
add rounded down argument to the player's health

复制代码

Script Name

模型:
[the] script[['s] name]
加入的版本:
2.0
当前脚本的名字
示例:
on script load:
set {running.%script%} to true
on script unload:
set {running.%script%} to false

复制代码

Shooter

模型:
[the] shooter [of %projectile%]
加入的版本:
1.3.7
弹射物的发射者
示例:
shooter is a skeleton
add 1 to {game.points.%shooter of {game.ball}%}

复制代码

Sign Text

模型:
[the] line %number% [of %block%]
[the] (1st|first|2nd|second|3rd|third|4th|fourth) line [of %block%]
加入的版本:
1.3
牌子的一行字，最大一行16字符
示例:
on rightclick on sign:
line 2 of the clicked block is "[Heal]":
heal the player
set line 3 to "%player%"

复制代码

Skull

模型:
[the] skull of %offline players/entities/entity types%
%offline players/entities/entity types%'[s] skull
加入的版本:
2.0
获取玩家或实体的头颅
示例:
give the victim's skull to the attacker
set the block at the entity to the entity's skull

复制代码

Spawn

模型:
[the] spawn[s] [(point|location)[s]] [of %worlds%]
%worlds%'[s] spawn[s] [(point|location)[s]]
加入的版本:
1.4.2
世界的重生点
示例:
teleport all players to spawn
set the spawn point of "world" to the player's location

复制代码

Speed

模型:
[the] (walk[ing]|fl(y[ing]|ight))[( |-])speed of %players%
%players%'[s] (walk[ing]|fl(y[ing]|ight))[( |-])speed
加入的版本:
unknown
玩家的走路和飞行速度
示例:
set the player's walk speed to 1
increase the argument's fly speed by 0.1
set the walk speed of the player to 0-(the player's walk speed) # reverses the player's speed

复制代码

Subtext

模型:
[the] [(part|sub[ ](text|string)) of %texts% (between|from) (ind(ex|ices)|character[s])] %number% [(and|to) (index|character)] %number%
[the] (first|last) [%number%] character[s] of %texts%
[the] %number% (first|last) characters of %texts%
加入的版本:
2.1
一个文本的剩余部分
示例:
set {_s} to the first 5 characters of the text argument
message "%subtext of {_s} from characters 2 to (the length of {_s} - 1)%" # removes the first and last character from {_s} and sends it to the player or console

复制代码

Target

模型:
[the] target[[ed] %*entity type%] [of %living entities%]
%living entities%'[s] target[[ed] %*entity type%]
加入的版本:
unknown
玩家鼠标指针指向的实体，怪物跟随的实体
示例:
on entity target:
entity's target is a player
send "You're being followed by an %entity%!" to target of entity

复制代码

Targeted Block

模型:
[the] target[ed] block[s] [of %players%]
%players%'[s] target[ed] block[s]
[the] actual[ly] target[ed] block[s] [of %players%]
%players%'[s] actual[ly] target[ed] block[s]
加入的版本:
1.0
玩家指针指向的方块
示例:
# A command to set the block a player looks at to a specific type:
command /setblock <material>:
trigger:
set targeted block to argument

复制代码

Time

模型:
[the] time [(in|of) %worlds%]
%worlds%'[s] time
加入的版本:
1.0
一个世界的时间
示例:
time in world is between 18:00 and 6:00:
broadcast "It's night-time, watch out for monsters!"

复制代码

Tool

模型:
[the] (tool|held item|weapon) [of %living entities%]
%living entities%'[s] (tool|held item|weapon)
加入的版本:
1.0
实体正在持有的工具，可以是怪物
示例:
player is holding a pickaxe
# is the same as
player's tool is a pickaxe

复制代码

Type of

模型:
[the] type of %entity types/item stacks%
%entity types/item stacks%'[s] type
加入的版本:
1.4
方块物品实体的类型物品只会有ID 实体只有类型如 'wolf' or 'player'.
示例:
on rightclick on an entity:
message "This is a %type of clicked entity%!"

复制代码

UUID

模型:
[the] UUID of %players/worlds%
%players/worlds%'[s] UUID
加入的版本:
2.1.2
世界或玩家的UUID
示例:
# prevents people from joining the server if they use the name of a player
# who has played on this server at least once 加入的版本 this script has been added
on login:
{uuids.%name of player%} exists:
{uuids.%name of player%} is not UUID of player
kick player due to "Someone with your name has played on this server before"
else:
set {uuids.%name of player%} to UUID of player

复制代码

Vehicle

模型:
[the] vehicle[s] of %entities%
%entities%'[s] vehicle[s]
加入的版本:
2.0
载具
示例:
vehicle of the player is a minecart

复制代码

Version

模型:
([craft]bukkit|minecraft|skript)( |-)version
加入的版本:
2.0
服务器 MC 插件的版本
示例:
message "This server is running Minecraft %minecraft version% on Bukkit %bukkit version%"
message "This server is powered by Skript %skript version%"

复制代码

Weather

模型:
[the] weather [(in|of) %worlds%]
%worlds%'[s] weather
加入的版本:
1.0
当前世界的天气
示例:
set weather to clear
weather in "world" is rainy

复制代码

World

模型:
[the] world [of %entity/location%]
%entity/location%'[s] world
加入的版本:
1.0
事件发生的世界
示例:
world is "world_nether"
teleport the player to the world's spawn
set the weather in the player's world to rain

复制代码

Worlds

模型:
[(the|all)] worlds
加入的版本:
1.0
服务器所有世界
示例:
loop all worlds:
broadcast "You're in %loop-world%" to loop-world

复制代码

X of Item

模型:
%number% of %item stacks/entity type%
加入的版本:
1.2
定义物品的数量
示例:
give level of player of pickaxes to the player

复制代码

Yaw / Pitch

模型:
[the] (yaw|pitch) of %locations%
%locations%'[s] (yaw|pitch)
加入的版本:
2.0
仰角朝向
示例:
log "%player%: %location of player%, %player's yaw%, %player's pitch%" to "playerlocs.log"

复制代码

循环

命令

创建Skript自定义命令并不难，但是Skript不适合创建其他已有插件命令，请创造全新的指令。
自定义指令基础语法如下

command /commandname <arguments>: # arguments are explained below
description: A description of what this command does
usage: How to use the command, e.g. /commandname <arguments> # If omitted this defaults to something similar to how the command was defined above.
permission: required.permission.to.use.this.command # If omitted this command can be used by everyone regardless of permissions.
permission message: Message to send if the player doesn't have the required permission to use this command # If omitted this defaults to "You don't have the required permission to use this
command"
executable by: players/console/players and console # If omitted this command can be executed by players and the console.
aliases: /c, /comname. # a list of aliases of the command which are usually abbreviations of the command
trigger:
put conditions and effects here that will be checked/executed when the command is used.
解：
command /XXXXXX 参数[可选]:
描述:
如何使用:
权限:
没有权限是显示的信息:
可以被XX执行:
别名:
触发器:

复制代码

命令的参数是这样的<argtype> 或这样的 <argtype = 默认值>, <item> or <item=water bucket>。
默认值也可以是一个表达式'' in which case it has to be put into percent signs: <item=%tool%>.''
参数也可以用文字表示，如：

command /give <items> to <player>:

复制代码

这个指令的格式为 /give a diamond to Njol.
你可以将可选参数用[ ]扩起，如在某半径内寻找某种怪物类型——

command /find <entity type> [in radius <integer=100>]

复制代码

.
这样的命令可以这样用 /find creepers or /find zombies in radius 20, where the radius will default to 100 if omitted.
这是一个简单的自定义指令的例子:
#获取手中物品的ID

command /id <item=%tool%>:
description: Find the ID of the item you're holding, or any given one.
usage: /id [type]
executable by: players
trigger:
message "The ID of %arg 1% is %id of arg 1%"

复制代码

自定义命令可以写在脚本的任何地方——命令不需要事件。
如果一个命令与一些触发器有关，我建议把命令和触发器放到同一文件，否则就可以把它放到任何文件中。
你可以写一个包含所有指令的大脚本，或给每个指令单独的脚本。
下面是生成一个可以用金粒换治疗的自定义命令:

command /healer:
permission: healer.create
description: spawns a healer villager which can heal players
trigger:
spawn a priest
set {healers::%spawned villager%} to true
set the name of the spawned villager to "Healer"
on rightclick on a priest:
player has permission "healer.use"
player is holding a gold ingot
{healers::%clicked villager%} is true
player's health is below 10
heal the player by 5 hearts
remove 1 gold ingot from the player

复制代码

2016-08-19 11:42:00

cc7w

本帖最后由 1345979462 于 2016-8-20 14:35 编辑

类型

这里是Skript使用的类型.类型是一种物体，如玩家数字文本。
许多类型如果作为命令参数时可以使用<type> 如<number>，并且几乎所有的类型都可以作为循环特殊值 loop-type 如 loop-block。
类型名字列出了每个类型的名字。
上面列出的用于每个类型的模式的参数描述了如何在脚本中定义类型的实例, 如如何正确的包括文本或如何写一个数字。
类型参数通常不包括表示类型实例的任何表达式,如方块不能在脚本中被定义，但你可以使用表达式去获取。
Biome

类型参数:
swampland, forest, taiga, desert, plains, hell, sky, ocean, river, extreme hills, frozen ocean, frozen river, ice plains, ice mountains, mushroom island, mushroom shore, beach, desert hills, forest hills, taiga hills, small mountains, jungle, jungle hills
类型名字:
biome[s]
加入的版本:
1.4.4
构成世界的生物群戏
示例:
biome at the player is desert

复制代码

Block

类型参数:
不能在脚本中使用
类型名字:
block[s]
加入的版本:
1.0
世界中的一个方块，经常包括位置类型，同时也拥有一个朝向，内容物或其他配置。

复制代码

Boolean

类型参数:
true/yes/on or false/no/off
类型名字:
boolean[s]
加入的版本:
1.0
信标
示例:
set {config.%player%.use mod} to false

复制代码

Chunk

类型参数:
不能在脚本中使用
类型名字:
chunk[s]
加入的版本:
2.0
区块

复制代码

Colour

类型参数:
black, dark grey/dark gray, grey/light grey/gray/light gray/silver, white, blue/dark blue, cyan/aqua/dark cyan/dark aqua, light blue/light cyan/light aqua, green/dark green, light green/lime/lime green, yellow/light yellow, orange/gold/dark yellow, red/dark red, pink/light red, purple/dark purple, magenta/light purple, brown/indigo
类型名字:
colo[u]r[s]
加入的版本:
unknown
羊毛染料和聊天颜色。
请注意，相同的颜色适用于聊天和羊毛，所以你可以使用任何颜色来彩色聊天,如 message "<%colour of sheep%>this colour"
但Minecraft中两者还是有些许的不停，最大的差异是聊天中没有棕色，所以这里有另一种蓝色代替 'brown' 和 'indigo' 是相同的颜色。
示例:
color of the sheep is red or black
set the colour of the block to green
message "You're holding a <%color of tool%>%color of tool%<reset> wool block"

复制代码

Command Sender

类型参数:
use the console for the console
see player for players.
类型名字:
[command[s]][ ](sender|executor)[s]
加入的版本:
1.0
玩家或控制台
示例:
on command /pm:
command sender is not the console
chance of 10%
give coal to the player
message "You got a piece of coal for sending that PM!"

复制代码

Damage Cause

类型参数:
contact, attack, projectile, suffocation, fall, fire, burning, melting, lava, drowning, block explosion, entity explosion, void, lightning, suicide, starvation, poison, potion, wither, falling block, thorns, unknown
类型名字:
damage cause[s]
加入的版本:
2.0
伤害的来源
请注意有时这些不是很准确，如岩浆火焰燃烧, 同时弹射物和攻击也要考虑不同类型

复制代码

Date

类型参数:
不能在脚本中使用
类型名字:
date[s]
加入的版本:
1.4
真实世界的时间
示例:
set {_yesterday} to now
subtract a day from {_yesterday}
# now {_yesterday} represents the date 24 hours before now

复制代码

Direction
类型参数:

see direction (expression)
类型名字:
direction[s]
加入的版本:
2.0
一个方向,如 north, east, behind, 5 south east, 1.3 meters to the right, etc.
一些方块同样有方向，然并没有文本
请注意有些方向在更新时被更改，请最好不要使用为指令参数
示例:
set the block below the victim to a chest
loop blocks from the block infront of the player to the block 10 below the player:
set the block behind the loop-block to water

复制代码

Enchantment

类型参数:
protection, respiration, punch, projectile protection, smite, fortune, infinity, feather falling, flame, knockback, sharpness, aqua affinity, looting, fire aspect, silk touch, blast protection, power, thorns, efficiency, fire protection, bane of arthropods, unbreaking, luck of the sea, lure
类型名字:
enchantment[s]
加入的版本:
1.4.6
附魔类型

复制代码

Enchantment Type

类型参数:
<enchantment> [<level>]
类型名字:
enchant(ing|ment) type[s]
加入的版本:
1.4.6
附魔类型+等级如 'sharpness 2' or 'fortune'.
示例:
enchant the player's tool with sharpness 5
helmet is enchanted with waterbreathing

复制代码

Entity

类型参数:
player, op, wolf, tamed ocelot, powered creeper, zombie, unsaddled pig, fireball, arrow, dropped item, item frame, etc.
类型名字:
entit(y|ies)
加入的版本:
1.0
实体
示例:
entity is a zombie or creeper
player is an op
projectile is an arrow
shoot a fireball from the player

复制代码

Entity Type

类型参数:
请等待作者更新，这里是空的
类型名字:
entity[ ]type[s]
加入的版本:
1.3
实体的类型
示例:
victim is a cow
spawn a creeper
targeted entity is an enderman holding a rose
spawn 10 red, green or blue sheep
spawn a falling anvil 4 meters above the player
kill all skeleton horses in all worlds

复制代码

Entity Type with Amount

类型参数:
<number> <entity type>
类型名字:
cannot be used directly
加入的版本:
1.3
算上数量的实体类型, 如 '2 zombies'.未来将被移除
示例:
spawn 5 creepers behind the player

复制代码

Experience

类型参数:
[<number>] ([e]xp|experience)
类型名字:
cannot be used directly
加入的版本:
2.0
经验点数
示例:
give 10 xp to the player

复制代码

Game Mode

类型参数:
creative/survival/adventure
类型名字:
game[ ]mode[s]
加入的版本:
1.0
游戏模式
示例:
player's gamemode is survival
set the player argument's game mode to creative

复制代码

Inventory

类型参数:
不能在脚本中使用
类型名字:
inventor(y|ies)
加入的版本:
1.0
物品栏.

复制代码

Inventory Slot

类型参数:
不能在脚本中使用
类型名字:
[inventory ]slot[s]
加入的版本:
unknown
物品栏的槽位。值得注意的是装备槽和熔炉槽。
区分一个槽位最正确且重要的方式是看它能否被切换的能力。
如，它能否被设置，删除，附魔等。
(一些表达式也能如此改变,如变量储存的物品。对于变量，只有当变量被设置时，它们所表示的项目才是它们所代表的项目).
请注意，工具也占一个槽位，但它实际上可以改变它的位置，即它可以表示不同的槽位。
示例:
set tool of player to dirt
delete helmet of the victim
set the colour of the player's tool to green
enchant the player's chestplate with projectile protection 5

复制代码

Item / Material

类型参数:
[<number> [of]] <alias> [of <enchantment> <level>], <alias> 必须是表示一个项目的别名 (不能像后面的常规名 'sword' / 'plant')
类型名字:
item
material
加入的版本:
1.0
一个物品。不同于项目类型的一个项目只能代表一个项目 (如 an upside-down cobblestone stair facing west), 一个项目类型可以代表一个项目的整个范围(如 any cobble stone stairs regardless of direction).
除了当你想做一个只接受一个确切项目的指令时，你通常不需要这种类型。
请注意当前的material是精确的物品，不能有数量/附魔
示例:
set {_item} to type of the targeted block
{_item} is a torch

复制代码

Item Type

类型参数:
[<number> [of]] [all/every] <alias> [of <enchantment> [<level>] [,/and <more enchantments...>]]
类型名字:
item[ ]type[s]
items
materials
加入的版本:
1.0
同上，但可以有附魔和数量
示例:
give 4 torches to the player
add all slabs to the inventory of the block
player's tool is a diamond sword of sharpness
remove a pickaxes of fortune 4 from {stored items::*}
set {_item} to 10 of every upside-down stair
block is dirt or farmland

复制代码

Living Entity

类型参数:
见实体类型
类型名字:
living[ ]entit(y|ies)
加入的版本:
1.0
一个存活的实体
示例:
spawn 5 powered creepers
shoot a zombie from the creeper

复制代码

Location

类型参数:
See location at (expression)
类型名字:
location[s]
加入的版本:
1.0
世界的一个位置，当你传送时你会保持原来的仰角和方向，你可以手动设置。

复制代码

Money

类型参数:
<number> $ or $ <number>, where '
Number
[code]类型参数:
[-]###[.###] (any amount of digits; very large numbers will be truncated though)
类型名字:
num[ber][s]
加入的版本:
1.0
一个数字，如 2.5, 3, or -9812454.
请注意一些表达式只需要整数，否则会在不产生错误的情况下丢弃小数部分。
示例:
set the player's health to 5.5
set {_temp} to 2*{_temp} - 2.5

复制代码

Object

类型参数:
不能在脚本中使用
类型名字:
cannot be used directly
加入的版本:
1.0
''The supertype of all types, meaning that if %object% is used in e.g. a condition it will accept all kinds of expressions.''

复制代码

Offlineplayer

类型参数:
不能在脚本中使用
类型名字:
offline[ ]player[s]
加入的版本:
unknown
下线的玩家。用来查看更多信息，如果玩家没有在线的话，效果和条件不会工作。

复制代码

Player

类型参数:
不能在脚本中使用
类型名字:
player[s]
加入的版本:
1.0
一个玩家，一些事件取决于玩家是否在线。如果你使用仅在线玩家能使用的效果的话会报错，如打开不在线玩家的背包。
使用命令参数时，你可以使用 <player> 和 <offline player>.
第一个需要玩家在线，并且你可以输入他们名字的一部分。第二个不要求玩家在线，但你必须精确地输入名字。

复制代码

Potion Effect Type

类型参数:
speed, slowness, haste, mining fatigue, strength, instant health, instant damage, jump boost, nausea, regeneration, resistance, fire resistance, water breathing, invisibility, blindness, night vision, hunger, weakness, poison, wither
类型名字:
potion[[ ]effect][[ ]type][s]
加入的版本:
unknown
一个药水效果，如 'strength' 和 'swiftness'.
示例:
apply swiftness 5 to the player
apply potion of speed 2 to the player for 60 seconds
remove invisibility from the victim

复制代码

Projectile

类型参数:
arrow, fireball, snowball, thrown potion, etc.
类型名字:
projectile[s]
加入的版本:
1.0
一个弹射物
示例:
projectile is a snowball
shoot an arrow at speed 5 from the player

复制代码

Region

类型参数:
"region name"
类型名字:
cannot be used directly
加入的版本:
2.1
一个区域插件的区域. Skript 目前支持 WorldGuard, Factions, GriefPrevention and PreciousStones.
请注意一些区域插件不会给区域命名，一些只使用ID，另外一些区域在不同世界可以有相同的名字。这样就不会工作了。

复制代码

Text

类型参数:
simple: "..."
quotes: "...""..."
expressions: "...%expression%..."
percent signs: "...%%..."
类型名字:
(text|string)[s]
加入的版本:
1.0
它就是一个简单的文本，其中如果包含表达式会被表达式内容代替(如 %player% 会被替换成玩家名字).
因为脚本也是文本，你必须把文本放到双引号中。
请阅读文本来获得更多信息
示例:
broadcast "Hello World!"
message "Hello %player%"
message "The id of ""%type of tool%"" is %id of tool%."

复制代码

Time

类型参数:
##:##
##[:##][ ]am/pm
类型名字:
time[s]
加入的版本:
1.0
Minecraft的时间(如 0:00 to 23:59), 可以是任何世界
更多查看Date和Timespan
示例:
at 20:00:
time is 8 pm
broadcast "It's %time%"
Timeperiod
[code]类型参数:
##:## - ##:##
dusk/day/dawn/night
类型名字:
time[ ]period[s]
duration[s]
加入的版本:
1.0
时间在两者中间。它很有用，因为你可以用这个来测试在一个特定的世界是否是白天，黑夜，黄昏或黎明。
这个类型在未来会被移除因为你可以使用 'time of world is between x and y' 作为代替.

复制代码

示例:
time in world is night[/code]
Timespan

类型参数:
<number> [minecraft/mc/real/rl/irl] ticks/seconds/minutes/hours/days [[,/and] <more...>]
[###:]##:##[.####] ([hours:]minutes:seconds[.milliseconds])
类型名字:
time[ ]span[s]
加入的版本:
1.0
两个时间之间的差异,如 '10 minutes'. Timespans 经常被现实时间使用, 但也可以用在MC时间中,如 '5 minecraft days and 12 hours'.
See date and time for the other time types of Skript.
示例:
every 5 minecraft days:
wait a minecraft second and 5 ticks
every 10 mc days and 12 hours:
halt for 12.7 irl minutes, 12 hours and 120.5 seconds

复制代码

Tree Type

类型参数:
[any] <general tree/mushroom type>, e.g. tree/any jungle tree/etc.
<specific tree/mushroom species>, e.g. red mushroom/small jungle tree/big regular tree/etc.
类型名字:
tree[ ]type[s]
tree[s]
加入的版本:
unknown
树的类型，可以用在生成树中
示例:
grow any regular tree at the block
grow a huge red mushroom above the block

复制代码

Type

类型参数:
See the type name patterns of all types - including this one
类型名字:
type[s]
加入的版本:
2.0
详见本节
经常被用在表达式中，如 'event-<type>', '<type>-argument', 'loop-<type>', etc., e.g. event-world, number-argument and loop-player.
示例:
{variable} is a number # check whether the variable contains a number, e.g. -1 or 5.5
{variable} is a type # check whether the variable contains a type, e.g. number or player
{variable} is an object # will always succeed if the variable is set as everything is an object, even types.
disable PvP in the event-world
kill the loop-entity

复制代码

Visual Effect

类型参数:
ender signal, mobspawner flames, potion break, smoke, hurt, sheep eating, wolf hearts, wolf shaking, wolf smoke
类型名字:
(visual|particle) effect[s]
加入的版本:
2.1
可见效果，如粒子
示例:
show wolf hearts on the clicked wolf
play mob spawner flames at the targeted block to the player

复制代码

Weather Type

类型参数:
clear/sun/sunny, rain/rainy/raining, and thunder/thundering/thunderstorm
类型名字:
weather[ ]type[s]
weather condition[s]
weather[s]
加入的版本:
1.0
天气类型
示例:
is raining
is sunny in the player's world
message "It is %weather in the argument's world% in %world of the argument%"

复制代码

World

类型参数:
"world_name", e.g. "world"
类型名字:
world[s]
加入的版本:
1.0
服务器的一个世界。世界需要放在双引号中,如 "world_nether", 但这可能不会工作因为文本也用双引号.
示例:
broadcast "Hello!" to "world_nether"

复制代码

文本

基础文本
在脚本中使用文本非常的简单。
如，想要给玩家发送‘Hello!’你可以使用

send "Hello!" to pl ayer

复制代码

你必须在文本旁用双引号

复制代码

括起来使用文本。如果要在文本中使用双引号的话，变成这样

"" ""
"What's this ""thing"" you're talking about?"

复制代码

如果你想在文本中使用玩家名称的话，使用%player%来代替。
如 send "Hello %player%!" to player 会给作者发送 ‘Hello Njol!’ 。
类似的表达式都可以工作，如 message "The block above the block you're looking at is a %block above targeted block%".
如果你想要使用百分号的话，双写——

"100%%!"

复制代码

颜色与格式
颜色和格式在消息中可以有两个方式存在。
一是普通的 ‘&x’/‘§x’ 颜色代码
二是使用Skript的 <colour> 代码，如

broadcast "<red><bold>Important Information:<reset> <blue><u>This server needs more mods!"

复制代码

你也可以在文本中使用玩家物品的颜色，如

"<%colour of tool%>this text is coloured depending on the player's held item!"

复制代码

简单的颜色和格式如——

可用的颜色和格式
: black, dark grey/dark gray, grey/light grey/gray/light gray/silver, white, blue/dark blue, cyan/aqua/dark cyan/dark aqua, light blue/light cyan/light aqua, green/dark green, light green/lime/lime green, yellow/light yellow, orange/gold/dark yellow, red/dark red, pink/light red, purple/dark purple, magenta/light purple, brown/indigo
chat styles: bold/b, italics/italic/i, strikethrough/strike/s, underlined/underline/u, magic, reset/r

复制代码

其他语言也许可以使用其他颜色，但可用的极少。如，使用颜色方面的表达式[对颜色指令很有用]，脚本经常使用英文的颜色代码。
高级语法
Skript 2.0版本及以上可以比只把他们放到文本中更高级的使用名词——
"a %expression" 或 "an %expression"将把适合的文字放入表达式，如 “a fish”, “an apple”, 或 “a pickaxe and an emerald”.
这类似的，将允许使用 the("the %expression%"), 即使这在英语中几乎不明显，只有一些名词，如“空气”将在这种情况下的文章下完全删除。
请注意其他语言你需要使用那个语言的文章，如德语 "der %expression" or "ein %expression%" <Ref>我是来翻译英语的不是翻译德语的(╯‵□′)╯︵┻━┻</ref>
"%expression%s" 兼容 "<数字> %expression%" (数字比1大) 将会使后面的表达式使用复数。
如 "2 %block%" 会表现出 “2 logs” (数字也可以在另一个表达式使用，如 "%number-argument% %item-argument%" 会出现 “5 pickaxes” 或 “1 pickaxe”).
这个语法会在任何语言使用。
变量名
变量名与文本十分相似，不过你需要用{ }括起。

{变量}

复制代码

表达式不适用高级语法。

变量

变量是Skript储存数据的方式，所有的变量都有一个名字，一个值。
你可以把变量放在任何地方去替换一些东西，如用变量的位置来替换一个位置。
这可以用简单的家指令：做一个变量'home'，然后再输入指令时传送到这个位置。
如要使用变量，把它的名字放到{ }内，像这样: {变量名}. 变量的名字经常包含表达式，如要为所有玩家每人一个家，变量名应使用 {home.%player%} 。
当变量载入时 %player% 将会被替换成玩家名字。
所有的变量都在‘variables.csv’ 中储存，它可在插件的目录里找到。请不要自行修改文件。如果你做错了一些东西一些变量会永久失效。
变量只是会时常写入这里,所以服务器崩溃也许会是你丢失一些变量。
从 2.0 版本开始将可以允许你使用数据库，这样你就可以共享变量。
有3种类型的变量: 普通变量，本地变量和选项变量。
普通变量是独一无二的，在插件中只能有一个普通变量叫这个名字，它们在服务器重启时会被保存。
本地变量的格式是{_名字}这样的，允许不同脚本有相同名字的本地比那里，如下面的触发器:

on join:
set {_player} to player
wait a minute
message "%{_player}%" # the local variable is unchanged no matter how many players joined in the meantime

复制代码

如果是普通变量的话会把全局的player都展示出来
本地变量在没有它们的用处的时候会被自动删除，并不会使用存储器，但当服务器重启或脚本重载时本地变量会丢失。
选项变量的格式是这样的:

options:
option name = option value

复制代码

在调用选项变量的时候你可以使用 {@option name}. 这将会在触发器运行之前把变量内容完全替换为你设置的变量值。
所以你可以把任何东西放到选项变量中，甚至是脚本。不要在选项变量中使用百分号，会保留。
变量的列出
列出变量的变量是这样的

{variable name::*}

复制代码

并且可以添加元素并使用默认的添加和移除效果移除元素,当被删除时会删除所有在列表上的值。
您可以使用{variable name::index}访问变量列表的特定值：其中index是那个特定值。特定值可以是任何东西，如一个玩家的名字，数字，但当为列表增加变量时，新的特定值会变成一个数字。
变量列表可以这样被循环

{list variable::*}

复制代码

其中循环值可以使用 loop-value 特定值可以使用 loop-index.
列出变量对于在消息中展示一些列表很有用，如一些在线的管理员，首先把他们列到同一变量，然后使用列出变量。(见下方的例子).
最好是使用本地变量列表{_local list variable::*}
好吃的栗子
这里是一些栗子
检查一共有多少人登入进你的服务器过:

# if you add a 'variables:' section to your script, the variables defined there will be set to the given value if they don't exist
# when the script is loaded. You cannot change an existing variable's value this way however, in particular if you
# change the variables' values here the actual variables will not be changed at all.
variables:
{logincount} = 0
on login:
add 1 to {logincount}
command /logincount:
description: Find out how many people have ever logged into this server
trigger:
message "Since its beginnings <green>%{logincount}%<reset> people have logged into this server"

复制代码

简单的home脚本:

command /sethome:
permission: skript.home
description: Set your home
trigger:
set {home.%player%} to location of player
message "Set your home to <grey>%location of player%<reset>"
command /home:
permission: skript.home
description: Teleport yourself to your home
trigger:
if {home.%player%} is not set:
message "You have not set your home yet!"
stop trigger
teleport player to {home.%player%}

复制代码

显示在线管理员的脚本

:
command /staff:
description: Shows online staff
trigger:
loop all players:
loop-player has permission "is.staff"
add loop-player to {_online staff::*}
size of {_online staff::*} is 0:
message "No staff currently online! Happy griefing ;)!"
else:
message "Online staff: %{_online staff::*}%"

复制代码

2016-08-19 12:06:00

正义の冷子

辛苦楼主写了这么多，怪不得最近没看到人

2016-08-20 03:49:00

璇葎

没看懂。能写个关于团队战争的示范吗

2016-08-25 00:58:00

璇葎

那个登陆给蛋糕怎么换成给rpgitem道具？

2016-08-25 12:44:00

cc7w

璇葎发表于 2016-8-25 12:44
那个登陆给蛋糕怎么换成给rpgitem道具？

On first Join:
console command "rpgitem XXX give %player%"

2016-08-25 18:57:00

SYS_TEM

夭寿了，插件百科屠版翻译版了owo
Skript看起来非常有意思的样子owo
话说你是c7w？

2016-08-27 15:50:00

cc7w

SYS_TEM 发表于 2016-8-27 15:50
夭寿了，插件百科屠版翻译版了owo
Skript看起来非常有意思的样子owo
话说你是c7w？ ...

正是在下

2016-08-27 17:53:00

az860325

这个真的是不推不行！

2016-09-02 03:48:00

qaz197418i

dalao你好，我想问一下sk可以不可以使用一个命令触发，检测玩家背包中的指定自定义物品(就是添加过lore和改过彩色名字的物品)，然后收取物品后再向玩家发送另一个物品或者执行一个命令.跪求dalao帮助！

2017-07-27 17:41:00

cc7w

qaz197418i 发表于 2017-7-27 17:41
dalao你好，我想问一下sk可以不可以使用一个命令触发，检测玩家背包中的指定自定义物品(就是添加过lore和改 ...

command /haha <player>:
permission: this.is.permission
trigger:
      loop items in arg-1's inventory
      loop-item is a wool
      loop-item's name is "§7名字"
      lore 1 of loop-item is "第一行注释"
      if loop-item exists:
         remove loop-item
         give arg-1 a xxx // console command "xx"

2017-07-27 18:22:00

cc7w