プリセット

テキストとUIプリセット

Tellraw JSON テキストジェネレーター

Tellraw はチャットコマンドの皮を被った、実態はテキストコンポーネントの JSON 問題です。このジェネレーターページは、ふだん壊れがちな部分、すなわち入れ子のホバーテキスト、クリックアクション、色、太字などのスタイル状態、そして安全なコマンド値の扱いに焦点を当てています。

プリセット結果

JSON テキストコンポーネントを手作業でエスケープすることなく、プレイヤーが読み、ホバーし、クリックできる明快なメッセージが得られます。

出力

Tellraw JSON 出力

/tellraw @a {text:"Open the dungeon gate",color:"gold",bold:true,hover_event:{action:"show_text",value:{text:"Click to run the gate trigger",color:"gray"}},click_event:{action:"run_command",command:"/trigger dungeon_gate"}}

プリセットのスクリーンショット

Minecraft Tellraw JSON テキストジェネレーターの記事で使用する NBTForge Workbench の状態です。表示されるコントロールと、生成された出力をあわせて確認できます。

プリセットを作成

  1. Text Workbench を開き、対象の出力として Tellraw を選択します。
  2. まず表示するメッセージを書き、その後で色やスタイルの状態を重ねていきます。
  3. プレーンなメッセージが正しく表示できたことを確認したうえで、hover_event と click_event を追加してください。
  4. JSON の出力をコピーし、実際に最終メッセージを受け取るのと同じセレクターでテストします。

高度な JSON より、まず読みやすい JSON

Tellraw でもっともよく起こるエラーは、JSON の形式不正です。まずは表示されるテキストだけを作り、そのうえにインタラクションを重ねていくのが安全です。NBTForge ではテキストコンポーネントをコマンド出力に変換する前にフィールド単位で編集できるため、その手順を踏みやすくなります。

マップ内のプロンプトでは、最初の一文は短く保ち、補足情報はホバーテキストへ寄せてください。クリックアクションでは、長い隠しコマンドの連鎖ではなく、トリガーや安全なコマンドだけを実行させましょう。

Command Pack のどこに収まるか

Tellraw は、scoreboard のトリガー、タイトルメッセージ、効果音フィードバック、クエストの状態などと組み合わせて使うのが一般的です。マルチステップの対話の一部であれば、コマンドを Project に保存しておきます。

同じカテゴリのアクションには一貫した色を使ってください。たとえば目的の提示は金色、成功は緑色、ブロックされた行為は赤色、といった具合です。

  • 可能であれば、プレイヤーのクリックフローには /trigger を用いてください。
  • ホバーテキストは説明的な内容にとどめ、主要な指示はそこへ書かないようにします。
  • 最終的なコマンド実行コンテキストに応じて、@s、@p、@a を使ってテストしてください。

プリセットを実際の Project に合わせ込む

Tellraw JSON Text Generator は、単にコピーする文字列ではなく、テスト済みの出発点として扱ってください。出力がきちんと動いた段階で、わかりやすい Project 名を付けて保存し、対象の Minecraft バージョンを書き残し、scoreboard、ボスバー、ルートテーブル、リセット行など関連するセットアップコマンドの近くに置いておきます。

プリセットをマップ、サーバー、Command Pack へ公開する前に、起動中の Workbench の中だけで動かすのではなく、いったんコピーした成果物から実行してみてください。これによって、依存関係の抜け、古いセレクター、Edition の選び間違い、ローカルでの作業状態に依存して偶然動いていただけのコマンドなどを洗い出せます。

  • 選択した Edition と Version は、共有するコマンドにそのまま反映させます。
  • ダメージ、キル、クリア、テレポートを行う前に、無害なコマンドでセレクターの挙動を確認してください。
  • 長いコマンドをチャットに貼り付けるのではなく、Project か関数スタイルのワークフローへ移しましょう。
  • エンティティ、アイテムコンポーネント、passenger、データパックのリソースを変更した後は、警告内容をもう一度見直してください。

FAQ

Tellraw のクリックでコマンドを実行できますか?

はい。click_event を run_command と組み合わせ、プレイヤーのコンテキストで有効な、安全なトリガーやコマンドを指し示してください。

Tellraw の JSON が、あるバージョンでは動くのに別のバージョンでは動かないのはなぜですか?

テキストコンポーネントの形式は時間とともに変化してきました。古いエスケープ済みの JSON スニペットを無条件にコピーするのではなく、選択したバージョンファミリで確認したうえで、コンポーネントから組み直してください。

このプリセットを Command Pack に組み込むべきタイミングは?

出力がセットアップ行、リセットコマンド、ルートテーブルのリソース、scoreboard の状態、繰り返し実行するテストに依存している場合は、Command Pack のエントリとして扱います。単発で安全に使えるコマンドであれば、引き続き出力から直接コピーするので構いません。

このワークフローを開く

関連する Text ワークベンチから始め、ワールドに合わせてプリセット項目を調整します。