はじめに

Crafting とは

Crafting は Minecraft Java 26.3 向けの Mod 開発プラットフォームです。独自の言語である CraftScript、または Kotlin(と Java)で、ゲームのコードに依存しない API に対して Mod を書きます。

考え方

Crafting の Mod は Minecraft を直接呼び出しません。呼び出す相手は Crafting です。「このアイテムをプレイヤーに渡して」「誰かがブロックを壊したら教えて」「この硬さでこのブロックを作って」。Crafting は、実行中のゲームのバージョンでそれぞれをどう行うかを知っています。

Minecraft の新しいバージョンが出たときに更新されるのは Crafting です。Mod は同じファイルのまま動き続けます。この約束の正確なルールは Mod は壊れない にあります。

2 つの言語、1 つの API

向いている用途
CraftScript Java を知らなくても始められ、ほとんどの Mod に使えます。コンテンツ、イベント、コマンド、ゲームロジック。保存すると再読み込みされるシンプルな .craft テキストファイルです。Mod が大きくなったときのために、型、クラス、モジュールもあります。ガイド
Kotlin 静的型と IDE の機能をフルに使う大規模な Mod や、ここにしかないもの(バックグラウンド処理と Java ライブラリ)が必要な Mod。Java も同じ API を使います。ガイド

両方を同じゲームで並べて動かせます。CraftScript で始めて、必要な部分だけを Kotlin に移すこともできます。

現在できること

バージョン
0.1.0、開発中。ソースからビルドします。
ゲーム
Minecraft Java 26.3、クライアントとマルチプレイ用サーバー。
API
アイテム、1 つ以上のドロップを持つブロック、レシピ、すべてのサーバーイベント、プレイヤー・ブロック・エンティティ、コマンドと権限、タイマー、あらゆる形のブロック、独自の行動と 3D モデルを持つカスタムモブ(自然にスポーンし、手なずけ・繁殖・騎乗ができ、飛び、撃ち、キーフレームアニメーションを使えます)、ワールドに生成される鉱石、カスタムサウンドとパーティクル、フォームと画面上の要素、ワールド、プレイヤー、セーブデータ、ファイルベースの設定、クライアントとサーバー間のネットワーク。すべて CraftScript からも Kotlin からも使えます。 エフェクト、属性、装備、防具、武器、クールダウン、エンティティのイベント、独自のキーも扱えます。
シェーダーパック
フォルダをコピーするだけでインストールできる、データとしてのシェーダーパック。シェーダーパックを参照してください。

次に読むもの

  1. ランチャーまたはサーバーに Crafting をインストールします。
  2. はじめての Mod を書き、ゲームを開かずにテストします。
  3. Mod が大きくなる前に Mod の整理 を読みましょう。