# 脚本入门

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

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


脚本文件的后缀名为 `.zs`，请确保它不是`.zs.txt`！

## 什么是脚本

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

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

### 书写你的第一个脚本

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

在 `hello.zs` 文件中写入以下内容：

```zenscript
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 文件

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

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

在上面的示例中，输出将会是：

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

### 注释

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

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

单行注释： `// 我是一条单行注释！`

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

多行注释：
```
/* 我是
一条
多行注释！ */
```

Just note, that `#` comments are also used for [PreProcessors](/zencode/Preprocessors/Preprocessors), so while they are still valid comments, they could cause unwanted side effects.

## The next step

Now you know the absolute basics of how to create scripts. Now, what you do is up to you! Feel free to browse the Docs for any pages that interest you.

However, if you're getting started, we recommend checking out the Tutorial tab, more specifically the [Crafting Table Tutorial](/tutorial/Recipes/Crafting/crafting_table) as well as the [Recipe Managers](/tutorial/Recipes/RecipeManagers) page for information on how to add and remove different kinds of recipes.
