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

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

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

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

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

actions:
  - type: open-menu
    menu: "shop" # sub/shop.yml を開く

:::info 画面描画の完了待機 open-menu は、対象のメニューがプレイヤーの画面上に正常に表示されるまで待機してから完了します。そのため、画面遷移の直後にメッセージを送るようなパイプラインも確実に順序通り動作します。 :::

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

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

actions:
  - type: close-menu

:::note 安全なクローズ処理 アイテムプロパティの 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単位)