TOOL

server-ui フォームビルダー(OreUI版)

OreUI(DDUI)の CustomForm を組み立てて、コードを自動生成。値が変わると画面が変わる動きまで、仮想UIで確認できます。

T6NetWork › ツール › server-ui フォームビルダー(OreUI版)

OreUI(DDUI)版です。従来の ActionFormData / ModalFormData 用は server-ui フォームビルダー をご利用ください。

仮想UI(OreUI風・実際に動かせます)

「▶ 実行」を押すと、ここにフォームが表示されます。
ボタンを押したり、入力したりすると、画面がその場で変わります。
プレイヤー「Steve」のチャット・コマンド
いまの Observable の値(入力欄・スライダーなどに結びついた値)
(フォームを開くと表示されます)
show() の結果(フォームが閉じたとき)
(まだありません)

生成されたコード(scripts/main.js など)

OreUI(DDUI)フォームビルダーの使い方

OreUI は、マインクラフト統合版の新しいUI基盤です。データ駆動UI(DDUI)では、値を保持する Observable を画面部品に結び付けることで、値が変わると画面も自動で更新される作りができます。従来のフォームとは考え方が違い、書き方に慣れるまで少し時間がかかります。このビルダーでは、CustomForm や MessageBox を画面上で組み立て、Observable の連動まで仮想UIで確認しながら、コードを自動生成できます。

手順

  1. フォームのタイトルと、部品(ラベル・ボタン・トグル・スライダーなど)を追加します。
  2. 値を持たせたい部品に Observable を割り当てます。
  3. 仮想UIで操作し、値の変化に合わせて表示が変わることを確認します。
  4. 生成コードをコピーして、スクリプトに組み込みます。

知っておきたいこと

  • DDUI は新しい機能のため、バージョンによって使える部品や書き方が変わる可能性があります。最新の公式ドキュメントとあわせて確認してください。
  • ベータ機能を使う場合は、ワールドの実験的機能の設定が必要になることがあります。
  • 従来方式で十分な場合はserver-ui フォームビルダーのほうが手軽です。

ほかのツール

ツール一覧へ戻る

よくある質問

OreUI(DDUI)とは何ですか?従来の server-ui と何が違いますか?

Bedrock の新しい UI エンジン(Ore UI)で動く、データ駆動UI(DDUI)のフォームです。従来の ActionFormData / ModalFormData は「表示 → 送信 → 結果を受け取る」形でしたが、DDUI の CustomForm は、フォームを開いたままで、ボタンの onClick や、Observable(値を変えると画面が自動で更新される入れ物)で動かします。カウンターや、チェックを入れると別の項目が出る、といった動きを、フォームを開き直さずに作れます。

Observable とは何ですか?

値を入れておく入れ物です。ObservableString / ObservableNumber / ObservableBoolean があります。setData() で値を変えると、それに結びついた画面の部分が自動で書き換わります。入力欄・スライダー・トグル・ドロップダウンの値は、{ clientWritable: true } の Observable に入り、プレイヤーが操作すると、その Observable が更新されます。値は getData() で読み取ります。

「{変数名}」と書くと何が起きますか?

見出し・ラベル・ボタンの文字や、メッセージに、{変数名} と書くと、その変数の値が入ります。変数が変わるたびに、文字も自動で変わるように、コードが作られます(例: 「回数: {visits}」)。

安定版とベータ版の違いは?

CustomForm・MessageBox・Observable の基本は、安定版の 2.2.0 から使えます。multiButtonRow(横並びのボタン)、CustomForm のオプション(topCloseButtonVisible)、MessageBox の3つ目のボタンや横並び、スライダーの小数桁(fixedFormatDigits)、各種の tooltip などは、ベータ版(2.4.0-beta)だけです。設定で切り替えると、コードと仮想UIの動きが変わります。

従来の server-ui のツールは使えなくなりますか?

いいえ。従来の ActionFormData / ModalFormData 用のツールは、別のページ(server-ui フォームビルダー)として、そのまま使えます。

シミュレーターの注意点は?

画面が開いている間に、別のフォームを開こうとすると UserBusy にしています(実機の細かい挙動は、ゲームで確認してください)。そのため、別のフォームを開くときは、先に「このフォームを閉じる」を入れています。X ボタンは、既定で表示し、Esc キーでも閉じられます。player のメソッドは、sendMessage・runCommand・タグ・playSound などだけが動きます。