R.E.P.O. Host Suite

0.1.0 公開アルファ版
ソースのビルド、状態機械テスト、静的安全検査、IL監査は完了しています。実ゲームと実マルチでの通し確認は継続中のため、下記の検証状況と互換性注意を確認してください。

ホストだけに導入して、通常のR.E.P.O.へ次の4つをまとめて追加するオールインワン・パッケージです。

• 1レベルごとの短い契約
• 敵・戦利品に関するランダム異常イベント
• 既存アイテムを利用する特殊装置
• チーム全体・人物別のスキル管理

Thunderstoreでは1パッケージとして配布します。内部は、障害の切り分けと設定の独立性を保つため、次の2つのBepInExプラグインに分かれています。

RepoHostSuite
├─ YoneRai12.AnomalyContractDirector.dll  0.2.0
└─ YoneRai12.HostSkillManager.dll         1.0.0

利用者はこのパッケージを1回インストールするだけです。機能は設定から個別にON/OFFできます。

誰が導入するか

このパッケージ本体はホスト側だけに導入します。通常の参加者は本パッケージを導入する必要がありません。

ただし、SelfReviveなど第三者の追加スキルをHost Skill Managerで管理する場合、その追加スキルMOD自体が参加者側導入を要求するかどうかは、追加スキルMOD側の仕様に従います。

1. 5種類の契約

契約はレベルごとに1件だけ実行します。物理トークン、ホストの標準チャット、または自動ランダムから選べます。

• 呪われた貨物: 指定された既存の貴重品を未完了の抽出地点へ運びます。
• 賞金首＋証拠回収: 既存敵を討伐し、別の既存貴重品を証拠として回収します。
• ブラックアウト復旧: 既存バッテリーをトラックまたは抽出地点へ運びます。照明状態そのものは強制変更しません。
• 抽出地点防衛: 未完了の抽出地点付近で、既存敵の脅威を受けながら設定時間を耐えます。
• 二地点同時起動: トラックと抽出地点など、既知の2地点へ分かれて同時に滞在します。

契約の候補不足、対象消失、時間切れは、契約だけを安全に失敗させます。抽出完了、RoundDirector、RunManager.ChangeLevelを止めたり、抽出地点の状態を書き換えたりしません。

2. 9種類のランダム異常イベント

契約とは独立して、レベルごとに0件または1件を抽選します。全体抽選率、各イベントの相対ウェイト、開始遅延、継続時間、同一イベントの連続防止を設定できます。

敵イベント

• 標的指定: 特定の敵個体だけを強化します。
• 同種群れの接近: 特定の敵種をまとめて強化します。
• 全敵地獄: 対象となる全敵を強化します。
• 再誘導ウェーブ: 標準生成プールと既存敵プールを使って追加ウェーブを作ります。
• 段階増加する脅威: 時間経過で脅威を段階的に増やします。
• 執拗な再出現: 標準の再出現経路を使い、再出現間隔を短縮します。設定値0秒にも対応します。

敵の実体数は標準生成分を含めて最大100体です。Photon View予約や既存プールが不足する場合は、イベント追加分だけを停止または縮退します。新しい敵Prefabは生成しません。

現在の敵強化対象は、標準EnemyHealth.Hurtに対する実効HP倍率と、標準EnemyNavMeshAgent.UpdateAgentに対する速度・加速度倍率です。敵サイズ、敵Type、全体攻撃ダメージ、healthCurrentの直接書き換えは現版では行いません。

戦利品イベント

• 金コスメ箱の気配: 既存コスメ箱を設定確率でUltraRareへ昇格します。箱数は増やしません。
• 紫コスメ箱の気配: 既存のCommon / Uncommon箱を設定確率でRareへ昇格します。
• 貴重品大量発生: 未使用の標準Volumeがある場合だけ、標準ValuableDirector.SpawnValuable経路で既存貴重品を追加します。

3. 既存アイテム装置

新しいPrefab、モデル、テクスチャ、専用HUD、専用キーを参加者へ追加しません。ホストが既存アイテムのPhoton View IDへ、そのレベル中だけ役割を割り当てます。

• 大型医療コア: 停止して置かれた既存回復アイテムの周囲を、設定した半径・量・間隔で標準HP回復します。
• 携帯レーダー: 既存トラッカー等の周囲にある未発見貴重品を、ゲーム標準のDiscover経路で既存マップへ表示します。
• ノイズビーコン: 既存トグル付きアイテムがONの間、標準EnemyDirectorの調査地点を誘導します。

適切な候補アイテムを発見できない場合は、無関係なアイテムへ無理に割り当てず、その装置だけを無効化します。

4. ホストスキル管理

標準スキルと、検出できるREPOLib追加スキルをホスト側から管理します。

• 購入したスキルをチームへ共有
• スキルごとの共有ON/OFF、配布量、共有確率
• チーム全員の正確な目標レベル
• 接続済みSteam IDごとの人物別目標レベル
• 途中参加者をチーム内の最大値へ同期
• REPOConfigまたはBepInEx設定ファイルの変更をプレイ中に反映

人物別の値は次の意味です。

-1      個別指定なし。チーム設定を使用
0       その人物の該当スキルを0にする
1～100  その人物だけを指定レベルにする

固定目標レベルは通常の購入共有より優先され、約3秒周期で再適用されます。変更を一時的に止めたい場合は、人物別を-1へ戻し、チーム固定をOFFにしてください。

コマンド

コマンドはホスト本人が標準チャットへ入力した場合だけ処理します。/acdはゲーム本体の入力と競合する可能性があるため、!acdだけを使用します。

!acd contract 1
!acd contract 2
!acd contract 3
!acd contract 4
!acd contract 5
!acd random
!acd status
!acd cancel

!acd event help
!acd event list
!acd event random
!acd event status
!acd event cancel
!acd event <標的/群れ/地獄/ウェーブ/増加/再出現/金/紫/貴重品>

Host Skill Managerには専用コマンドや専用キーはありません。設定画面またはBepInEx設定ファイルから変更します。

設定ファイル

初回起動後に、次の2ファイルが作成されます。

BepInEx/config/YoneRai12.AnomalyContractDirector.cfg
BepInEx/config/YoneRai12.HostSkillManager.cfg

REPOConfigは任意のクライアント側設定UIです。本パッケージはREPOConfigのDLLを同梱・再配布せず、REPOConfigがなくても通常のBepInEx設定ファイルだけで動作します。

人物別設定を作るため、接続したプレイヤーのSteam IDと最後に確認した表示名を、ホストPC上のYoneRai12.HostSkillManager.cfgへローカル保存します。これらを外部へ送信する通信処理はありません。設定ファイルやログを第三者へ共有する場合は、必要に応じて人物別セクションを削除してください。

主なON/OFFは次のとおりです。

AnomalyContractDirector:
  00 全般 / MODを有効
  10～14 契約 / 各契約を有効
  20～22 装置 / 各装置を有効
  30 ランダム異常イベント / 有効
  31～34 / 敵・コスメ箱・貴重品イベントの個別設定

HostSkillManager:
  00 全般 / 管理MODを有効
  00 全般 / 購入スキルを共有
  00 全般 / 新規参加者をチーム最大値へ同期
  00 全般 / 追加MODスキルも管理
  00 全般 / 設定変更をリアルタイム反映
  10～20 / スキル別設定
  30 人物別 - SteamID / 人物別設定

互換性と重要な注意

SharedUpgradesPlus

Host Skill Managerを有効にする場合は、SharedUpgradesPlusを同時に有効化しないでください。両方が同じ購入・共有経路へ介入すると、二重配布や固定値の上書き競合が起きる可能性があります。

敵数・敵生成変更MOD

EnemyDirector.AmountSetup、GetEnemy、PickEnemiesを置換または大幅変更するSpawnConfig、SpawnConfigPlus、TierSpawnConfig等との同時使用は未検証です。敵イベントを利用する場合は、重なる敵生成機能を片方だけ有効にしてください。

Repo Contracts

本MODはThunderstore上の「Repo Contracts」とは別プロジェクトであり、フォークではありません。同MODのコード、DLL、アセット、契約TV、トラック契約ボード、投票UI、専用HUDを含みません。本MODは標準チャットと既存ゲームオブジェクトを使うホスト専用の異常・契約レイヤーです。

R.E.P.O.-Configurator

R.E.P.O.-Configuratorのコード、DLL、設定ファイル、アセットを同梱していません。貴重品追加処理は、ゲーム本体のValuableDirectorと標準Volume APIに対して独立に実装しています。同じゲームAPIへ介入するため、同時使用時のHarmony実行順は未検証です。

単体版との二重導入

次の単体DLLまたは単体パッケージとRepoHostSuiteを同時に導入しないでください。

YoneRai12.AnomalyContractDirector.dll
YoneRai12.HostSkillManager.dll

同じプラグインGUIDを二重に配置すると、BepInExのロードや設定が不定になる可能性があります。単体版から移行する場合、単体DLLだけを外してください。GUIDを維持しているため既存の設定ファイルはそのまま利用できます。

現版に含まれないもの

次の要望は、この0.1.0プレイテスト版にはまだ含まれていません。README上で実装済みのように見せないため、明示しています。

• ゲーム本体の途中参加制限を解除する機能
• 最大プレイヤー人数の変更
• ショップ購入品がトラックへ出る上限の変更
• チャットコマンドによる任意アイテム出現
• Haulerの自動吸引、収納容量変更、預入・取出UI
• 回復オーブによるエネルギー直接回復やHP 4000相当の専用ゲージ
• Imperiumの日本語化、Gキー競合、マップラグ、抽出完了UIの修正

これらは既存の2プラグインとは別のゲームAPI検証が必要なため、動作確認なしで同梱していません。将来追加する場合も、利用者側は同じRepoHostSuiteを更新するだけで済む構成を維持します。

導入

Thunderstore公開後は、ホストがRepoHostSuiteを1件インストールするだけです。

ローカルプレイテストでは、ZIPをThunderstore Mod Manager / r2modmanの「Import local mod」から専用の新規テストプロファイルへ読み込んでください。現在使用中のマルチ用プロファイルへ上書きしないでください。

手動確認する場合、DLLは次の場所へ展開されます。

BepInEx/plugins/RepoHostSuite/
├─ YoneRai12.AnomalyContractDirector.dll
└─ YoneRai12.HostSkillManager.dll

検証状況（0.1.0公開アルファ）

完了済み:

• 2プラグインのReleaseビルド: 警告0、エラー0
• 契約・イベント状態機械テスト: 18/18成功
• 禁止API・ハード依存の静的安全検査: 成功
• ビルドDLLのIL安全監査: 成功
• パッケージ内にゲーム本体DLL、BepInEx本体、他作者MODのDLLを含めない構成

未完了:

• クリーンな専用テストプロファイルでのBepInExロード
• ソロで1レベル完走
• 契約の成功・失敗・キャンセル
• 9イベントの代表動作と安全縮退
• 設定変更と再起動後の保持
• ホスト＋実クライアントでの表示・RPC・途中参加再通知
• 競合注意MODを外した状態での実マルチ確認

不具合を見つけた場合は、下記の情報を添えて報告してください。ゲーム更新や他MODとの組み合わせによっては、機能別設定をOFFにして切り分ける必要があります。

問題報告に含めてほしい情報

R.E.P.O.のゲームバージョン:
RepoHostSuiteのバージョン:
ホスト / クライアント:
参加人数:
レベル名:
発生した契約またはイベント:
同時使用MOD:
BepInExログの該当部分:
再現手順:

作者・独立実装・AI表示

• Author: YoneRai12
• Plugin GUIDs: YoneRai12.AnomalyContractDirector, YoneRai12.HostSkillManager
• 本パッケージは他作者のパッケージ、DLL、ゲーム本体DLL、アセットを再配布しません。
• ゲーム標準APIと公開情報を調査し、独立したソースとして実装しています。
• 設計、実装、検証、ドキュメントにAIエージェントの支援を大きく利用しています。公開時はThunderstoreのAI Generatedカテゴリを選択します。
• R.E.P.O.本体、BepInEx、Harmony、Photon、および各第三者MODの名称・著作権・商標は、それぞれの権利者に帰属します。

ライセンス

Copyright (c) 2026 YoneRai12. All rights reserved.

本パッケージの無断再配布、改変版の再アップロード、別作者名での公開を許可しません。通常のThunderstore Mod Managerを使ったダウンロード・導入と、パッケージページURLの共有は自由です。第三者製品名、ゲーム本体、BepInEx、Harmony、Photon等には各権利者の条件が適用されます。

English summary

RepoHostSuite is a host-side all-in-one gameplay package for R.E.P.O. It bundles two independent BepInEx plugins: Anomaly Contract Director and Host Skill Manager. It adds five short contracts, nine weighted anomaly events, three devices based on existing game items, and real-time team/per-player skill policies. Vanilla clients normally need no suite installation, except when a separately installed third-party skill mod has its own client requirement.

This is an independent project. It does not bundle code, DLLs, assets, UI, prefabs, or package files from Repo Contracts, R.E.P.O.-Configurator, TierSpawnConfig, SpawnConfig, REPOConfig, Imperium, or other third-party mods.