World Dimension Loader 1.4.1-beta3 - はじめてのDimensionチュートリアル（公開ベータ候補）

このチュートリアルの目的
WDLを初めて使う人向けに、既存Minecraftワールドの「コピー」を1つWDL Dimensionとして登録し、Gateを作り、WDL Igniterで開通して、そのDimensionへ入るところまで説明します。

元のワールドは別に保管し、WDLでは必ずコピーを使ってください。

同じ設定を2つの方法で作ります。
- 方法A: Workbench GUIを使う方法（初めての人におすすめ）
- 方法B: Configを直接編集する方法

どちらも次のIDを使います。
- Dimension ID: test_world_01
- Gate ID: test_world_01_gate

------------------------------------------------------------
どちらの方法でも最初にすること: ワールドのコピーを準備
------------------------------------------------------------

1. WDLを導入し、Minecraftを一度起動してWDLのConfigファイルを作成します。
2. できるだけゲーム/ワールドを終了してからファイルをコピーします。
3. 読み込みたいワールドのコピーを、Minecraftのゲームディレクトリ内の次の場所へ置きます。

WDL_custom_dimensions/test_world_01/

4. 次のファイルが、そのフォルダの直下にあることを確認します。

WDL_custom_dimensions/test_world_01/level.dat

初期状態のCommon Configでは、WDL_custom_dimensionsがDimension rootです。このチュートリアルではcommon.tomlを変更する必要はありません。

============================================================
方法A - Workbench GUIを使う（おすすめ）
============================================================

1. WDL Workbenchを開く

使用するアイテム:
worlddimensionloader:wdl_workbench

Workbenchは管理用ツールです。Creativeモードかつpermission level 2以上で使用してください。

2. Dimensionを登録する

1) Dimensionsを開きます。
2) Createを選びます。
3) source folderの選択画面を開きます。
4) test_world_01を選びます。
5) IDがtest_world_01として候補表示されていることを確認します。必要ならtest_world_01を入力します。
6) その他の項目は初期値のままにします。
7) Saveします。

最初のDimension登録はこれだけで十分です。このチュートリアルでは詳細設定ページを変更する必要はありません。

3. Gateを登録する

1) Gatesを開きます。
2) Createを選びます。
3) 行き先Dimensionとしてtest_world_01を選びます。
4) Gate IDがtest_world_01_gateになっていることを確認するか、自分で入力します。
5) その他の項目は初期値のままにします。
6) Saveします。

初期Gate設定のままでこのチュートリアルに必要な条件がそろいます。フレーム/角は黒曜石、選択したDimensionへのLIST接続、開放時間10秒、起動コストなし、通常のWDL Igniter使用可能です。

4. 実際のGateを作る

角を含め、フレーム全体を黒曜石で作ります。
内側の空間を横2ブロック x 縦3ブロックにします。

正面から見た形:

OOOO
O..O
O..O
O..O
OOOO

O = 黒曜石
. = 内側の空間

5. Gateを開通して入る

Basic Dimension Igniterを使います。
worlddimensionloader:basic_dimension_igniter

登録した条件に合う黒曜石Gateフレームに使用します。通常の起動が成功すると、Basic Dimension Igniterを1個消費します。

Gateが開いたら、その中へ入ります。

test_world_01へ入れたら、最初のWDL Dimension設定は完了です。

Basic Dimension Igniterのレシピは次を参照してください。
WDL_ITEMS_AND_RECIPES_JA_1.4.1-beta3.txt

============================================================
方法B - Configを直接編集する
============================================================

Workbenchを使わず、同じDimensionとGateをConfigから作る方法です。
手動編集の前にconfig/worlddimensionloader/をバックアップしてください。

1. 同じワールドコピーを使う

WDL_custom_dimensions/test_world_01/level.dat

2. Dimensionの最小設定を追加する

次を開きます。
config/worlddimensionloader/dimensions.toml

次を追加します。

[[dimensions]]
id = "test_world_01"

この最小設定ではidが必須です。folderを省略するとidと同じ値が使われるため、この定義では次のフォルダを読み込みます。

WDL_custom_dimensions/test_world_01/

その他のDimension設定は初期値が使われます。

3. Gateの最小設定を追加する

次を開きます。
config/worlddimensionloader/gates.toml

次を追加します。

[[gates]]
id = "test_world_01_gate"
dimensions = ["test_world_01"]

この最小設定では:
- dimensionsに行き先が入っているため、selection_mode省略時はLISTとして扱われます。
- frameとcornerは黒曜石が初期値です。
- 初期サイズ範囲には内側2 x 3が含まれます。
- 初期開放時間は10秒です。
- 起動コストはありません。
- 通常のWDL Igniterは初期状態で使用できます。

4. Configを再読込する

dimensions.tomlとgates.tomlを保存した後、次を実行します。

/wdl scan

このチュートリアルでは、代わりにゲーム/サーバーを完全に再起動しても構いません。

5. 同じGateを作って開通する

GUI方式と同じ、黒曜石・内側2 x 3のGateを作ります。Basic Dimension Igniterで開通し、Gateの中へ入ります。

test_world_01へ入れたら、Config方式も完了です。

============================================================
次に読むもの
============================================================

- Workbenchの追加設定や編集:
  WDL_GUI_GUIDE_JA_1.4.1-beta3.txt
- Configの全項目と高度な手動設定:
  WDL_CONFIG_GUIDE_JA_1.4.1-beta3.txt
- IgniterレシピとWDLアイテム:
  WDL_ITEMS_AND_RECIPES_JA_1.4.1-beta3.txt
- 高度な設定例:
  WDL_EXAMPLES_AND_PLAY_IDEAS_JA_1.4.1-beta3.txt
- Dimension/GateがREADYにならない、Gateが開かない場合:
  WDL_TROUBLESHOOTING_JA_1.4.1-beta3.txt
