JAVA版のAI接続ガイド

Verity ModのAI設定

Verity JEには、Minecraftの導入だけでなくAIへの接続も必要です。プロバイダーを1つ選び、導入したバージョンの手順に従って、まず短いテキストの返答を確認しましょう。マイク入力と音声出力は、その後に設定します。

設定情報の確認日:2026年10月8日

最初に確認

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.96.0.0+の動画を参照し、beta.9で変更された設定も確認してください。
旧NeoForge版3.4.1Minecraft 1.21.1の別系統です。Forgeの設定をそのまま移さないでください。
Bedrockアドオン別プロジェクトにそれぞれの手順があります。このJava版AIガイドは適用されません。

Java版の公式プロジェクトと設定リンク ↗ · 5.7.4の更新内容 ↗ · 6.0.0-beta.9の更新内容 ↗ · 先にVerityを導入する →

接続は1つずつ

Groq・OpenRouter・ローカルOllamaから選ぶ

02

GroqとOpenRouterには、インターネット接続、自分で発行したプロバイダーのキー、利用可能なモデルが必要です。利用制限やモデル一覧は変わることがあります。ローカルOllamaはダウンロードしたモデルを自分のPCで実行します。Minecraft用のメモリと処理能力も残してください。

6.0.0+の動画では、3つの方法が紹介されています。まず1つだけ試しましょう。以下のアドレスは参考値です。ベースURLとチャット要求の完全な送信先は異なります。導入したバージョンの手順が求めるアドレス形式を使ってください。

  • クラウド:ダウンロードサイトの共有キーではなく、選んだプロバイダーで自分のキーを発行します。
  • ローカル:Ollamaを導入し、モデルをダウンロードして、Minecraftの外で返答できることを確認します。
  • VerityMod.linkにAPIキーを入力しないでください。このサイトではキーを必要とせず、検証もしません。

Varmiteによる公式6.0.0+設定動画 ↗

クラウドで使う

Verity AIでGroqを設定する

03

Groqのコンソールでキーを発行し、導入したバージョンのGroq設定に入力してください。OpenRouterのキーとは別です。以下のAPIベースアドレスは比較用であり、動作しているプリセットのアドレスがもっと長くても、必ずしも誤りではありません。

自分のアカウントで利用できるモデルを選びます。表示上の名称ではなく、API識別子をコピーしてください。モデルが見つからないエラーでは、Groqのモデル資料とVerityの更新内容を照合します。有効なキーでも、提供終了したモデルは復活しません。

  1. Groqのコンソールを開き、自分のAPIキーを発行します。
  2. 最新のモデル一覧と、選んだモデルへのアカウントのアクセス権を確認します。
  3. 対応するVerity設定動画のGroq部分に従い、キーを他人に見せずに入力して設定を保存します。
  4. テスト用ワールドで短いテキストを1回送信し、返答を待つか、表示された正確なエラーを記録します。
Groq APIのベースアドレス — 参考値
https://api.groq.com/openai/v1

Groqのキーと最初のリクエストの資料 ↗ · Groqの現在のモデル識別子 ↗ · Groq APIのベースアドレス ↗

クラウドで使う

6.xでOpenRouterを設定する

04

Varmiteの6.0.0+動画のOpenRouter章を使ってください。安定版5.xにも同じ操作項目があるとは限りません。OpenRouterでキーを発行し、モデル一覧から完全なモデルIDをコピーします。プロバイダーの接頭辞や、派生モデルの接尾辞も省略しないでください。

キーの利用額上限を設定し、モデルが有料か確認します。無料モデルにも制限があります。残高不足のエラーでは、Minecraftの設定を変える前に、アカウント残高とキーの上限を両方確認してください。

  1. OpenRouterのキーを発行し、許容できる利用額上限を設定します。
  2. 利用可能なテキストモデルを選び、正確なモデルIDをコピーします。
  3. 自分の6.xバージョンで示されているOpenRouter設定を使い、そのプロバイダーのキーとモデルを組み合わせます。
  4. 設定を保存し、Groqと同じ短いテキストで返答を確認します。
OpenRouter APIのベースアドレス — 参考値
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
モデルをテスト — YOUR_MODEL_TAGを置き換える
ollama run YOUR_MODEL_TAG
現在読み込まれているモデルを確認
ollama ps

公式Ollamaをダウンロード ↗ · Ollamaのコマンド資料 ↗ · ローカルとクラウドの認証の違い ↗ · Ollamaのモデル取得と最初の返答 ↗

動作確認

音声を試す前にテキストの返答を確認する

06

使い捨てのシングルプレイ用ワールドを作り、自分のバージョンで示された会話方法を使います。「こんにちは、Verity」と話しかけてください。何度も送信せずに待ちましょう。クラウドの制限やローカルモデルの読み込みがあると、連続した再試行では原因を判断しにくくなります。

成功の目安は、キャラクターが見えることではなく、内容に合ったテキストの返答です。動作したバージョン、プロバイダー、モデルを記録し、キーは記録しないでください。プロバイダー単体では返答できるのにVerityではできない場合、保存した設定と対応バージョンを再確認します。

テキストが動いてから

マイク入力と音声出力を別々に追加する

07

音声認識はマイクの音をテキストにし、音声合成は返答を読み上げます。どちらもテキストモデルとは別の機能です。自分のバージョンの音声設定に従い、入力・出力デバイスを確認して、片方ずつテストします。最初は任意の音声アドオンを追加しないでください。

プロジェクトによるとAIは複数の言語に対応していますが、音声認識と音声合成のテストは英語のみです。簡単な英語のフレーズを試してください。テキストが動いて音が出ない場合は、動作しているAI設定を維持し、音声を調べましょう。

プロジェクトの言語・音声に関する注意事項 ↗

返答がない場合

プロバイダーを変える前にエラーを読む

08

以下は最初の確認項目であり、原因を断定するものではありません。正確なエラーと、それを起こした操作を記録してください。スクリーンショットやログを共有する前に、APIキー、トークン、非公開の接続先、個人情報を隠します。キーが漏れた場合は、プロバイダーで無効化し、新しいキーを非公開で発行してください。

よくあるAI接続エラー
エラー・症状最初に確認すること
401 / 無効なキー正しいプロバイダーか、キーが全部入力されているか、無効化されていないか。
403 / アクセス拒否アカウントの権限、モデルへのアクセス、プロバイダーの制限メッセージ。
429 / リクエスト制限連続送信を止め、プロバイダーの再試行案内と利用制限に従う。
503 / 529 / 利用不可プロバイダーの稼働状況。時間を置いてから1回だけ再試行する。
モデルが見つからないAPIモデルの正確な識別子、または取得済みOllamaモデルのタグ。
Ollama null / 接続失敗Ollamaが起動中か、サービスに接続できるか、ローカルモデルが返答するか。

Verity Modの詳しいトラブル対処 → · Groqのエラー解説 ↗ · OpenRouterのエラー解説 ↗

プレイヤーからの質問

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パッケージの作者が示す手順を使ってください。

CURSEFORGE ダウンロード

CurseForgeで開く

選択中のVerityプロジェクト

続行する前に、プロジェクト、Minecraftのバージョン、ファイル名を確認してください。