症状から原因を調べる
Verity Modが動かない? まず症状を確認
クラッシュ、チャットの無応答、マイクの不具合は別の問題です。エディション、プロジェクト、最後に成功した操作を確認し、変更は1つずつ試しましょう。ファイルを再導入しても、プロバイダーの停止や未対応の機能がすべて解決するわけではありません。
最初の確認
設定を変える前に、どの段階で失敗するか調べる
01Minecraftのバージョン、ファイル名、作者を記録します。JavaのVerity JE、PnTMCのVerity — Bedrock Edition、Utlover65のVerity BE (Official)は手順が異なります。別のプロジェクトのコマンドを代用しないでください。
大切なワールドをバックアップします。使い捨てのワールドや別のランチャーインスタンスで試し、動いていたファイルを残してください。1つの項目だけを変え、同じテストを繰り返して結果を記録します。複数の設定を一度に変えると、原因が分からなくなります。
| 症状 | ここから確認 |
|---|---|
| Javaがタイトル画面の前に終了する | ローダー、ゲームのバージョン、依存Mod、ログの最初のエラーを確認。 |
| ワールドは読み込めるがAIチャットが動かない | 設定したプロバイダーまたはローカルサービスと、正確なエラーを確認。 |
| テキストの返答はあるが音声は動かない | マイク入力と読み上げを別々にテスト。 |
| PnTMCのBedrock版で接続が切れる | 端末用の補助プログラムを確認し、ワールド内で再接続。 |
| Utlover65のBedrock版が三点リーダーだけ返す | 案内されているバックエンドへの接続と稼働状況を確認。 |
JAVAが起動しない
ローダーの失敗とAIの失敗を区別する
02JEには現在、Minecraft 1.20.1向けのForge版と、1.21.1向けの旧NeoForge版が掲載されています。Fabricは掲載されていません。個々のリリース情報を確認してください。JARの名前を変えても、対応ローダーは変わりません。
GeckoLibがMinecraftのバージョンとローダーに合っているか確認します。YetAnotherConfigLibなど、別の依存Modが足りないとローダーが報告する場合は、そのリリースの要件に従ってください。無関係なプロファイルから適当な依存Modのバージョンを入れないでください。
- 選んだランチャーのゲームフォルダーを開きます。Verity JEのJARは1つだけ残し、安定版・ベータ版・旧版を混在させないでください。
- 何も追加していないインスタンスで、対応ローダー、Verity、案内された依存Modを試します。動くなら、ほかのModを少しずつ戻します。
- latest.logとクラッシュレポートを読みます。最終的な終了コードだけでなく、依存Mod不足、バージョン不一致、クラス読み込みに関する最初のメッセージを探します。
- エラーを保存します。新しいインスタンスでも失敗するなら、その再現手順を報告してください。無関係なAI設定を変えても、ローダーの失敗は説明できません。
ゲームは動くがチャットは動かない
再導入を繰り返す前に、AIのエラーを確認する
03タイトル画面が出ても、AIが動くとは限りません。導入したJEの系統に合った動画に従ってください。6.0+の手順はすべての版に共通ではありません。プロバイダー、モデル、接続先、認証情報を他人に見せずに照合します。
作者が示すコードは調査の分類であり、原因を断定するものではありません。プロバイダー名と、秘密情報を隠したエラーを記録します。コードがない場合は、タイムアウトするのか、拒否されるのか、要求自体が始まらないのかを記録してください。
| コード | 確認すること | 次の対応 |
|---|---|---|
| 401 | キーが無効、期限切れ、または未入力 | 正しいプロバイダーの設定でキーを確認し、絶対に公開しない。 |
| 403 | 必要な権限や地域での提供状況 | プロバイダーのアクセス条件を確認。Minecraftのローダーエラーと混同しない。 |
| 429 | リクエストの頻度制限に到達 | 連続送信を止めて制限を確認。案内のある別の接続方法も検討する。 |
| 503 / 529 | サービスが利用できない | プロバイダーの稼働状況を確認し、後で再試行するか、対応する別のプロバイダーを設定する。 |
ローカルAI
Ollamaの初回読み込みと接続不良を区別する
04Minecraftより先にOllamaを試します。モデルの読み込みは応答時間に影響するため、最初の返答が遅いだけではVerityの設定ミスとは言えません。モデルが読み込まれていない状態の要求と、その次の要求を比較してください。
Ollamaは通常、127.0.0.1のポート11434で待ち受けます。同じPCでの確認はローカルのまま行ってください。最初の対処として、ルーターのポートを開けたり、サービスをインターネットに公開したりしないでください。
- Ollamaが起動していることを確認し、取得済みモデルの正確な名前とタグを設定と照合します。
- 短い要求を1回、Ollamaに直接送ります。失敗したら、そのエラーを先に調べます。
- 返答が成功したら、Minecraftで同じ要求を繰り返します。読み込み中に要求を重ねないでください。
- ollama psで読み込まれたモデルとCPU/GPUへの割り当てを確認します。最初だけ遅いのか、毎回遅いのかを記録します。
ollama ls
ollama ps テキストは動くが音声は動かない
テキスト・マイク入力・読み上げを別々に試す
05自分のプロジェクトの会話方法で、テキストを1回送ります。返答が来るなら、動作しているAI設定は維持し、音声だけを調べてください。
マイクの使用許可と入力デバイスを確認し、Minecraftの外でテストします。読み上げについては、出力デバイスと自分のバージョンの音声設定を確認します。話した内容は受け取られているのに音声が出ないのか、内容自体が受け取られていないのかを報告してください。
JEのAIテキストは複数の言語に対応していますが、作者が音声認識と音声合成をテストしたのは英語のみです。音声の問題を報告する際は、短い英語のテスト結果も添えてください。
BEDROCK:PNTMC専用
4.0の補助プログラムを確認し、ワールドで再接続する
06PnTMCの4.0では、同じ端末上でプラットフォーム別の補助プログラムを使います。.mcaddonを読み込むだけでは不十分です。補助プログラムのファイルは作者のガイド経由で取得してください。
ガイドではWebSockets、Beta APIs、Cheatsが必要とされています。端末ごとの接続設定を慎重に確認し、安易にセキュリティ機能を無効にしたり、ネットワークへのアクセスを広げたりしないでください。
- 端末用の補助プログラムが動いているか確認します。停止していたら、表示されたエラーを読みます。
- ワールド設定を確認してワールドに入り、以下のlocalhost用コマンドを実行します。ワールドに入り直したら再接続してください。
- iOSのaShellでは、通常どおり文字を入力してチャットできます。マイク入力と!talkは未対応であり、追加の使用許可を与えても利用できません。
/connect 127.0.0.1:3000 BEDROCK:UTLOVER65専用
三点リーダーと会話欄の欠落は別々に確認する
07Utlover65のFAQでは、三点リーダーだけの返答はデバッガー接続の未実施、またはバックエンドの問題と説明されています。現在のコマンドは、このプロジェクトの動画やサポートで確認してください。PnTMCのlocalhostコマンドは代用できません。
会話欄が出ない場合は、Beta APIsが無効か、アドオンが古い可能性があります。ワールド設定と導入版を確認してください。このプロジェクトはCheatsが必要です。テキストの会話ではVerityと入力し、その後にメッセージを続けます。
以前動いていた設定が三点リーダーだけ返すようになったら、何度も読み込み直す前にバックエンドの状態を確認します。最後に動いた時期と、新しいテスト用ワールドでも同じ症状が出るかを報告してください。
確認しても解決しない場合
再現できる短い報告を、秘密情報を隠して送る
08該当する作者のサポート窓口を使ってください。この独立サイトでは、アカウントの復旧や外部バックエンドの修復はできません。最後に成功した手順と、最初に失敗した手順を説明します。
ログや画面から、APIキー、認証ヘッダー、トークン、非公開の接続先、ユーザー名、個人のフォルダー情報を隠してください。エラーコードと秘密情報を含まない文脈は残します。漏れたキーはプロバイダーで無効化または再発行してください。投稿を削除するだけでは不十分です。
- エディション、作者、Verityのファイル名とバージョン、Minecraftのバージョン、該当する場合はJavaのローダー。
- OSと正確な症状:クラッシュ、チャット、遅い返答、マイク、音声出力。
- 最短の再現手順と、新しいインスタンスまたはOllama単体でのテスト結果。
- 秘密情報を隠した正確なエラー、latest.logまたはクラッシュレポート、PnTMC補助プログラムのエラー。
- 動いていた時点からの変更と、試した各確認の結果。
プレイヤーからの質問
Verity Mod よくある質問
01 AIチャットが止まったらVerityを再導入すべきですか? +
必ずしもそうではありません。まずローカルの読み込み問題とプロバイダーのエラーを区別してください。同じファイルを再導入しても、拒否された認証情報や停止中のバックエンドは変わりません。
02 Bedrockの接続コマンドはどれでも使えますか? +
いいえ。接続手順を使う前にプロジェクトの作者を確認してください。PnTMCのローカル補助プログラムとUtlover65のバックエンドでは、設定手順が異なります。
03 サポートに設定を全部共有すべきですか? +
先に確認し、キー、トークン、非公開の接続先、個人情報を削除してください。共有するのは正確なエラーと、関係する秘密情報を含まない設定であり、認証情報ではありません。
04 マイクのテスト失敗はAIの故障を意味しますか? +
いいえ。先にテキストの会話を確認し、その後でマイク入力と音声出力を別々に試してください。動くAIキーを変えても、そのプラットフォームが未対応の機能は使えるようになりません。