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

form

概要

form は、プレイヤーにUIフォームを表示する ScriptEvent です。
3種類のフォーム(アクション、メッセージ、モーダル)を作成でき、インタラクティブな操作が可能です。

フォームの種類

アクションフォーム

複数のボタンを表示し、選択させるフォームです。
メニュー画面やオプション選択に適しています。

メッセージフォーム

2つのボタンで Yes/No を選択させるフォームです。
確認ダイアログに適しています。

モーダルフォーム

テキスト入力、スライダー、ドロップダウン、トグルなどの要素を含むフォームです。
設定画面や複雑な入力に適しています。

構文

/scriptevent capi:form <パラメータ>

共通の仕様

フォーム完了タグ

フォームが正常に完了すると、プレイヤーに form:<タイトル> タグが付与されます。
このタグは自動的に削除されます。

キャンセル時の動作

プレイヤーがフォームをキャンセル(閉じる)した場合、アクションは実行されません。

関連項目

  • action - アクションフォームの詳細
  • message - メッセージフォームの詳細
  • modal - モーダルフォームの詳細
  • actions - フォームアクションの詳細