メインコンテンツまでスキップ

アイテムの設定

menu-items 配下に記述するアイテム（要素）の詳細設定について解説します。

基本的なアイテム設定​

menu-items:
  - slot: 13
    material: DIAMOND_SWORD
    name: "&c&l伝説の剣"
    amount: 1
    glint: true
    lore:
      - "&7攻撃力: &c+10"
      - "&7耐久度: &a無限"
      - ""
      - "&eクリックして購入"
    sound: "ENTITY_PLAYER_LEVELUP"
    close-menu: true
    command: "shop buy sword"

アイテムの配置方法​

アイテムの配置位置は slot または location のいずれかで指定します。

1. slot（スロット番号で指定）​

インベントリの左上を 0 とした0始まりのインデックス番号です。

 0  1  2  3  4  5  6  7  8   (1行目)
 9 10 11 12 13 14 15 16 17   (2行目)
18 19 20 21 22 23 24 25 26   (3行目)
...
slot: 13 # 2行目の中央

2. location（列,行 で指定）​

左上を "1,1" とした1始まりの「列,行」形式です（EasyMenu 5/6互換）。

location: "5,2" # 5列目・2行目（スロット13と同じ位置）

:::note slotとlocationが両方ある場合 1つのアイテムに slot と location が両方書かれている場合は、slot の値が優先されます。 :::

アイテムのプロパティ一覧​

キー型既定値説明
id文字列自動生成要素の識別ID。省略時は slot-13 や location-5-2 などから決定論的に生成されます。
materialMaterial名必須アイテムの素材名（例: DIAMOND, COMPASS, PLAYER_HEAD）。
name文字列素材名アイテムの表示名。カラーコードやプレースホルダーが使用可能。
loreリスト[]アイテムの説明文（行のリスト）。
amount整数1アイテムの個数（スタック数）。
glint真偽値なしエンチャントの光沢効果を付与するかどうか。
custom-model-data整数なしリソースパック用のCustomModelData値。
base64文字列なしプレイヤーの頭（PLAYER_HEAD）に適用するBase64テクスチャ文字列。
soundSound名なしクリック受理時に再生される効果音。
close-menu真偽値trueアクション完了後にメニューを閉じるかどうか。
click-policy列挙型PRIMARY反応するクリック種類（PRIMARY, LEFT, RIGHT, ANY）。

プレイヤーヘッドとBase64スキン (base64)​

material: PLAYER_HEAD を使用する場合、base64 キーでカスタムスキンのテクスチャを指定できます。

menu-items:
  - slot: 13
    material: PLAYER_HEAD
    name: "&eプレゼントボックス"
    base64: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvZWI3Y2JjY2UxMGFhMmJjNzRiOTZjNmYxNWQ3N2VkMTkyYmM3YjNmZGU5YThjMmY5NWVhYjlkMTFlOTMyZDYyIn19fQ=="
    command: "present claim"

モダンアイテムコンポーネント (components)​

Minecraft 1.20.5+ で導入されたコンポーネント機能に対応しています。

menu-items:
  - slot: 13
    material: NETHERITE_CHESTPLATE
    name: "&6&l不滅の鎧"
    components:
      unbreakable: true                  # 耐久度無限
      max-stack-size: 1                  # 最大スタック数
      rarity: epic                       # レアリティ (common, uncommon, rare, epic)
      hide-tooltip: false                # ツールチップ非表示フラグ
      enchantment-glint-override: true   # 光沢オーバーライド
      item-model: "minecraft:bundle"     # 1.21.6+ アイテムモデル指定
    command: "shop buy armor"

:::info バージョンごとの自動フォールバック 実行中のサーバーバージョンがサポートしていないコンポーネント（例: 1.20.1での item-model）は、起動時に警告が出力され、安全にスキップされます。メニューやアイテム自体の読み込みが失敗することはありません。 :::