自動ベータゲームプロファイル

Automatic beta game profiles

任意のベータ検索では、新しいゲームビルドを保存済みのサポート対象バージョンと比較します。必要な証拠がそろった場合に限り、完全なベータプロファイルを作成します。一致する通常のゲームプロファイルが優先されます。

ゲームを更新する前の準備

このモジュールはデフォルトで有効ですが、無効にできます。無効の状態を明示的に保存した場合は、そのまま無効になります。スイッチはプロファイル選択の隣にある Settings → General → Game profile にあります。

Dynamic game profile creation (Beta) が有効か確認します。必要ならオンにします。
一致する通常プロファイルがまだ利用できる間に、ゲームまたは専用サーバーを完全に再起動します。
ShroudForge は現在の実行ファイルを正確に検証し、比較用の基準としてキャッシュに保存します。過去の実行ファイルをダウンロードする必要はありません。
その後ゲームが更新されると、新しいゲームプロセスが自動的に比較を開始し、保存済みの基準を使います。

クライアントと専用サーバーは別々の基準を保持します。クライアントからサーバーの基準を置き換えることはできません。更新後に初めてモジュールを有効にし、一致する基準が保存されていなかった場合、以前のバージョンを再構築できません。

ゲーム起動時の動作

分析はゲームの起動中に実行されます。起動を続ける前に、ゲームは結果を待ちます。この段階ではワールドをロードする必要はありません。

ShroudForge はまず、実行中の正確な実行ファイルに一致する通常プロファイルを探します。存在する場合、自動選択はそのプロファイルを使います。検索が有効なら、将来の更新に備えてサポート対象の実行ファイルもキャッシュします。

一致する通常プロファイルがない場合、同じ対象プロセスと KFC 形式に対応する最新の適切な通常基準を確認します。以前にキャッシュされた実行ファイルは、その基準と完全に一致する必要があります。比較イメージを使って、コード、参照、登録済み型、必須の構造契約を比較します。対象アドレスは新しいイメージから確定する必要があります。

結果には機能フラグを含む以前のプロファイル契約全体が保持されます。証拠が未解決または競合している場合、ベータプロファイル全体の公開が止まります。診断に理由が表示されます。長く待ったりワールドに入ったりしても、欠けている静的証拠は解決しません。

保存場所と選択

通常プロファイルと生成プロファイルは、設定されたプロファイルディレクトリを共有します。デフォルトのパスは次のとおりです。

内容	場所
クライアントプロファイル	`shroudforge/runtime/profiles/enshrouded/client/`
サーバープロファイル	`shroudforge/runtime/profiles/enshrouded/server/`
保存された比較イメージと証拠	`shroudforge/cache/game-profile-discovery/`

生成プロファイルの名前は beta_ で始まります。一致する通常プロファイルがない場合、Automatic は完全に検証された一致するベータプロファイルを使用できます。プロファイル選択には利用可能なプロファイルが表示されます。後から追加された一致する通常プロファイルが優先されます。

スイッチまたはプロファイル選択を変更した場合、対象のゲームまたはサーバーを完全に再起動する必要があります。Modloader ウィンドウを開き直してもランタイムは再起動しません。

検索、プロファイル、実行中のワールドの違い

青色の Dynamic profile search in progress 通知は、プロファイル検索中であることを示します。Workflow and help を開くとこのガイドが表示されます。一致するプロファイルが見つからずに検索が終わると、問題が赤色で表示されます。オレンジ色の Experimental game profile active 通知は、実際に選択されているベータプロファイルを示します。実際のランタイムエラーは引き続きエラーとして表示されます。

実行ファイルの構造チェックにワールドのロードは必要ありません。ワールド依存の操作には、さらに実行時のコンテキスト、登録、ランタイムの安全チェックが必要です。生成プロファイルがあっても、ゲームコマンドが実行されたことや目に見える効果があったことは証明されません。機能確認ではクライアントとサーバーを別々にテストする必要があります。

プロファイルが生成されない場合は、報告された理由と技術的な詳細を確認してください。保存済み基準の不足、不適切なソースプロファイル、コードや配置の証拠が未解決であることには、それぞれ該当する入力または追加分析が必要です。一致する通常プロファイルや適切な ShroudForge の更新で対応できる場合があります。

詳細ログ

Debug Console では、メインログの検索メッセージを game-profile-discovery ソースから表示できます。すべての比較項目とリベース項目を見るには、Settings → General → Logging → Minimum level を Diagnostic に設定します。Advanced では追加の概要が表示されます。

赤色のランタイムバナーとログ項目 [compatibility-check] check=runtime は同じランタイムチェックから出力されます。既存の UI 更新処理は、同じ状態を Modloader に送信する前に状態変更をログに記録します。Debug Console はメインログの警告とエラー行に既存のポップアップ設定を適用します。

失敗時には、メインログに現在の .v2.unresolved.json または .v2.error.json レポートのパスが記録されます。成功時には .v2.proof.json 証拠のパスと、生成された beta_.json プロファイルの完全な保存先が記録されます。レポートは検索キャッシュに保存されます。

Linux と Proton

検索はネイティブランタイムモジュール内で実行され、外部の PowerShell または Python プログラムは不要です。このワークフローは Proton 上でまだ実機テストされていません。

ランタイム、Mod API、パーサーについてはエンジンを参照してください。