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

メニュー・メッセージ・サウンド

画面の開閉やプレイヤーへの通知、効果音の再生を行うアクションです。


メニューを開く (type: open-menu)​

別のメニュー(メインメニューやサブメニュー)へ画面を遷移させます。

actions:
- type: open-menu
menu: "shop" # sub/shop.yml を開く
画面描画の完了待機

open-menu は、レンダラーが対象メニューを開く処理を完了するまで待機してから完了します。後続アクションはその完了後に実行されます。 クライアント側の描画成功を確認するものではありません。


メニューを閉じる (type: close-menu)​

現在開いているメニュー画面を閉じます。

actions:
- type: close-menu
安全なクローズ処理

アイテムプロパティの close-menu: true やアクションの type: close-menu は、「クリックの起点となったメニュー画面」を安全に閉じます。アクション内で open-menu を呼び出して別の新しいメニューを開いた場合、新しく開いたメニューが誤って閉じられることはありません。


メッセージを送信する (type: message)​

プレイヤーのチャット欄にメッセージを送信します。カラーコードやプレースホルダーが使用できます。

actions:
- type: message
message: "&a購入が完了しました! &7(所持金: %vault_eco_balance%)"

サウンドを再生する (type: sound)​

プレイヤーにMinecraftの効果音を再生します。

actions:
- type: sound
sound: "ENTITY_PLAYER_LEVELUP" # サウンド名
volume: 1.0 # 音量 (省略時: 1.0)
pitch: 1.2 # 音の高さ (省略時: 1.0)

タイトルを表示する (type: title)​

プレイヤーの画面中央に大きなタイトル文字(およびサブタイトル)を表示します。

actions:
- type: title
title: "&6&lMISSION CLEAR" # メインタイトル
subtitle: "&e報酬を獲得しました!" # サブタイトル
fade-in: 10 # フェードイン時間 (tick単位、20tick=1秒)
stay: 70 # 表示維持時間 (tick単位)
fade-out: 20 # フェードアウト時間 (tick単位)