Crafttweakerは独自のプログラミング言語Zenscriptを使用します。Zenscriptは.zsファイルから読まれ、それらは<gamedir>/scriptに保存します。

Zenscriptは"トップダウン型"のプログラミング言語です。つまり、Importをファイルの一番上に書かなければいけません。また、変数の宣言も書く必要があります。しかし、それには制限がありません。変数の宣言はどこの行でも書くことができますが、その行の前までの行では変数にアクセスすることはできません。

今までの中でModpackを作ったとき、Modをそのままインストールしただけではまとまりのあるプレイができなかった覚えはありませんか? Modはほとんどがそれぞれほぼ独自に開発されているので、他のものと比べて充実しすぎているものもあるかもしれません。 また、アイテムの作成に際してより良いレシピを思いつくかもしれません。 もしくは、あるModの特定のアイテムだけを、ModPackから除外したいと思うでしょう。 あるいは、鉱石辞書において登録されたアイテムが多すぎたり少なすぎたりする項目を見つけたりするでしょう。 CraftTweakerはこれらの思いを全て実現できます。

バニラのMinecraftをサポートするコア機能に加え、Mod固有のレシピや動作をも変更できる総合ライブラリも提供しています。

スクリプトは<minecraftdir>/scriptsに保存され、Minecraftの起動中でのPreInitializationの段階で読み込まれます。過去のCrafttweakerのバージョンとは違い、ゲーム中にスクリプトをリロードすることはできません。Mojangが1.12で行った改変によるもので、回避策はありません。 また、スクリプトはサーバーとクライアントの両方に導入する必要があります。 Also, Scripts need to be on both, the server AND the client instance to work

Script files have the .zs suffix and can be compressed into a .zip that will also be read.

スクリプトを書き始めるには、基本的な、hello.zsファイルを<minecraftdir>/scripts>に作ります。

hello.zsの中には次の文を書いてください。

ZenScript
 Copy
print("Hello world!");

そして、Minecraftを起動して、crafttweaker.logファイルを見てください。

crafttweaker.logは<minecraftdir>にあり、プレーンテキストを読めるソフトウェアで読むことができます。

スクリプトファイルを編集する際は、Notepad++もしくはSublime Textを使うのをお勧めしますが、どのソフトウェアでも読むことができます。

crafttweaker.logファイルは、ログの出力に下のような構文が使われます。

 Copy
[LOADERSTAGE][SIDE][TYPE] <message>

上記に書いた例を使うと、以下のように出力されます。

 Copy
[PREINITIALIZATION][CLIENT][INFO] Hello world!

以上の構文はデバッグの際にのみ使われ、コマンドダンプの時には使われません。その場合、メッセージのみが書かれます。これによって、ダンプされたテキストのコピーペーストが簡単にできます。

コメントは、あなたのスクリプトを読みやすく、よりわかりやすくするために使います。

ZenScriptでは3つの種類のコメントの書き方ができます。

1行コメント: // I'm a single line comment!

一行コメントの別の方法 : # I'm also a single line comment!

複数行のコメント:

 Copy
/* I'm 
a
multiline comment! */