跳到主要内容

Kether


介绍

Kether 是 TabooLib 框架中内置的脚本语言,由 海螺先生 创造。

可以轻松实现诸多功能(如:发送动作栏或标题信息、改变玩家游戏模式、获取变量等等), 它还拥有良好的拓展 API,能让其他开发者更加轻松地开发出自己的动作语句。

相关链接


延迟运行时间

waitTime {数字}{时间单位}

等待时间后运行下一个语句

waitTime 1s
waitTime 1m
waitTime 1h
waitTime 1d3h50m

添加标签

tags add {文本}

用于不同于权限的判断,相比之下,比权限更便利

tags add hello.world

删除标签

tags remove {文本}

用于不同于权限的判断,相比之下,比权限更便利

tags remove hello.world

是否有某标签

tags has {文本}

用于不同于权限的判断,相比之下,比权限更便利

tags has hello.world

获取数据值

storage {动作} get
storage hello.world get

设置数据值

storage {动作} set {动作}
storage hello.world set 10

移除数据值

storage {动作} remove
storage hello.world remove

选择任务

quest select {动作}
quest select test_1

接受任务

quest accept
quest select test_1 quest accept

放弃任务

quest quit
quest select test_1 quest quit

完成任务

quest finish
quest select test_1 quest finish

任务名称

quest name

获取任务的名称

quest select test_1 quest name

任务状态

quest state [lang]

如果写上lang,则返回语言内容,否则返回枚举

quest select test_1
quest state
quest state lang

任务剩余时间

quest limitTime
quest select test_1 quest limitTime

选择目标条目

target select {动作}
target select hi

目标条目进度

target schedule
target select hi target schedule

目标条目状态

target state [lang]

如果写上lang,则返回语言内容,否则返回枚举

target select hi
target state
target state lang

选择对话

dialog select {动作}
dialog select woow

发送对话

dialog send [where {位置}]
dialog select woow
dialog send
dialog send where player location

关闭对话

dialog end
dialog select woow dialog end

匹配特定物品

itemCheck inv (all/mainHand) {文本}

检查玩家库存(all)或者主手(mainHand)是否有特定的物品

itemCheck inv all "MINECRAFT -material STONE -amount 2"
itemCheck inv mainHand "MMOItEMS -id hi -amount 10
展开

物品匹配

物品匹配格式
类型 -键1 值1 -键2 值2

原版物品

MINECRAFT -键 值

原版的键值对内容列表如下

默认值
material物品材料
amount物品数量1
displayName物品显示名称
loreContains物品条目描述包含
customModelData物品自定义模型数据

例子

匹配物品材料为石头,数量为1的物品
MINECRAFT -material STONE -amount 1

MMOItems 物品

MMOITEMS -键 值
默认值
idMMOItems物品ID
amount物品数量1

例子

匹配物品ID为 hello,数量为1的物品
MMOITEMS -id hello

ItemsAdder 物品

ITEMSADDER -键 值

ItemsAdder的键值对内容列表如下

默认值
idItemsAdder物品ID
amount物品数量1

例子

匹配物品ID为 world,数量为3的物品
ITEMSADDER -id world -amount 3

匹配并取走特定物品

itemCheck take {文本}

检查并取走玩家特定的物品

itemCheck take"MINECRAFT -material STONE -amount 2"
itemCheck take "MMOItEMS -id hi -amount 10
展开

物品匹配

物品匹配格式
类型 -键1 值1 -键2 值2

原版物品

MINECRAFT -键 值

原版的键值对内容列表如下

默认值
material物品材料
amount物品数量1
displayName物品显示名称
loreContains物品条目描述包含
customModelData物品自定义模型数据

例子

匹配物品材料为石头,数量为1的物品
MINECRAFT -material STONE -amount 1

MMOItems 物品

MMOITEMS -键 值
默认值
idMMOItems物品ID
amount物品数量1

例子

匹配物品ID为 hello,数量为1的物品
MMOITEMS -id hello

ItemsAdder 物品

ITEMSADDER -键 值

ItemsAdder的键值对内容列表如下

默认值
idItemsAdder物品ID
amount物品数量1

例子

匹配物品ID为 world,数量为3的物品
ITEMSADDER -id world -amount 3

对话空间范围

spaceRange {数字/长} {数字/宽} {数字/高}

应用于对话模块空间范围 dialogID.space.condition

spaceRange 2.5 3.5 2.5

空间范围

spaceRange {数字/长} {数字/宽} {数字/高} where {位置}

应用于条件检查,比如任务要求达到目的地

spaceRange 2.5 3.5 2.5 where location world 10.5 2 88

选择导航

nav select {文本}
nav select test

创建导航

nav create target {位置}

创建目标位置的导航数据

nav select test nav create target location world 10.5 2 88

开始导航

nav set start (display {文本})

开始导航,导航粒子默认是绿色粒子,可以通过 display 设置特定粒子

nav select test
nav set start
nav set start display cloud

停止导航

nav set stop
nav select test nav set stop

清除导航数据

nav set clear
nav select test nav set clear

停止所有导航

nav stopAll

开关动态门

doors to {文本} open/close

为 BigDoors 插件提供的开关门语句

doors to d_1 open

情景放映

tutorial start {文本}

为 ServerTutorialPlus 插件提供的情景放映语句

tutorial start test

显隐玩家

hide player set {true/false}

向其他玩家隐藏或者显示玩家自己

hide player set true
hide player set false

判断位置是否在该区域

worldguard {位置} id {动作}

为 WorldGuard 插件提供的区域检查语句

worldgurad player location id ir_1