マイクラ統合版Script APIでscripteventからフォームを表示する方法｜main.jsの書き方と画面遷移の実装例

マインクラフト統合版のScript APIでは、scripteventコマンドをきっかけにしてプレイヤーへフォームを表示したり、ボタン選択後に別のフォームへ移動させたりする仕組みを作ることができます。

この記事では、main.jsへ記述する基本的な構文から、scripteventの受け取り方、フォーム表示、ボタンを押した後に次のフォームを表示する方法まで、実際に使える形で解説します。

マイクラ統合版Script APIでscripteventを利用する流れ
main.jsでscripteventを取得する基本構文
ActionFormDataで最初のフォームを表示する方法
ボタンを押した後に別のフォームを表示する方法
scripteventでフォームを呼び出す際の注意点
実際に使えるメニュー型アドオンの構成例
まとめ

マイクラ統合版Script APIでscripteventを利用する流れ

統合版のScript APIでは、ゲーム内コマンドのscripteventを利用すると、JavaScript側でイベントを受け取って処理を実行できます。

基本的な流れは「プレイヤーがscripteventコマンドを実行する」→「main.jsでイベントを取得する」→「フォームを表示する」という形になります。

例えば、以下のようなコマンドを実行します。

/scriptevent sample:menu

このイベントIDをmain.js側で監視し、対象のプレイヤーにフォームを表示します。

main.jsでscripteventを取得する基本構文

まずはScript APIでscripteventを受け取る処理を書きます。Minecraft統合版ではsystem.afterEvents.scriptEventReceiveを利用します。

基本的なコード例は以下のようになります。

import { system } from "@minecraft/server";
import { ActionFormData } from "@minecraft/server-ui";

system.afterEvents.scriptEventReceive.subscribe((event) => {
    if (event.id === "sample:menu") {
        const player = event.sourceEntity;
        if (player) {
            showMainForm(player);
        }
    }
});

event.idにはscripteventで指定したIDが入ります。そのため、コマンド側とJavaScript側で同じIDを指定する必要があります。

また、フォームを表示するには対象となるプレイヤーの情報が必要になるため、event.sourceEntityから実行者を取得します。

ActionFormDataで最初のフォームを表示する方法

プレイヤーへ選択肢を表示する場合は、@minecraft/server-uiのActionFormDataを利用します。

例えばメニュー画面を作成する場合は、以下のような関数を用意します。

function showMainForm(player) {
    const form = new ActionFormData()
        .title("メインメニュー")
        .body("操作を選択してください")
        .button("次のフォームを開く")
        .button("閉じる");

    form.show(player).then(response => {
        if (response.canceled) return;

        if (response.selection === 0) {
            showSecondForm(player);
        }
    });
}

button()で作成したボタンは上から順番に番号が割り当てられます。最初のボタンはselectionが0、2番目のボタンはselectionが1になります。

ボタンを押した後に別のフォームを表示する方法

フォームのボタン選択後に別画面を表示したい場合は、選択結果を確認して別のフォーム表示関数を呼び出します。

例えば、最初のフォームで「次へ」を押した場合に詳細メニューを表示する場合は以下のように書けます。

function showSecondForm(player) {
    const form = new ActionFormData()
        .title("詳細メニュー")
        .body("次の操作を選択してください")
        .button("設定")
        .button("戻る");

    form.show(player).then(response => {
        if (response.canceled) return;

        if (response.selection === 0) {
            player.sendMessage("設定を選択しました");
        }
    });
}

このようにフォームごとに関数を分けることで、メニューが増えても管理しやすい構造になります。