ジェネレーターの作成

ジェネレーター

ジェネレーターはBetterStructuresの設定システムで最も強力な部分です。デフォルトでは31個のジェネレーターがあり、現在BetterStructuresによって配布されている200以上のビルドをまとめて管理しています。独自のジェネレーターを作成することもできますが、既存のジェネレーターをショートカットとして使用することもできます。

ジェネレーターはプラグインに建物が正確にどこにスポーンするべきかを指示し、ルートテーブルを定義します。デフォルトのジェネレーターは、それらが何をするかを非常に推測しやすい方法で命名されています。

ジェネレーターの唯一の必須フィールドはstructureType設定です。これはプラグインに、建物が空に、浅い地下に、深い地下に、表面またはサーフェスリキッドにスポーンするかどうかを指示します。

isEnabled

ジェネレーターが有効かどうかを設定します。

structureType

ビルドの種類を設定します。複数の種類のリストを作成できることに注意してください!

単一のジェネレーターに複数の構造タイプを指定できます:

structureType:
- SURFACE
- UNDERGROUND_SHALLOW

これにより、同じジェネレーターが複数の場所(表面と浅い地下領域の両方など)に構造をスポーンさせることができます。

以下は有効な構造タイプの値です:

surface

structureType:
- SURFACE

表面構造は世界の表面にスポーンします。唯一の例外はネザー環境です。ここではプラグインが十分に表面のような点にスポーンします。

sky

structureType:
- SKY

スカイ構造は空気の80〜120ブロック上にスポーンします。config.ymlで設定可能です。唯一の例外はネザー環境です。ここではプラグインが十分に空気のような点にスポーンします。

underground_shallow

structureType:
- UNDERGROUND_SHALLOW

地下浅い構造はオーバーワールドではy=0からy=60の間、ネザーではy=60からy=120の間、エンドでは有効な地下のあらゆる高さでスポーンします。

**注:地下に2つの設定があることがわかります。これは、1つだけを持つと非常にまばらな地下になるためです。Minecraftには多くの地下スペースがあり、プレイヤーはそれらを採掘しなかったため、しばしば地下構造を逃します。これはまた、異なる深さ全体で均等な広がりを保証します。

underground_deep

structureType:
- UNDERGROUND_DEEP

地下の深い構造はオーバーワールドではy=-64からy=0の間、ネザーではy=0からy=60の間にスポーンし、エンドではスポーンしません。

liquid_surface

structureType:
- LIQUID_SURFACE

液体表面構造は液体にスポーンします。オーバーワールドの場合、それらは水にスポーンし、ほぼ常に海洋にスポーンします。ネザーの場合、それらは溶岩湖にスポーンします。エンドではスポーンしません。

lowestYLevel

構造がスポーンする最も低いYレベル(高度)を設定します。デフォルト: -59。

highestYLevel

構造がスポーンする最も高いYレベル(高度)を設定します。デフォルト: 320。

ディメンションごとのデフォルトYレベル範囲:

構造スポーンはディメンションごとに異なるデフォルト高度範囲を使用し、config.ymlで設定可能です:

オーバーワールド/カスタムワールド: Y=-60〜Y=320 (設定: lowestYNormalCustom / highestYNormalCustom)
ネザー: Y=4〜Y=120 (設定: lowestYNether / highestYNether)
エンド: Y=0〜Y=320 (設定: lowestYEnd / highestYEnd)
スカイ構造(オーバーワールド): Y=80〜Y=120 (設定: normalCustomAirBuildingMinAltitude / normalCustomAirBuildingMaxAltitude)
スカイ構造(エンド): Y=80〜Y=120 (設定: endAirBuildMinAltitude / endAirBuildMaxAltitude)

これらのグローバルデフォルトは、ジェネレーター設定でlowestYLevelとhighestYLevelを使用してジェネレーターごとにオーバーライドできます。

validWorlds

構造がスポーンするワールドのリストを設定します。リストが存在しない場合、プラグインで許可されているすべてのワールドを使用します。それ以外に制限されていない場合(環境タイプやバイオームなど)。

validWorldEnvironments

構造がスポーンするワールド環境のリストを設定します。リストが存在しない場合、プラグインで許可されているすべてのワールド環境を使用します。有効な値: NORMAL, NETHER, THE_ENDおよびCUSTOM。

validBiomes

構造がスポーンする有効なバイオームのリストを設定します。リストが定義されていない場合、すべてのバイオームが有効であると想定します!

これにはnamespace:key形式のバイオーム(例:minecraft:plains, minecraft:desert)を使用する必要があります。有効なバイオームのリストはSpigot APIで見つけることができます。プラグインは自動的にCustomBiomeCompatibilityシステムを通じてバニラバイオームにマップされるカスタムバイオームを含めます。

カスタムバイオームサポート:

BetterStructuresはTerralith、Iris、Terra、TerraformGeneratorなどのワールドジェネレーターからカスタムバイオームを自動的にサポートします。

validBiomesにバニラバイオームを指定すると、プラグインは自動的に互換性のあるカスタムバイオームを含めます:

validBiomes:
  - minecraft:plains
  - minecraft:forest

この設定は次のバイオームに構造をスポーンさせます:

バニラバイオーム(minecraft:plains、minecraft:forest)
これらのバニラタイプにマップされたすべてのカスタムバイオーム(例:terralith:blooming_plains)

追加設定は不要です。カスタムバイオームサポートは自動的です。

treasureFilename

ジェネレーターが使用するトレジャーファイルを設定します。これはこのジェネレーターを使用するすべてのビルドのチェストに何がスポーンするかを設定します。別の値がスキーマティック設定のtreasureFile設定で設定されている場合を除きます。