CraftTweaker 是由一个叫做 ZenScript 的自定义脚本语言编写的,ZenScript 是以 .zs 类型文件保存在 <gamedir>/scripts 文件夹中的,如果你不确定文件夹在哪,在游戏中运行指令/ct scripts 然后文件夹就会打开。

ZenScript 是一种按“自上向下”顺序读取的脚本语言,这意味着导入应该位于文件的顶部,变量声明也应该出现在较靠近文件顶部的位置。当然这不是强制性的,变量虽能够在脚本的各处定义,但变量声明之前的所有行都无法访问这个变量。

Script files have the .zs suffix, make sure that it isn't .zs.txt!

Scripts 被存储在 <gamedir>/scripts 文件夹中,当玩家进入世界时会被加载,就和以前版本的 CraftTweaker(不包括1.12版) 一样 ,脚本可以被重新加载,只需要运行 /reload

加入服务器时,服务器会将它们的脚本发送给客户端,客户端会运行这些脚本。 这意味着一个没有任何脚本的客户端, 可以加入服务器并获得更改(这个特性很有用,如果您需要在服务器上禁用一个物品,但不想强迫客户端下载额外文件!)

书写你的第一个脚本

Link to 书写你的第一个脚本

要开始使用脚本,你可以创建一个很基本的文件,叫做 hello.zs 并放在 <gamedir>/scripts> 文件夹中;如果你不确定文件夹在哪,只需要运行指令/ct scripts 然后文件夹就会打开。

hello.zs 文件中写入以下内容:

ZenScript
Copy
println("Hello, world!");

现在加载Minecraft并看看<gamedir>/logs/crafttweaker.org 文件 (或运行 /ct log 在您的默认文本编辑器中打开文件)。

craftweaker.log文件位于<gamedir>/logs文件夹,并且可以通过任何能够读取纯文本的程序阅读。

It is recommended to use VSCode, Sublime Text or Notepad++ to edit script files, however any program will do.

当使用一个脚本编辑器时,注意查看可用的语法高亮模式,多数脚本编辑器带有ZenScript的语法高亮插件。

crafttweaker.log 文件

Link to crafttweakerlog-文件

crafttweaker.log 文件的输出会使用一种特殊的语法,基本的语法结构如下:

Copy
[HH:MM:SS.ms][TYPE] <message>

在上面的示例中,输出将会是:

Copy
[14:58:06.697][INFO] Hello world!

注释可以用来使你的脚本文件更易于阅读,更容易理解!

ZenScript 支持三种不同的注释书写方法,它们分别是:

单行注释: // 我是一条单行注释!

另一种单行注释 # 我也是一条单行注释!

多行注释:

Copy
/* 我是
一条
多行注释! */

Just note, that # comments are also used for PreProcessors, so while they are still valid comments, they could cause unwanted side effects.