VariableTriggers

本条目已有一定量的内容，但仍需完善

欢迎参与本条目的完善工作。

你可以从以下几个方面入手

• 参阅格式化手册，并对该页面进行相应格式排版工作；
• 日常检查是否内容有更新版本并更新该页面；
• 修复该页面中已出现/潜在的问题

简介

用VariableTriggers来制作你的服务器自己的插件，比如特色

这是一个强大的、拥有无限潜能的插件。创建一个触发器来当玩家点击或走过一个方块 (泥土, 门, 开关, 压力板, 火把, 任何方块)时运行一段代码，或创建类似于玩家死亡,实体死亡,破坏方块,放置方块,加入游戏,退出游戏, 重生, 互动以及生成实体的触发器同样能够运行一段代码。你还可以创建区域触发器和命令触发器。你也可以使用变量，或者包含IF和ELSE甚至嵌套的代码。你可以加入任何其他的命令并利用这些命令来传送, 生成实体, 播放粒子效果或者音乐, 放置方块, 改变方块以及获得玩家的血量等!这些脚本运行在和服务器主线程不同的线程上而防止它们发生冲突。

vault关联

关联Vault是一个可选的特性。Vault可以提供经济系统和权限系统的支持。如果Vault没有被安装，权限功能将改变为仅认超级权限。经济系统功能将会被禁用。其他功能不会被影响。

脚本方法

脚本方法用来告诉解释器你想要做的事情的主要部分。每行代码必须以一个脚本方法起头，且只能有一个。绝大多数的脚本方法使用以 [ ] 括起来的一个或更多参数。 你可以用$对象.变量, <占位符>和<含参数占位符:参数>来在脚本方法里当一个参数或组成一个参数的部分。 &颜色符号 &a-&f, &1-&9 和字体符 &l &n &o &m &r 在这个插件中同样有效，所以你可以在任何被显示的文本中使用它们。
当你使用游戏内命令来扩充一个脚本的时候，其中的某些参数是可选的，这代表你可以直接输入它或在之后点击一个地方，它会被自动输入。 [地点] 参数就是其中一个例子。你可以自行输入 x,y,z 或留空然后点击一个指定的地点。 [方块ID:meta值] 是另外一个可选的参数。如果你把它留空，它将会变成你点击的一个方块的值。
//注释。以//开头的任何话都会被无视。

聊天和信息

方法	版本	作用	格式	描述
@QUIET		让指定玩家于指定秒内不受到任何消息。	@QUIET [玩家ID] [秒数]	这在你想要显示给玩家一条消息而且不想让这条消息划出界面的时候很有用。秒数可以是小数 5.5 或者 3.6 或者干脆就是 5。
@CLEARCHAT		清空指定玩家的聊天屏幕。	@CLEARCHAT [玩家ID]
@BROADCAST		公告一条信息到全服务器。	@BROADCAST [消息]	颜色代码&a-&f, &1-&9 均可以使用。
@PLAYER		发送一条只有触发脚本的玩家看得到的消息。	@PLAYER [消息]	该消息会被发送到触发改脚本的玩家。可以使用颜色代码。
@TELL		发送一条只有指定玩家看得到的消息。	@TELL [玩家名] [消息]	颜色代码&a-&f, &1-&9 均可以使用。
@PRINT		发送消息给控制台。	@PRINT [消息]	debug用，不支持颜色代码。一般不支持中文。
@!		获得vt的信息，包括版本，是否关联vault，启动项，加载的脚本。	直接运行	作者建议制作专门的/debug命令之类的包含这个方法来更方便获取信息。

脚本方法

方法	版本	作用	格式	描述
@CALL		从一个脚本内运行另一段代码。	@CALL [文件:脚本]	文件指保存代码的文件去掉.script.yml的名字。脚本指想要运行的代码段的名字。例子：@CALL myscriptfile:spawnzombie
@EXIT		从一个脚本中退出。	直接运行
@PAUSE		暂停代码的运行。	@PAUSE [秒]	它不会阻止触发器，事件依然可以被重复触发，仅仅暂停代码继续运行。你可以使用浮点数，单位为秒。
@COOLDOWN		阻止事件的更多被重复触发。	@COOLDOWN [秒]	它和@PAUSE相反。请尝试把它写在脚本的首行以避免过多的触发造成不想要的结果或者服务器卡顿。这将会阻止任何玩家触发事件。一般来讲，它应该放置在任何@PAUSE前。
@CMD		以触发玩家的身份运行一段命令。	@CMD [命令]	命令不含斜杠。如果玩家没有权限，将会收到报错信息。例子：@CMD heal
@CMDOP		让触发玩家以自己的身份用op权限运行一段命令。	@CMDOP [命令]	这在你想让玩家避免权限限制的时候很有效。
@CMDCON		让后台运行一段命令。	@CMDCON [命令]	这当某些命令只能被后台使用的时候很有效，或者在触发玩家不确定的时候。例子：@CMDCON give <playername> dsword 1
@CANCEAL		禁用一段脚本被触发	@CANCEAL [TRUE/FALSE]	写在脚本的第一行来避免脚本被触发。

整地

方法	版本	作用	格式	描述
@SETBLOCK / @SETBLOCKSAFE		编辑指定位置的指定方块。	@SETBLOCK / @SETBLOCKSAFE [方块ID:MetaID] [位置]	@SETBLOCKSAFE设计为给spigot服务器使用，能够更好地支持。两者没有本质上的区别。
@TOGGLEBLOCK		设置指定方块的选择状态。	@TOGGLEBLOCK [方块ID:MetaID] [位置]	例子：@TOGGLEBLOCK 35:4 231,69,177
@DROPITEM		在指定位置创建一个掉落的物品。	@DROPITEM [物品名] [数量] [附魔:等级] [位置]	关于附魔名，请看这里。附魔可以是[附魔1:等级],[附魔2:等级]

链接

• 官方页面 作者 lyokofirelyte
  
• 源代码-github 作者 lyokofirelyte
  
• 点我 以募捐支持作者
  
• PlaceholderAPI - 可支持的扩展插件，能让多个插件共享其变量