Minecraft /tellrawコマンド完全ガイド:JSON形式・クリックイベント・使用例10選
Minecraft 1.21の/tellrawコマンドを徹底解説。JSONテキストコンポーネントの書式、クリックイベント・ホバーイベントの設定、ターゲットセレクター、コピペで使える10個の実用例まで。AlaCraftのtellrawジェネレーターで複雑なJSONを自動生成。
説明の前に、今すぐ貼り付けて使える5つの/tellrawコマンドをどうぞ:
/tellraw @a {"text":"サーバーへようこそ!","color":"gold","bold":true}
/tellraw @a [{"text":"[ルール]","color":"red","clickEvent":{"action":"open_url","value":"https://yourserver.com/rules"}},{"text":" クリックしてサーバールールを確認","color":"white"}]
/tellraw @a ["",{"text":"残高: ","color":"yellow"},{"score":{"name":"@p","objective":"coins"}},{"text":" コイン","color":"yellow"}]
/tellraw @p {"text":"秘密エリアを発見!","color":"aqua","italic":true,"hoverEvent":{"action":"show_text","value":"5つすべてを集めると金庫が解錠されます。"}}
/tellraw @a [{"text":"[ここをクリック]","color":"green","underlined":true,"clickEvent":{"action":"run_command","value":"/warp spawn"}},{"text":" スポーンへテレポート","color":"white"}]
これらがすでに理解できる方は — 素晴らしい、実用例のセクションへ直接どうぞ。画面に誰かがキーボードを落としたような表示に見える方は、読み続けてください。
/tellrawは/sayでは不十分なときにMinecraftが提供するコマンドです。そして/sayはサーバーを1週間以上運営するとほぼ間違いなく不十分になります。色付きテキストが欲しい。クリッカブルなリンクが欲しい。プレイヤー自身のスコアを表示したい。/sayではこれらは何もできません。/tellrawならできます。
JSONテキストコンポーネントのデバッグに費やした時間は、正直数えたくないくらいです — 位置がずれたカンマ、引用符の中の引用符、1時間かけて書いたルールメッセージを壊した余計なバックスラッシュ。このガイドは私が始めたときに存在を願っていたリファレンスです。
このページを読み終えると、完全なJSONテキストコンポーネント形式を理解し、クリッカブルおよびホバー可能なテキストの追加方法を知り、サポートされているすべての色とスタイルの表を持ち、今日のサーバーに直接投入できる10個の本番対応コマンドを持ち帰れます。手動作業を完全にスキップしたい場合は、AlaCraft tellrawジェネレーターがJSONを自動生成し、入力しながらライブプレビューを表示します。
/tellrawとは何か
/tellrawは生のJSONテキストコンポーネントを1人以上のプレイヤーに送信するMinecraftのチャットコマンドです。<Server>プレフィックスでプレーンテキストをブロードキャストする/sayや、書式設定なしのプライベートメッセージを送る/msgとは異なり、/tellrawは完全なコントロールを提供します:色、スタイル、クリック動作、ホバーツールチップ、スコアボード値、プレイヤー名の挿入。
3つのコンテキストで機能します:
- チャット — オペレーター(権限レベル2以上)なら直接入力
- コマンドブロック — タイマー、レッドストーン信号、プレイヤートリガーでメッセージを自動化
- コンソール / RCON — サーバー側のスクリプティングと監視
このコマンドはJava Edition 1.7.2から存在し、ほぼすべてのメジャーリリースで拡張されています:1.8でクリックイベント、1.9でスコアコンポーネント、1.16でHEXカラー、1.21.5でSNBTコンパクト形式。Bedrock Editionにもコマンドは存在しますが、サポートする機能は少なめです。
JSONテキストコンポーネントの書式
すべての/tellrawメッセージはJSONテキストコンポーネント — 単一のオブジェクト{...}またはオブジェクトの配列[...]です。最小限の動作形式:
/tellraw @a {"text":"こんにちは!","color":"gold","bold":true}
"text"キーがコンテンツを保持します。他のプロパティはすべてオプションです:
| プロパティ |
値 |
効果 |
"text" |
任意の文字列 |
表示するコンテンツ |
"color" |
色名または"#RRGGBB" |
テキスト色 |
"bold" |
true / false |
太字 |
"italic" |
true / false |
斜体 |
"underlined" |
true / false |
下線 |
"strikethrough" |
true / false |
取り消し線 |
"obfuscated" |
true / false |
難読化(文字がスクランブル表示) |
"font" |
minecraft:default、minecraft:uniform、minecraft:alt |
フォント(Java 1.16以降) |
"insertion" |
任意の文字列 |
Shift+クリックでチャットバーに挿入されるテキスト |
Minecraftの/tellrawは16種類の名前付きカラーをサポートします。MOTDで使う§コードとは異なり、ここでは色名を文字列として記述します:
| 色名 |
§コード相当 |
HEX |
"black" |
§0 |
#000000 |
"dark_blue" |
§1 |
#0000AA |
"dark_green" |
§2 |
#00AA00 |
"dark_aqua" |
§3 |
#00AAAA |
"dark_red" |
§4 |
#AA0000 |
"dark_purple" |
§5 |
#AA00AA |
"gold" |
§6 |
#FFAA00 |
"gray" |
§7 |
#AAAAAA |
"dark_gray" |
§8 |
#555555 |
"blue" |
§9 |
#5555FF |
"green" |
§a |
#55FF55 |
"aqua" |
§b |
#55FFFF |
"red" |
§c |
#FF5555 |
"light_purple" |
§d |
#FF55FF |
"yellow" |
§e |
#FFFF55 |
"white" |
§f |
#FFFFFF |
Java 1.16以降では任意のHEXカラーも使用できます:"color":"#4A90D9"。
💡 ヒント: HEXカラーはJava 1.16以降でのみ機能します。サーバーが古いバージョンを対象にしているか、Bedrock互換性が必要な場合は、上記16種類の名前付きカラーを使用してください。
1つのメッセージに異なる色やスタイルを組み合わせるには配列を使います。最初の要素は慣例的に書式リセットアンカーとして機能する空文字列""です:
/tellraw @a ["",{"text":"[アナウンス] ","color":"red","bold":true},{"text":"30分後にサーバーメンテナンスがあります。","color":"white"}]
ターゲットセレクター
/tellrawの最初の引数はターゲット — メッセージを受け取るプレイヤーです:
| セレクター |
対象 |
@a |
オンラインのすべてのプレイヤー |
@p |
コマンドソースから最も近いプレイヤー |
@s |
コマンドを実行しているエンティティ |
@a[team=Red] |
チームRedのすべてのプレイヤー |
@a[gamemode=survival] |
サバイバルモードのすべてのプレイヤー |
@a[tag=vip] |
vipタグを持つすべてのプレイヤー |
プレイヤー名 |
正確なユーザー名で指定した特定のプレイヤー |
サーバーのブロードキャストメッセージには、ほぼ常に@aが正しい選択です。アクション後の個人的なフィードバックには@sまたは@pを使います。
クリックイベントとホバーイベント
これが/tellrawを他のすべてのチャットコマンドと区別する点です。テキストセグメントに独立してクリックアクションとホバーツールチップを付加できます。
clickEvent
"clickEvent":{"action":"run_command","value":"/warp spawn"}
| アクション |
効果 |
注意点 |
run_command |
クリックしたプレイヤーとしてコマンドを実行 |
プレイヤーがコマンドの権限を必要とする |
suggest_command |
値をプレイヤーのチャットバーに貼り付ける |
プレイヤー自身がEnterを押す必要あり |
open_url |
デフォルトブラウザでURLを開く |
安全確認ダイアログが表示される |
copy_to_clipboard |
値をクリップボードにコピー |
Java 1.15以降のみ |
change_page |
書き込み可能な本のページを変更 |
本のみ対応 |
hoverEvent
"hoverEvent":{"action":"show_text","value":"スポーンワールドを開きます。"}
| アクション |
効果 |
show_text |
ホバー時にテキストツールチップを表示 |
show_item |
NBTデータ付きのアイテムカード |
show_entity |
エンティティ情報(UUID、名前、タイプ) |
⚠️ 警告: run_commandはプレイヤーとしてコマンドを実行します。サーバーではありません。OP権限が必要なコマンドは非OPプレイヤーには静かに失敗します — エラーなし、何も起きません。プレイヤーに実行前にレビューやキャンセルの機会を与えたい場合はsuggest_commandを使用してください。
両方のイベントを同じテキストコンポーネントに組み合わせる例:
/tellraw @a {"text":"[サーバーに投票する]","color":"green","underlined":true,"clickEvent":{"action":"open_url","value":"https://yoursite.com/vote"},"hoverEvent":{"action":"show_text","value":"投票は30秒でダイヤモンド3個がもらえます!"}}
Java版とBedrock版 — 実際に何がどこで機能するか
クリックイベントメッセージの作成に1時間費やす前に、サーバーがJava版かBedrock版かを確認しましょう:
| 機能 |
Java 1.20以降 |
Java 1.21.5以降 |
Bedrock版 |
| 基本的な色付きテキスト |
✅ |
✅ |
✅ |
| 太字/斜体/下線 |
✅ |
✅ |
✅ |
HEXカラー("#RRGGBB") |
✅ |
✅ |
❌ |
clickEvent(すべてのアクション) |
✅ |
✅ |
❌ |
hoverEvent(すべてのアクション) |
✅ |
✅ |
❌ |
| スコアコンポーネント |
✅ |
✅ |
❌ |
| セレクターコンポーネント |
✅ |
✅ |
❌ |
| SNBTコンパクト形式 |
❌ |
✅ |
❌ |
translateコンポーネント |
✅ |
✅ |
一部 |
⚠️ 警告: GeyserとFloodgateを使ったクロスプレイサーバーを運営している場合は、Bedrock版の機能に合わせてtellrawメッセージを設計してください。クリックとホバーイベントはBedrock版では静かに何もしません — エラーなし、ただデッドテキストになります。
Java 1.21.5のSNBT形式について: 1.21.5からMinecraftはコンパクトなSNBT(Stringified NBT)形式を受け付けます。{"text":"Hi","color":"gold"}の代わりに{text:"Hi",color:gold}と書けます。標準のJSONは引き続き機能します。
すぐに使える10個の実用例
これらをコマンドブロックやサーバーコンソールに直接コピーしてください。プレースホルダー値(サーバー名、URL、スコアボードオブジェクト名)を自分のものに置き換えてください。
1. プレイヤー名付きウェルカムメッセージ
/tellraw @a [{"text":"► ","color":"gold"},{"text":"ようこそ、","color":"yellow"},{"selector":"@p"},{"text":"!ゆっくりしていってね。","color":"yellow"}]
2. クリッカブルなDiscordリンク
/tellraw @a [{"text":"[Discord] ","color":"blue","bold":true,"underlined":true,"clickEvent":{"action":"open_url","value":"https://discord.gg/yourcode"},"hoverEvent":{"action":"show_text","value":"Discordコミュニティに参加しよう"}},{"text":" 話しかけに来てね!","color":"gray"}]
3. サーバールールリマインダー
/tellraw @a ["",{"text":"─────────────────────\n","color":"dark_red"},{"text":" ⚠ サーバールールリマインダー\n","color":"red","bold":true},{"text":"グリーフ禁止 · チート禁止 · 全プレイヤーへの敬意\n","color":"white"},{"text":"─────────────────────","color":"dark_red"}]
4. ライブスコアボード残高表示
/tellraw @a [{"text":"コイン残高: ","color":"yellow"},{"score":{"name":"@p","objective":"coins"}},{"text":" ✦","color":"gold"}]
5. ホバーツールチップ — 隠れたヒント
/tellraw @p {"text":"[?] ホバーでヒントを見る","color":"aqua","italic":true,"hoverEvent":{"action":"show_text","value":"チェストは東側の3番目の滝の裏にあります。"}}
6. コマンドサジェスト付きショップボタン
/tellraw @a [{"text":"[ショップを開く]","color":"green","bold":true,"underlined":true,"clickEvent":{"action":"suggest_command","value":"/shop"},"hoverEvent":{"action":"show_text","value":"サーバーショップを見る"}},{"text":" — 毎週新アイテム追加!","color":"gray"}]
7. 外部リンク付き投票リマインダー
/tellraw @a [{"text":"[投票] ","color":"gold","bold":true},{"text":"サーバーの成長を助けよう! ","color":"yellow"},{"text":"[今すぐ投票 →]","color":"aqua","underlined":true,"clickEvent":{"action":"open_url","value":"https://minecraft-server-list.com/server/your-id/vote/"}}]
8. スタッフブロードキャスト
/tellraw @a [{"text":"[STAFF] ","color":"dark_aqua","bold":true},{"text":"10分後に ","color":"aqua"},{"text":"/warp event","color":"yellow","italic":true},{"text":" でイベントが始まります。お見逃しなく!","color":"aqua"}]
9. 再起動警告
/tellraw @a [{"text":"⚠ ","color":"red"},{"text":"サーバー再起動","color":"red","bold":true},{"text":"まで5分。安全な場所を見つけてください。","color":"white"}]
10. サーバーIPをクリップボードにコピー
/tellraw @a [{"text":"サーバーIP: ","color":"gray"},{"text":"play.yourserver.net","color":"aqua","underlined":true,"clickEvent":{"action":"copy_to_clipboard","value":"play.yourserver.net"},"hoverEvent":{"action":"show_text","value":"クリックしてIPアドレスをコピー"}}]
💡 ヒント: これらを手入力する代わりに、AlaCraft tellrawコマンドビルダーを使ってみてください — ビジュアルでメッセージを作成し、フォームフィールドでイベントを設定し、ワンクリックで完成したコマンドをコピーできます。
よくある6つの間違い
❌ 間違い1: テキスト文字列内のエスケープされていない引用符
JSON文字列はダブルクォートをデリミタとして使います。メッセージテキスト内の引用符はバックスラッシュでエスケープする必要があります。{"text":"彼は"こんにちは"と言った"}は毎回JSONパーサーを壊します。
修正: {"text":"彼は\"こんにちは\"と言った"}
❌ 間違い2: Bedrock版でクリックイベントを使う
Bedrock版の/tellrawはclickEventを静かに無視します。エラーはありません — テキストは表示されますが、クリックは何もしません。多くのサーバー管理者は、プレイヤーからボタンが「機能しない」という苦情が来て初めてこれを発見します。
修正: 対話型機能をプレイヤーに告知する前に、サーバーが実際に実行しているエディションでテストしてください。
❌ 間違い3: 配列内の空文字列リセットの省略
配列を使用する際に先頭の""を省略すると、書式設定(特に太字や斜体フラグ)が予期せず次のコンポーネントに漏れることがあります。
修正: 常に空文字列で配列を開始してください:["", {...}, {...}]
❌ 間違い4: チャットに長いコマンドを直接入力する
チャット入力には256文字の制限があります。複雑な/tellrawコマンドはこれを超えることが多いです。Minecraftは入力の末尾を静かに切り捨て、警告なしにJSONを壊します。
修正: 長いコマンドはコマンドブロックに入れてください。コマンドブロックは最大32,767文字をサポートします。
❌ 間違い5: OP権限が必要なコマンドにrun_commandを使う
clickEventのrun_commandがオペレーター権限(/gamemode、/ban、/giveなど)が必要なコマンドを指している場合、非OPプレイヤーがクリックしても静かな失敗または権限エラーになります。コマンドはサーバーではなくプレイヤーとして実行されます。
修正: run_commandはプレイヤーが既に実行権限を持つコマンドにのみバインドしてください。
❌ 間違い6: 括弧の不一致または閉じていない文字列
すべての{には対応する}が必要です。すべての[には]が必要です。すべての"にはペアが必要です。Minecraftの JSONパーサーは容赦なく — 1文字でも欠けるとコマンド全体を拒否し、あいまいなエラーまたは静かな失敗になります。
修正: VS CodeのJSONシンタックスハイライトで複雑なコマンドを書くか、AlaCraft tellrawジェネレーターを使ってください。入力しながらリアルタイムでエラーを検証してフラグを立てます。
/tellrawを使うべきシーン — 判断フロー
すべての状況でJSONを全力使用する必要はありません。これらの質問を順番に確認してください:
-
メッセージに色、書式設定、またはインタラクティビティが必要ですか?
— いいえ → /sayを使う(JSON不要、即座に機能)
— はい → 次へ
-
特定のプレイヤー1人へのプライベートメッセージですか?
— はい → /tellraw <プレイヤー名>でJSONを使うか、プレーンテキストなら/msg <プレイヤー名>
— いいえ → 次へ
-
画面に大きなタイトルオーバーレイとして表示すべきですか?
— はい → /title @a title {"text":"..."} (同じJSON形式、フルスクリーンでレンダリング)
— いいえ → 次へ
-
クリックイベント、ホバーツールチップ、スコアボード値が必要ですか?
— はい → /tellrawが正しいツール
— いいえ → プラットフォームがサポートする場合は§コード付きの/sayを検討(シンプルな文法)
-
スケジュールまたはトリガーで自動的に実行されますか?
— はい → /tellrawをクロック回路のコマンドブロックに入れるか、EssentialsXやCMIのようなプラグインスケジューラを使う
— いいえ → コンソールやチャットから手動で実行する
-
Bedrock版サーバーまたはクロスプレイ設定ですか?
— はい → 色と基本的な書式設定フラグに限定し、クリックとホバーイベントは完全に廃棄する
公開前に/tellrawをテストする
壊れたJSONをすべてのプレイヤーの前で発見するのは避けましょう。簡単な検証ワークフロー:
- シングルプレイヤークリエイティブワールド — 最速のループ:チートを有効にし、チャットに貼り付け、調整を繰り返す。プレイヤーには影響なし。
- まず自分をターゲットにする —
/tellraw @sを使うと、調整中は自分だけがテスト出力を見る。
- 実行前にプレビュー — AlaCraft /tellrawジェネレーターはコマンドをコピーする前にライブチャットプレビューをレンダリングするので、実行前に視覚的な問題を検出できます。
- エラーメッセージを読む — Minecraftがコマンドを拒否した場合、探すべきもの:エスケープされていない引用符、配列要素間の欠けたカンマ、閉じていない括弧や角括弧。
- ゲーム内でクリックイベントをテストする — ジェネレーターはクリックをシミュレートできません。本番サーバーで有効にする前に、実際のゲームセッションで
run_commandとopen_urlアクションが正しく機能することを確認してください。
✅ 注意: コマンドブロックでテストする際は、クロック回路ではなくボタンを接続してください。20ティックの繰り返しクロックに壊れた/tellrawがあると、すべてのプレイヤーのチャットがエラーメッセージで埋め尽くされます。
AlaCraft tellrawジェネレーター — できること
JSONを手書きすることが楽しい午後の使い方ではないなら — 私もそうです — AlaCraft /tellrawジェネレーターが自動的に構造を処理します:
- ビジュアルコンポーザー — テキストセグメントを追加し、パレットから色を選び、チェックボックスで太字/斜体/下線を切り替える
- クリック&ホバーエディター — ドロップダウンとテキストフィールドで
clickEventとhoverEventを設定。JSON知識不要
- ライブプレビュー — コマンドをコピーする前にメッセージがMinecraftのチャットでどう見えるかを正確に確認
- ワンクリックコピー — 完全な
/tellraw @a {...}コマンドをコピー。コマンドブロックやコンソールへ直接貼り付け可能
- 複数のターゲット —
@a、@p、@s、または特定のプレイヤーユーザー名を切り替え
- リアルタイム検証 — 入力しながらJSONエラーをハイライト。コマンドを試す前にエラーを発見
アカウント、登録、インストール不要。ページを開き、メッセージを作成し、コピーして貼り付けるだけ。
よくある質問
Bedrock版のMinecraftでは/tellrawでテキストを書式設定できますか?
部分的に。Bedrock版は16種類の名前付きカラーと太字/斜体/下線の書式フラグをサポートします。ただしclickEvent、hoverEvent、HEXカラー("#RRGGBB")、スコアコンポーネント、セレクターコンポーネントはすべてサポートされていません。フル機能の/tellrawにはJava版が必要です。
/tellrawと/sayの違いは何ですか?
/sayは<Server>または<プレイヤー名>プレフィックス付きのプレーンで書式なしテキストをブロードキャストします — 色なし、インタラクティビティなし、プレフィックスを抑制する方法なし。/tellrawはプレフィックスなしでJSON形式のテキストを送信し、完全なカラーコントロール、クリックとホバーのサポート、リアルタイムのスコアボードデータ挿入があります。
/tellrawメッセージでプレイヤーの名前を表示するにはどうすればいいですか?
selectorコンポーネントを使います:{"selector":"@p"}は最も近いプレイヤーの表示名を挿入します。配列内では:["ようこそ、", {"selector":"@p"}, "!"]。セレクターはコマンドが実行された瞬間に解決されるので、常に正しい名前が表示されます。
/tellrawをコマンドブロック内で使えますか?
はい — そして長いメッセージの場合、コマンドブロックは事実上唯一の実用的な選択肢です。チャット入力は256文字に制限されていますが、コマンドブロックは32,767文字を受け付けます。
/tellrawの文字数制限は何ですか?
チャットへの直接入力で256文字。コマンドブロック内で32,767文字。クリックとホバーイベントの両方を持つ複雑なマルチセグメントメッセージでも600〜800文字を超えることはまれなので、コマンドブロックは現実的なあらゆる用途に十分です。
/tellrawメッセージでスコアボードの値を表示するにはどうすればいいですか?
scoreコンポーネントを使います:{"score":{"name":"@p","objective":"coins"}}。これはコマンドが実行された瞬間に、ターゲットプレイヤーのcoinsスコアボードオブジェクティブの値を読み取ります。配列内の他のテキストコンポーネントと組み合わせて「コイン残高: 347 ✦」のような完全な行を作れます。
/tellrawは1つのメッセージで複数行をサポートしますか?
はい。テキスト文字列内の\nを使って改行を挿入します:{"text":"1行目\n2行目"}。現在のほとんどのサーバーバージョンでチャット内で確実に機能します。本番環境で使用する前に、古いビルドや特定のプロキシ設定では動作が異なることがあるため、使用するサーバーバージョンでテストしてください。