Verity Mod セットアップ: Java・AI・音声チェックリスト

追加要素の前にJavaの基準を選ぶ

最初にエディションとローダーを決めます。ここで扱うのはJava版です。確認済みのVerity JEはMinecraft 1.20.1 Forge向けの.jarプロジェクトです。BedrockとMCPEはパッケージもインポート手順も違うため、JavaファイルをBedrock用として使わないでください。迷ったらエディション別インストールガイドを先に確認します。

初回は専用のランチャープロファイルまたはインスタンスを作ります。クリーンな環境なら、起動失敗、依存関係不足、Modの未検出を切り分けやすくなります。バージョン、Forge、ファイル名を公式Modrinthプロジェクトと照合してください。動画名やミラーだけでは互換性を証明できません。

Verity JEと必須依存関係を入れる

プロファイルができたら、公式ソースのファイルをそのインスタンスのmodsフォルダーへ置き、元の名前を保ちます。現在確認したファイルはverity-6.0.0-beta.6.jarです。展開したり名前を隠したり、関係のないインストーラーで包んだりしないでください。リリース情報にある必須プロジェクト依存関係は、Minecraft 1.20.1とForgeに合うGeckolibです。

最初はForge、Verity JE、Geckolibだけで起動します。ここで失敗したらAPIキーや音声パッケージを追加しません。ライブラリの境界は依存関係ガイド、ファイルとローダーはJavaガイドで確認できます。タイトル画面が出ても、AIや音声まで設定済みとは限りません。

AIを設定する前にModの読み込みを確認する

重要なチェックポイントはローカルです。Minecraftが開き、プロファイルがModを認識し、新しいワールドでVerityの要素が確認できる状態を先に作ります。beta.6には専用サーバーのAIエラー修正がありますが、プロバイダーやモデル、ホストが自動設定されるわけではありません。Minecraft層とプロバイダー層を分けてください。

プロジェクト説明には黄色い知的な球体が示されています。イベントやインベントリの挙動はリリースで変わる可能性があります。ローカル起動後にリクエストだけ失敗するなら、キー、モデル、401/429を扱うVerity AI設定ガイドへ進みます。秘密のキーをログや画像に貼らないでください。

• プロバイダーを試す前にローカル読み込みを確認する。
• 最初は短いテキスト入力にして応答を調べる。
• APIキーはプロバイダー設定であり、.jarやGeckolibではない。
• betaのノートは変更点を示すが、イベントの発生時刻を保証しない。

AI層は別のチェックとして追加する

ローカルワールドが開いてから、現在のプロジェクト手順に従ってAIプロバイダーを設定します。認証情報、モデル、短い入力、正確な応答またはエラーの順に確認すると切り分けやすくなります。401は認証、429は制限やクォータを示すことが多く、エンティティが無反応でも依存関係不足とは限りません。

beta.6のチェンジログにはデフォルトTTSのローカル化とAIプロンプト更新があります。古い動画の設定ファイルをそのままコピーせず、AI設定ガイドとbeta.6の公式版ページを確認してください。

テキストが動いてから音声を追加する

音声はVerity JEの読み込みに必要な前提ではありません。短いテキスト入力が成功した後、マイク権限、入力デバイス、音声認識、TTSを1つずつ確認します。そうすれば、マイク、音声サービス、プロバイダー、Minecraftのどこが原因かを分けられます。

「Verityと話す」という検索は、エンティティとの操作、AIリクエスト、音声で返答を聞くことを混同しがちです。マイク、TTS、Voice Chatの問題は音声設定ガイドで扱います。

クライアントが動いてからサーバーを準備する

マルチプレイでは、Minecraft、Forge、Verityのリリース、依存関係、ファイル環境が両側でそろう必要があります。公開メタデータだけで、すべてのホストがすべてのbetaを受け入れるとは言えません。サーバーが起動したことも、全環境への対応証明ではありません。

シングルプレイが動いてから小さなテストサーバーを使います。両側を項目ごとに比較し、新しいワールドを作ってサーバーログを確認してください。ホストがプロジェクトやローダーを示さないなら、未知の再配布ファイルで補わず、その境界で止まります。詳しくはマルチプレイガイドへ進みます。

無作為な修正ではなく停止・進行チェックを使う

失敗したら、最後に確認できた層へ戻ります。ランチャーが閉じるならJavaと依存関係を確認し、ワールドは開くのにVerityがないならインスタンスとログを調べます。エンティティは出るがプロバイダーが失敗するならAIへ、テキストは動くが音がないなら音声へ進みます。シングルプレイだけ動くならクライアントとサーバーを比較します。

この方法は一括置換ファイルを探すより、版、ファイル名、ローダー、最初のエラー行、最後の変更という再利用できる証拠を残せます。beta.6はbetaなので、更新の前に公式リリース一覧を再確認してください。

• 進行: クリーンなプロファイルで現在の層が動く。
• 停止: エラーが前の層にあるなら、まずそこを直す。
• 記録: 版、ファイル、ローダー、最初のエラー行を残す。
• リセット: 大きなModpackやサーバーの前に新しいワールドを使う。
• 再確認: betaが変わったら公式プロジェクトを読み直す。

このセットアップガイドで確認したソース

• Modrinth公式Verity JEプロジェクト - プロジェクト、ローダー、公開ソースの確認。
• Verity JE beta.6版ページ - 公開日、Minecraft、Forge、チェンジログ、主ファイル。
• ModrinthバージョンAPI - 更新確認に使った機械可読メタデータ。