宝物ファイルとは？

宝物ファイルはBetterStructuresのチェストのルートテーブルを決定します。通常は[ジェネレーター](../Better Structures/creating_generators.md#treasurefilename)に割り当てられますが、[個別のビルド設定](../Better Structures/creating_structures.md#treasurefile)レベルでも設定できます。

これらのルートテーブルは非常に強力ですが、理解するには基本的な統計概念の知識が必要です。

ここでそれらの概念について読んでください。ページの残りはそれらを理解していることを前提としています！

重み付け確率

重み付け確率は、各アイテムに重みを付けることで、無限のアイテムリストから選択する確率を設定する問題を解決します。

ガウス分布

ガウス分布は釣り鐘型の数学関数です。

ガウス分布は、チェストに出現するアイテム数をランダム化するために使用されます。平均値と標準偏差の2つの設定に焦点を当てるだけで済みます。

平均値

meanはガウス曲線の中心を設定します。チェストに通常5個のアイテムが入っているようにしたい場合、平均値を5に設定してください。

標準偏差

標準偏差は数値がどれだけ変動できるかを決定します。小さい値(1)では4-6個、中くらい(2)では3-7個、大きい値(3以上)では2-8個以上。

デフォルトの平均値は4、デフォルトの標準偏差は3です。

実装の詳細

システムはチェストに少なくとも1つのアイテムが表示されることを保証します。

システムはチェストに少なくとも1つのアイテムが表示されることを保証します。

アイテムはチェスト内のランダムなスロットに配置されます。

アイテムはチェスト内のランダムなスロットに配置されます。

素材が存在しない場合、そのアイテムはスキップされます。無効なエンチャントはコンソールに警告を表示します。

素材が存在しない場合、そのアイテムはスキップされます。無効なエンチャントはコンソールに警告を表示します。

特殊フォーマット

isEnabled: true
mean: 4.0
standardDeviation: 3.0
vanillaTreasure: BURIED_TREASURE
items:
  common:
    weight: 60
    items:
    - amount: 1-1
      material: STONE_PICKAXE
      procedurallyGenerateEnchantments: true
      weight: 1.0
    - amount: 1-1
      material: STONE_SHOVEL
      procedurallyGenerateEnchantments: true
      weight: 1.0
  rare:
    weight: 30
    items:
    - amount: 1-1
      material: ANVIL
      weight: 6.0
    - amount: 1-6
      material: BEETROOT
      weight: 6.0
  epic:
    weight: 10
    items:
    - amount: 2-10
      material: DIAMOND
      weight: 1.0
    - amount: 1-1
      material: DIAMOND_AXE
      weight: 6.0
procedurallyGeneratedItemSettings:
  golden_sword:
    bane_of_arthropods:
      minlevel: 1
      maxlevel: 5
      chance: 0.2
    looting:
      minlevel: 1
      maxlevel: 3
      chance: 0.2

isEnabled

Key	Values	Default
`isEnabled`	Boolean	`true`

mean

Key	Values	Default
`mean`	Double	`4`

standardDeviation

Key	Values	Default
`standardDeviation`	Double	`3`

vanillaTreasure

Key	Values	Default
`vanillaTreasure`	String	none

カスタム戦利品に加えて使用するオプショナルのバニラMinecraftルートテーブルを設定します。

items

管理者が設定できるオプションが多いため、ここは少し複雑です。

items:
  common:
    weight: 60
    items:
    - amount: 1-1
      material: STONE_PICKAXE
      procedurallyGenerateEnchantments: true
      weight: 1.0
    - amount: 1-1
      material: STONE_SHOVEL
      procedurallyGenerateEnchantments: true
      weight: 1.0
  rare:
    weight: 30
    items:
    - amount: 1-1
      material: ANVIL
      weight: 6.0
    - amount: 1-6
      material: BEETROOT
      weight: 6.0

rarities

レア度には固定の名前がありません。自由に追加、削除、カスタマイズできます。

rarity items

Key	Values	Default
`amount`	min-max Integer	variable
`material`	Material	variable
`procedurallyGenerateEnchantments`	Boolean	variable
`weight`	Double	variable

amount

ドロップ数を設定します。範囲amount: MIN-MAXまたは固定値amount: 値で指定できます。

material

Spigot API名を使用して素材を設定します。

Special case - serialized

lootifyコマンド使用時、serialized設定が自動生成されます。手動で生成しないでください。

mmoitem

MMOItemsプラグインからカスタムアイテムを設定します。

- amount: 1-1
  mmoitem: SWORD@Excalibur
  weight: 1.0

info

メモやコメントを追加するためのオプショナルフィールド。プラグインには完全に無視されます。

- amount: 1-1
  material: DIAMOND_SWORD
  weight: 1.0
  info: "Rare drop for completing the dungeon"

weight

重み付け確率の重みを設定します。

procedurallyGenerateEnchantments

procedurallyGeneratedItemSettingsの設定に基づいてアイテムを手続き的に生成するかを設定します。

procedurallyGeneratedItemSettings

procedurallyGeneratedItemSettings:
  golden_sword:
    bane_of_arthropods:
      minlevel: 1
      maxlevel: 5
      chance: 0.2
    looting:
      minlevel: 1
      maxlevel: 3
      chance: 0.2

このファイルは素材タイプ、エンチャント、最小/最大レベル、確率をリストします。

Key	Values	Default
`minlevel`	Integer	variable
`maxlevel`	Integer	variable
`chance`	Chance	variable

minlevel

最小エンチャントレベルを設定します。

maxlevel

最大エンチャントレベルを設定します。

chance

エンチャント適用確率を0.0（なし）から1.0（常に）の小数値で設定。例：0.2 = 20%。

トラブルシューティング

チェストにアイテムが表示されない

宝物ファイルにisEnabled: trueがあることを確認
無効なマテリアルやアイテムに関するコンソール警告を確認
カスタムアイテムを使用している場合はMMOItemsがインストールされていることを確認
マテリアルは正確なSpigot API名を使用する必要があります

エンチャントが適用されない

アイテムにprocedurallyGenerateEnchantments: trueを設定
エンチャント名がMinecraftのNamespaced Keysと一致することを確認
min/maxレベルがそのエンチャントの有効な範囲内であることを確認
chance値は確率（0.2 = 20%）であり、保証ではないことを覚えておいてください

カスタムプラグインのエンチャントが機能しない

BetterStructures統合を明示的にサポートするカスタムエンチャントのみが機能します。エンチャントプラグインの作者に互換性を確認してください。無効なエンチャントはこの可能性を示唆するコンソール警告を表示します。

空のチェストが表示される

システムは最低1つのアイテムを保証するため、これは発生しないはずです。空のチェストが表示される場合は、以下を確認してください：

チェストがBetterStructuresによって充填されていること（他のプラグインではなく）
宝物ファイル内のすべてのアイテムが有効であること（コンソール警告を確認）
宝物ファイルが実際にロードされていること（起動ログを確認）

実装の詳細

特殊フォーマット

isEnabled

mean

standardDeviation

vanillaTreasure

items

rarities​

rarity items​

amount​

material​

Special case - serialized​

mmoitem​

info​

weight​

procedurallyGenerateEnchantments​