JAVA版のAI接続ガイド
Verity ModのAI設定
Verity JEには、Minecraftの導入だけでなくAIへの接続も必要です。プロバイダーを1つ選び、導入したバージョンの手順に従って、まず短いテキストの返答を確認しましょう。マイク入力と音声出力は、その後に設定します。
最初に確認
Verityのバージョンに合った手順を選ぶ
01導入したJARを確認してください。安定版5.7.4とテスト版6.0.0-beta.9は、どちらもMinecraft 1.20.1のForge向けです。そのファイルが必要とする依存Modを、対応するGeckoLibを含めて導入します。Minecraftが別の依存Modの不足を報告した場合は、AI設定より先に解決してください。ワールドが読み込めないなら、必要なのはインストールの確認であり、新しいキーではありません。
CurseForgeからは、Varmiteの「Verity JE Modの完全設定ガイド | 6.0.0+」にアクセスできます。beta.9ではAI設定が変更されています。以前のリンク先動画は5.7.4より前のバージョン向けなので、設定項目がそのまま一致するとは限りません。安定版5.7.4の更新内容には、Groqのモデルが見つからない問題の修正が記載されています。
| 導入したバージョン | 設定時の注意点 |
|---|---|
| Java 5.7.4 安定版 | このバージョンの設定を使い、6.xの画面を確認せずにコピーしないでください。 |
| Java 6.0.0-beta.9 | 6.0.0+の動画を参照し、beta.9で変更された設定も確認してください。 |
| 旧NeoForge版3.4.1 | Minecraft 1.21.1の別系統です。Forgeの設定をそのまま移さないでください。 |
| Bedrockアドオン | 別プロジェクトにそれぞれの手順があります。このJava版AIガイドは適用されません。 |
Java版の公式プロジェクトと設定リンク ↗ · 5.7.4の更新内容 ↗ · 6.0.0-beta.9の更新内容 ↗ · 先にVerityを導入する →
接続は1つずつ
Groq・OpenRouter・ローカルOllamaから選ぶ
02GroqとOpenRouterには、インターネット接続、自分で発行したプロバイダーのキー、利用可能なモデルが必要です。利用制限やモデル一覧は変わることがあります。ローカルOllamaはダウンロードしたモデルを自分のPCで実行します。Minecraft用のメモリと処理能力も残してください。
6.0.0+の動画では、3つの方法が紹介されています。まず1つだけ試しましょう。以下のアドレスは参考値です。ベースURLとチャット要求の完全な送信先は異なります。導入したバージョンの手順が求めるアドレス形式を使ってください。
- クラウド:ダウンロードサイトの共有キーではなく、選んだプロバイダーで自分のキーを発行します。
- ローカル:Ollamaを導入し、モデルをダウンロードして、Minecraftの外で返答できることを確認します。
- VerityMod.linkにAPIキーを入力しないでください。このサイトではキーを必要とせず、検証もしません。
クラウドで使う
Verity AIでGroqを設定する
03Groqのコンソールでキーを発行し、導入したバージョンのGroq設定に入力してください。OpenRouterのキーとは別です。以下のAPIベースアドレスは比較用であり、動作しているプリセットのアドレスがもっと長くても、必ずしも誤りではありません。
自分のアカウントで利用できるモデルを選びます。表示上の名称ではなく、API識別子をコピーしてください。モデルが見つからないエラーでは、Groqのモデル資料とVerityの更新内容を照合します。有効なキーでも、提供終了したモデルは復活しません。
- Groqのコンソールを開き、自分のAPIキーを発行します。
- 最新のモデル一覧と、選んだモデルへのアカウントのアクセス権を確認します。
- 対応するVerity設定動画のGroq部分に従い、キーを他人に見せずに入力して設定を保存します。
- テスト用ワールドで短いテキストを1回送信し、返答を待つか、表示された正確なエラーを記録します。
https://api.groq.com/openai/v1 Groqのキーと最初のリクエストの資料 ↗ · Groqの現在のモデル識別子 ↗ · Groq APIのベースアドレス ↗
クラウドで使う
6.xでOpenRouterを設定する
04Varmiteの6.0.0+動画のOpenRouter章を使ってください。安定版5.xにも同じ操作項目があるとは限りません。OpenRouterでキーを発行し、モデル一覧から完全なモデルIDをコピーします。プロバイダーの接頭辞や、派生モデルの接尾辞も省略しないでください。
キーの利用額上限を設定し、モデルが有料か確認します。無料モデルにも制限があります。残高不足のエラーでは、Minecraftの設定を変える前に、アカウント残高とキーの上限を両方確認してください。
- OpenRouterのキーを発行し、許容できる利用額上限を設定します。
- 利用可能なテキストモデルを選び、正確なモデルIDをコピーします。
- 自分の6.xバージョンで示されているOpenRouter設定を使い、そのプロバイダーのキーとモデルを組み合わせます。
- 設定を保存し、Groqと同じ短いテキストで返答を確認します。
https://openrouter.ai/api/v1 OpenRouterのモデルとリクエストのガイド ↗ · OpenRouterのキー・制限・認証 ↗ · OpenRouterのモデル一覧 ↗
ローカルで使う
Minecraftを開く前にOllamaを起動・確認する
05公式のOllamaをダウンロードして起動します。PCの性能に合ったローカルモデルをダウンロードし、先にOllamaでテストしてください。ローカルAPIは通常、認証なしでhttp://localhost:11434を使います。Ollamaのクラウドサービスは別の利用方法であり、ローカル実行にはクラウド用のキーは不要です。
以下のコマンドをターミナルで実行します。YOUR_MODEL_TAGは、ollama lsで表示されたモデルの正確な名前に、タグも含めて置き換えてください。YOUR_MODEL_TAG自体はモデル名ではありません。返答を待ち、/byeでチャットを終了し、Minecraftが使っている間はOllamaを起動したままにします。
そのモデルを使い、6.x向けのOllama章に従ってください。古いプロキシ手順と混在させないでください。安定版5.xでは、その系統で案内されている接続方法を使います。リモートサーバー上のlocalhostは、そのサーバー自身を指し、自分のPCではありません。
ollama ls ollama run YOUR_MODEL_TAG ollama ps 公式Ollamaをダウンロード ↗ · Ollamaのコマンド資料 ↗ · ローカルとクラウドの認証の違い ↗ · Ollamaのモデル取得と最初の返答 ↗
動作確認
音声を試す前にテキストの返答を確認する
06使い捨てのシングルプレイ用ワールドを作り、自分のバージョンで示された会話方法を使います。「こんにちは、Verity」と話しかけてください。何度も送信せずに待ちましょう。クラウドの制限やローカルモデルの読み込みがあると、連続した再試行では原因を判断しにくくなります。
成功の目安は、キャラクターが見えることではなく、内容に合ったテキストの返答です。動作したバージョン、プロバイダー、モデルを記録し、キーは記録しないでください。プロバイダー単体では返答できるのにVerityではできない場合、保存した設定と対応バージョンを再確認します。
テキストが動いてから
マイク入力と音声出力を別々に追加する
07音声認識はマイクの音をテキストにし、音声合成は返答を読み上げます。どちらもテキストモデルとは別の機能です。自分のバージョンの音声設定に従い、入力・出力デバイスを確認して、片方ずつテストします。最初は任意の音声アドオンを追加しないでください。
プロジェクトによるとAIは複数の言語に対応していますが、音声認識と音声合成のテストは英語のみです。簡単な英語のフレーズを試してください。テキストが動いて音が出ない場合は、動作しているAI設定を維持し、音声を調べましょう。
返答がない場合
プロバイダーを変える前にエラーを読む
08以下は最初の確認項目であり、原因を断定するものではありません。正確なエラーと、それを起こした操作を記録してください。スクリーンショットやログを共有する前に、APIキー、トークン、非公開の接続先、個人情報を隠します。キーが漏れた場合は、プロバイダーで無効化し、新しいキーを非公開で発行してください。
| エラー・症状 | 最初に確認すること |
|---|---|
| 401 / 無効なキー | 正しいプロバイダーか、キーが全部入力されているか、無効化されていないか。 |
| 403 / アクセス拒否 | アカウントの権限、モデルへのアクセス、プロバイダーの制限メッセージ。 |
| 429 / リクエスト制限 | 連続送信を止め、プロバイダーの再試行案内と利用制限に従う。 |
| 503 / 529 / 利用不可 | プロバイダーの稼働状況。時間を置いてから1回だけ再試行する。 |
| モデルが見つからない | APIモデルの正確な識別子、または取得済みOllamaモデルのタグ。 |
| Ollama null / 接続失敗 | Ollamaが起動中か、サービスに接続できるか、ローカルモデルが返答するか。 |
プレイヤーからの質問
Verity Mod よくある質問
01 VerityにAPIキーは必要ですか? +
GroqとOpenRouterには、自分のプロバイダーキーが必要です。OllamaのローカルAPIは認証不要ですが、モデルをダウンロードし、Ollamaを起動しておく必要があります。Verityのバージョンごとに案内された接続方法を使ってください。
02 6.0.0+の動画をVerity 5.7.4にも使えますか? +
安定版5.7.4と設定項目が一致するとは限りません。動画は6.0.0+向けで、beta.9ではAI設定が変更されています。以前のリンク先動画も5.7.4より前のバージョン向けです。変更する前に、導入したバージョンの設定と更新内容を確認してください。
03 Ollamaアプリでは動くのに、Verityでは動かないのはなぜですか? +
モデルの正確なタグ、ローカルサービスのアドレス、Verityの系統に合った接続方法を確認し、Ollamaを起動したままにしてください。Minecraftが別のマシンで動いている場合、そのlocalhostは自分のPC上のOllamaを指しません。
04 この手順はVerity Bedrockにも使えますか? +
いいえ。Utlover65のVerity BE (Official)とPnTMCのVerity — Bedrock Editionは別々のアドオンです。Java Forgeの設定ではなく、導入したBedrockパッケージの作者が示す手順を使ってください。