コードを解読せよ：Minecraftのテキストエラーを修正する

チャット、看板、書籍、またはリソースパックのフォントが正しく表示されない場合は、まずMinecraftのエディションとバージョンを特定し、次にテキストの発生源を特定してください。Minecraftのテキストエラーのほとんどは、異なるエディションまたはバージョン用に記述されたコマンド、パック内の不正なJSONファイル、欠落したフォントグリフ、またはサーバー側のフォーマットが原因です。「語句エラー」という表現は特定のMinecraftエラーコードではないため、最も迅速な解決策は、一度に1つのソースをテストすることです。

このガイドでは、Java版とBedrock版の両方を扱っていますが、テキスト形式は互換性のあるものとして扱っていません。パックやMODを変更する前にワールドのバックアップを取り、コピーしたワールドまたは一時的なクリエイティブワールドでコマンドをテストしてください。

Minecraftのテキストに関するトラブルを解決するための4つのステップチェックリスト

1. エディションとゲームバージョンを確認してください

コマンドをコピーする前に、ランチャーまたはゲームメニューに表示されているエディションと正確なバージョンを確認してください。Java Edition では、1.21.5 でコマンド内のテキストコンポーネントの記述方法が変更されました。などのコマンドでは/tellraw、/titleJSON の代わりに SNBT が使用されます。Java 1.21.6 では、パック、ワールド、および設定内の JSON ファイルの解析が厳密になったため、余分なカンマや不正な引用符があるとファイルエラーが発生する可能性があります。コマンドやパックを管理している場合は、公式のJava 1.21.5 リリースノートとJava 1.21.6 リリースノートをお読みください。

Bedrock Edition では、などのコマンドに異なる生テキスト JSON 構造が使用されます/tellraw。Microsoft のBedrock 生 JSON テキストリファレンスには、オブジェクトの詳細が記載されていますrawtext。Bedrock に貼り付けられた Java テキストコンポーネント、または Java コマンドに貼り付けられた Bedrock ペイロードは、句読点が正しく見えても失敗する可能性があります。

2つのコマンドペインでは、Java 1.21.5以降のSNBT構文とBedrockの生テキストJSON構文を比較します。 — Java版とBedrock版のコマンドは異なるテキスト形式を使用します。例文は、使用するエディションとバージョンに合わせてください。

2. メッセージを小さなテストに縮小する

スタイル、クリックイベントとホバーイベント、セレクター、翻訳、および余分なテキストを一時的に削除します。まずプレーンなメッセージでテストし、その後、一度に1つの機能を追加します。例：

Java 1.21.5以降： /tellraw @s {text:'Hello',color:'green'}
Java 1.21～1.21.4: /tellraw @s {"text":"Hello","color":"green"}
基盤： /tellraw @s {"rawtext":[{"text":"Hello"}]}

これらはエディション固有の例であり、互換性のあるテンプレートではありません。単純なテストは成功しても完全なメッセージで失敗する場合は、失敗する部分が戻ってくるまで、元のフィールドを1つずつ追加してください。リソースパックにJSONファイルが含まれている場合は、そのファイルをJSONとして検証してください。中括弧の一致、ストレート引用符、フィールド間のカンマ、最後のフィールドの後にカンマがないことを確認してください。JSONバリデーターはJavaの新しいSNBTコマンド構文を検証できないため、JSON専用ツールを使用してSNBTコマンドを判断しないでください。

コードエディタは、MinecraftのテキストJSONオブジェクト内で末尾のカンマがフラグ付けされていることを、その後に修正されたオブジェクトを表示します。 — 末尾のカンマはJSONファイルを破損させる可能性があるため、影響を受けるファイルが実際にJSONファイルである場合にのみ削除してください。

3. リソースパックとフォントの問題を特定する

文字が空白の四角、疑問符、または奇妙な記号として表示される場合は、ファイルを編集する前にデフォルトのフォントをテストしてください。Minecraft のリソースパック設定でアクティブなリソースパックを無効にし、ワールドを再読み込みして、同じテキストを再度確認してください。正常にレンダリングされる場合は、パックを 1 つずつ有効にして、Minecraft のフォントの不具合の原因となっているパックを特定します。元のパックは変更せずに残しておき、後で復元できるようにしてください。

カスタムJavaフォントの場合は、パックのパスにあるフォント定義を調べassets/<namespace>/font/、各プロバイダが既存のテクスチャまたは有効なフォントリソースを指していることを確認してください。名前空間、ファイル名、大文字小文字の区別、および文字マッピングを確認してください。プロバイダは正しくロードされていても、テスト対象の文字のグリフが欠落している場合があります。基本的なラテン文字と比較し、欠落している文字を単独でテストしてください。すべてのフォントパックが同じファイル名またはプロバイダタイプを使用しているとは限らないことに注意してください。

また、パックがゲームのリリース版と互換性があるかどうかも確認してください。リソースパックのフォーマットはリリースごとに変更される可能性があり、以前のバージョンで動作していたパックでもアップデートが必要になる場合があります。カスタムグリフのみが失敗する場合は、フォントプロバイダーとその参照アセットに注目してください。パック内のすべてのテキストが失敗する場合は、パックのJSONと互換性メタデータも確認してください。

リソースパックのファイルビューでは、参照されているグリフテクスチャの横にフォント定義が表示され、パスとマッピングを確認できます。 — フォント定義と参照されているグリフアセットの両方がパック内に存在することを確認してください。

4. 問題がローカル側かサーバー側かを確認します。

シングルプレイヤーワールドと影響を受けるサーバーの両方で、同じ短いメッセージを表示してください。オンライン時のみ問題が発生する場合は、サーバー所有者にサーバーのバージョン、最近のプラグインまたはMODの変更、チャットフォーマットの設定、およびサーバーログを確認するよう依頼してください。テキストが両方の場所で失敗する場合は、ローカルコマンド、リソースパック、MOD、またはゲームファイルに注目してください。Java版では、ランチャーで選択されるゲームディレクトリが異なる場合があります。logs/latest.log問題を再現した後、そのインストールディレクトリを調べて、関連する最初の構文解析またはフォント警告を探してください。後続のログ行では、元の失敗が繰り返されるだけかもしれません。

クライアント側のMODやカスタムパックは、テストごとに1つずつ無効にしてください。可能であれば、別のランチャーインストールまたはプロファイルを使用し、どのコンポーネントが原因かが判明するまで、メインの設定からファイルを削除しないでください。サーバーメッセージに接頭辞や書式付きの名前が含まれている場合、サーバー管理者はその書式設定ルールを追跡する必要があるかもしれません。個人のフォントファイルを変更しても、サーバーが生成した文字列は修復されません。

比較してみると、ローカルワールドではチャットが読みやすいが、マルチプレイヤーではグリフが欠落しており、ログペインが別になっていることがわかる。 — 同じテキストがローカル環境では正常に動作するのに、オンラインでは動作しない場合は、サーバーの書式設定またはバージョンパスを調査してください。

症状と考えられる原因を一致させる

表示されているもの	可能性のある領域	最初の有用なテスト
コマンド実行後の解析エラーまたはコンポーネントエラー	エディション/バージョンの構文、引用、またはコンポーネントの形式が間違っています。	上記のエディション固有のプレーンテキストコマンドを実行してください
数文字の代わりに四角や疑問符	リソースパックにフォントプロバイダー、グリフマップ、またはアセットが不足しています。	パックを無効にしてから、影響を受けるキャラクターを1体テストしてください。
サーバーチャットのみ、文法が崩れています。	サーバーバージョン、プラグイン、モジュール、またはチャットフォーマットの設定	ローカル環境で同じメッセージを比較し、管理者にログの調査を依頼してください。
看板や本の中で文字が途切れている	行折り返し、レイアウト、書式設定、または版固有の制限	短いプレーンテキストを試してみて、徐々に書式設定を戻していくと良いでしょう。

次のMinecraftのテキストエラーを防ぐ

トラブルシューティングを行う前に、エディション、バージョン、および有効なパックまたはMODのリストを記録してください。
編集したJSONファイルとリソースパックは、変更を元に戻せるように、クリーンなコピーを保存しておいてください。
JSON検証はJSONファイルに対してのみ使用してください。SNBTコマンドをテストするには、正しいゲームバージョンを使用してください。
サーバーやパックをアップデートする際は、複数のコンポーネントを一度に変更する前に、リリースノートと互換性情報を確認してください。
看板や書籍の場合は、まず短いシンプルなメッセージでテストしてください。表示内容の制限は版やバージョンによって異なるため、一律の文字数制限に頼らないようにしましょう。

最小限のテストでテキストが正しく動作することが確認できたら、スタイル設定とカスタムアセットを少しずつ復元していきます。そうすることで、Minecraftのチャットエラー、グリフの欠落、テキストコンポーネントの不具合などを、ワールドを危険にさらしたり、正常に動作しているパックを削除したりすることなく、はるかに簡単に特定できるようになります。