Body・Presentation
EasyMenu 7では、メニュー画面全体の表示形式を制御する presentation 設定と、Native Dialog画面を装飾するための body コンテンツをサポートしています。
ボディコンテンツ (body)
body は、Native Dialogの上部に説明文やアイテムアイコンなどの装飾コンテンツを表示する機能です。
menu-title: "&6特設ショップ"
dialog: true
# ダイアログ上部に表示する装飾コンテンツ
body:
- type: text
text: "&e毎週土曜日はショップ全品20%OFFセール開催中!\n&7お得なアイテムをチェックしてください。"
- type: item
material: NETHERITE_SWORD
name: "&c&l今週の目玉商品"
lore:
- "&7伝説のネザライトソード"
- "&e特別価格: 5,000円"
menu-items:
- id: buy
material: EMERALD
name: "購入する"
command: "shop buy featured"
:::info インベントリGUIでの扱い
インベントリGUI(チェスト画面)では、body コンテンツは自動的に省略されます。body にはコマンドやアクションなどの動作は結びついていない純粋な装飾要素であるため、機能が失われることはありません。
:::
詳細な表示モード設定 (presentation)
メニューファイルごとに表示方法を細かく指定できます。
presentation:
mode: native-preferred # 表示モード
fallback: true # 非対応環境でインベントリGUIへのフォールバックを許可するか
inventory:
size: 54
background: "GRAY_STAINED_GLASS_PANE"
native:
columns: 2
button-width: 160
can-close-with-escape: true
pause: false
表示モード一覧 (presentation.mode)
| モード | 優先する描画方式 | 説明 |
|---|---|---|
inventory (既定値) | インベントリGUI | 従来のチェスト画面形式で表示します。 |
native-preferred | Native Dialog → インベントリGUI | ダイアログ対応環境ではダイアログ、非対応環境ではチェスト画面で表示します。 |
native-required | Native Dialog のみ | ダイアログ対応環境でのみ表示します(非対応環境ではエラーメッセージを表示)。 |
rich-preferred | リッチUI → ダイアログ → インベントリ | 将来の拡張クライアント等を含む最適なUIで表示します。 |
rich-required | リッチUI のみ | リッチ描画対応環境でのみ表示します。 |
auto | 自動選択 | 接続クライアントとサーバー能力に応じた最適な描画方式を自動選択します。 |
:::tip dialog: true との併用
dialog: true と presentation セクションを同時に記述した場合、presentation の設定が優先されます(警告ログが出力されます)。
:::