PropHunt_Fix

This mod is an all-clients-required mod that fixes and expands Omniscye's PropHunt for R.E.P.O.

It is designed as a patch and expansion mod for Omniscye's PropHunt. All players must install both Omniscye's PropHunt and PropHunt_Fix for the intended behavior.

Important

It modifies, fixes, synchronizes, and expands Omniscye's PropHunt behavior. Permission has been obtained from Omniscye to release this fix version.

If the host uses this mod, every participant should also install it. Without all clients installing it, role display, name tags, synchronized settings, countdowns, disguise discovery, and other client-side behavior may not match correctly.

Main Features

Fair Hunter Selection

The original PropHunt hunter selection is improved to reduce repeated hunter bias. The mod tracks recent hunter history and total hunter count per player, then adjusts selection weight so players who have been hunter less often are more likely to be selected.

The system uses:

• Recent hunter history weighting
• Total hunter count balancing
• UserId / SteamId-based tracking when available
• ActorNumber fallback when a stable player identifier is unavailable

This helps avoid situations where the same players repeatedly become hunter while others rarely or never become hunter.

Multi-Hunter Support

The host can configure the number of hunters. Multiple hunters can be selected in the same round.

The mod updates PropHunt's single-hunter logic so multiple hunters can work properly, including:

• Role assignment
• Hunter attack validation
• Hider elimination checks
• Hunter elimination checks
• Name tag logic
• UI display
• Round state handling

Host-Synced Settings

Some original PropHunt settings are normally local to each player. This mod synchronizes the host's PropHunt settings to all clients through room properties.

The host's settings become the shared rule source for the room. This prevents players from using different local values for key gameplay settings.

Synchronized gameplay settings include original PropHunt values such as:

• Pre-hide time
• Hunter lock time
• Round time
• Miss penalty HP
• Hunter scan range
• Hunter scan cooldown

Local keybind settings are not synchronized. Keybinds remain personal settings for each player.

Hunter Unlock Countdown

The hunter unlock timing is synchronized by the host. All clients receive the same unlock timing and display the same countdown.

The countdown plays electronic beep sounds:

• 3
• 2
• 1
• START

The hunter unlock happens at the START timing.

Remaining Time Alerts

During PropHunt, the remaining time is shown in the center of the screen at specific timings.

Minute alerts:

• 5 min
• 4 min
• 3 min
• 2 min
• 1 min

Second alerts:

• 30 sec
• 20 sec
• 10 sec
• 9 sec
• 8 sec
• 7 sec
• 6 sec
• 5 sec
• 4 sec
• 3 sec
• 2 sec
• 1 sec

For the final 10 seconds, the display uses only the seconds text and does not show an extra “Time left” label.

Multilingual UI

PropHunt_Fix includes multilingual text support for the text it displays and for the patched PropHunt HUD text.

Supported languages include:

• English
• Japanese
• Chinese
• Korean
• Russian
• French
• Spanish
• German
• Portuguese

The mod can read AutoTranslatorConfig.ini from the config folder. If Language= is found and the language is supported by PropHunt_Fix, the Fix language setting is automatically updated to match. If the language cannot be read or is not supported, the mod falls back to English.

Role-Based Visuals

Hunters keep red eyes during PropHunt. Non-hunter eye color modification is intentionally disabled because visible eye glow can make hiding harder.

Name tags are patched with role-based behavior:

• Hiders can see hider name tags normally
• Hiders can see hunter name tags in red
• Hunters can see other hunter name tags in red
• Hunters cannot see hider name tags
• Name tag distance and position are not forcibly changed

This avoids long-distance name tag bugs while still making team roles clearer.

Hunter Count Display

Before the round starts, the mod displays the number of hunters only. It does not reveal who the hunters are.

Example:

Hunters: 2

Room Count Control

The host can configure the number of rooms generated for PropHunt.

The room count can be set from 1 to 20. The default value is 2.

During PropHunt, the room generation rules are adjusted so high-level room candidates can appear even when the game level is low. This reduces repetition when PropHunt is played repeatedly from early levels.

Map Player Count Upgrade Distribution

The mod can distribute the map player count upgrade to all players by default. This can be turned on or off in the config.

Default: enabled

Disguise Flashlight Fix

In the original PropHunt behavior, a hider disguised as a valuable can temporarily show their flashlight when walking or running. This mod suppresses that behavior every frame while disguised so the flashlight stays hidden even after movement-based restore logic runs.

The suppression controls:

• FlashlightController behavior
• Light components
• MeshRenderer components
• Flashlight GameObject active state

Hunter Lock Support

While hunters are locked, the mod applies additional setup support for smoother PropHunt rounds.

Host-side behavior:

• Marks all valuables as discovered while hunters are locked

Client-side behavior:

• Marks all rooms as explored while hunters are locked

Non-hunter behavior:

• Keeps stamina full while hunters are locked

The helper processing is optimized to avoid repeated full-scene scans and periodic log spam.

Disguise Discovery Fix

In the original PropHunt behavior, the visible disguised valuable can be offset from the real player position. This can make hunters search for an invisible player body instead of the prop they can actually see.

This mod adds disguise discovery support so hunters can discover hiders by using grab input on the visible disguised valuable. The discovery check uses the visible prop position rather than only the hidden player body position.

Disguise Collision Fix

In the original PropHunt behavior, disguised valuables can lack practical collision against the environment. This can allow invalid hiding by clipping the disguised prop into walls, floors, ceilings, tables, or other objects.

This mod adds collision support for disguised valuables. The visible prop is pushed out of blocking colliders so hiders cannot intentionally hide inside solid objects.

The implementation avoids replacing the player body collider directly to reduce the risk of breaking REPO movement, death, revive, and Photon synchronization behavior.

Alt-Lock Fixes

The original PropHunt Alt-lock behavior can leave the visible disguised prop and the real player body in different positions. For example, if a hider locks in midair, the prop can stay in the air while the player body falls.

This mod fixes Alt-lock behavior so the hider body is held with the disguised prop while locked. It also cleans up locked disguise props when the hider is discovered, killed, reset, or moved to the next round.

The Alt-lock Rigidbody handling avoids assigning velocity to kinematic bodies, preventing repeated Unity warnings.

Internal Visual Suppression

Some REPO PhysGrab internal visuals can appear as green or pink spheres when valuables are grabbed or targeted. This mod suppresses those internal visuals so they do not appear during PropHunt.

State Reset Improvements

The mod resets local PropHunt state at level start, level end, scene changes, and round restarts. This prevents leftovers such as:

• Invisible player state carrying into the next round
• Disguise state carrying into the next round
• Alt-lock state carrying into the next round
• Movement lock state carrying into the next role
• Fixed props remaining after a hider has already been found

Post-Match Voice Chat

After the match result is decided and before the next stage transition, all players can hear each other. This includes alive players, dead players, and separated players.

Audio Improvements

The mod adds and controls several audio events. Audio volume is configurable as an integer from 0 to 100.

The current original sound volume is treated as 100%. The default volume is 50%.

Separate volume settings are available for:

• Death sound
• Win sound
• Countdown beep sound
• Main menu music

Config Items

Gameplay.HunterCount

Description: Number of hunters selected each round.各ラウンドで選ばれる鬼の人数

Default: 1

Minimum: 1

Maximum: 20

Gameplay.RoundRoomCount

Description: Number of rooms generated for PropHunt rounds.PropHuntラウンドで生成する部屋数

Default: 2

Minimum: 1

Maximum: 20

Gameplay.GiveMapPlayerCountUpgrade

Description: Give the map player count upgrade to all players.全員にマッププレイヤーカウントアップグレードを配布

Default: true

Values: true / false

Gameplay.RefillHuntersWhenHunterLeaves

Description: Refill hunters when a hunter leaves during a round.ラウンド中に鬼が退出した場合に鬼を補充

Default: true

Values: true / false

Visual.Language

Description: Language used by PropHunt_Fix text.PropHunt_Fixの表示言語

Default: English

Values: English, Japanese, Chinese, Korean, Russian, French, Spanish, German, Portuguese

Audio.DeathSoundVolumePercent

Description: Death sound volume. 100 is the original full volume.死亡音量。100が元の最大音量

Default: 50

Minimum: 0

Maximum: 100

Audio.WinSoundVolumePercent

Description: Win sound volume. 100 is the original full volume.勝利音量。100が元の最大音量

Default: 50

Minimum: 0

Maximum: 100

Audio.CountdownSoundVolumePercent

Description: Countdown beep volume. 100 is the original full volume.カウントダウン電子音量。100が元の最大音量

Default: 50

Minimum: 0

Maximum: 100

Audio.MainMenuMusicVolumePercent

Description: Main menu music volume. 100 is the original full volume.メインメニュー音楽音量。100が元の最大音量

Default: 50

Minimum: 0

Maximum: 100

Debug.WriteHunterSelectionLog

Description: Write detailed hunter selection and sync logs.鬼抽選と同期の詳細ログを出力

Default: false

Values: true / false

Installation

1. Install BepInEx 5.
2. Install Omniscye's PropHunt.
3. Install PropHunt_Fix.
4. Make sure every player in the room has both PropHunt and PropHunt_Fix installed.
5. Start the game normally.

Notes for Hosts

The host controls the gameplay settings. PropHunt_Fix synchronizes the host-side PropHunt gameplay settings to the room.

Recommended checks before playing:

• All players have PropHunt installed
• All players have PropHunt_Fix installed
• Hunter count is set correctly
• Room count is set correctly
• Audio volume is comfortable
• Language is set correctly

Known Behavior

The mod intentionally does not modify non-hunter eye color. This avoids visible glow issues while hiders are disguised.

Name tags are not forced to appear at long distance. Only existing visible name tags are recolored or hidden according to role.

Disguised valuables are detected through the visible disguised prop and grab input. They are not designed to be physically picked up and carried by hunters.

Update Notes

1.2.0

This release focuses on disguise interaction, collision, Alt-lock cleanup, state reset reliability, settings synchronization reliability, and performance cleanup. Hunters can now discover hiders through the visible disguised valuable, disguised props are pushed out of blocking colliders, Alt-lock keeps the player body with the prop, and fixed props are cleaned up after discovery or death.

The release also removes repeated heavy scene scans and periodic support logs that could cause interval-based stutter.

1.1.0

This release focuses on restoring and strengthening the disguise flashlight fix and adding hunter-lock support behavior. The flashlight is now suppressed after the original update logic runs, and lock-time exploration helper behavior is split between host-side valuable discovery and client-side room exploration.

Credits

This is a patch and expansion mod for Omniscye's PropHunt. Original PropHunt behavior and concept belong to Omniscye.

※Mod created by AI

PropHunt_Fix 日本語

このMODは、全員導入必須の、オムニさんのPropHuntを修正および追加機能するMODです。

REPOが好きな日本人のための日本人のみのREPOのDiscordサーバーあります！ 参加は以下のリンクから！ https://discord.gg/h5ATY4m5bZ

重要

オムニさんのPropHuntの挙動を修正、同期、拡張するパッチMODです。 本Fix版のリリースについては、Omniscye氏から許可をいただいています。

ホストがこのMODを使う場合、参加者全員も導入してください。 全員が導入していない場合、役職表示、ネームタグ、同期設定、カウントダウン、変身貴重品の発見処理などのクライアント側処理が正しく揃わない可能性があります。

主な機能

鬼抽選の公平化

元のPropHuntの鬼抽選を改善し、同じ人ばかり鬼になる偏りを減らします。 直近の鬼履歴と累計鬼回数を見て、鬼になっていない人が選ばれやすくなるように抽選重みを調整します。

使用する情報:

• 直近の鬼履歴
• 累計鬼回数
• 可能な場合はUserId / SteamId
• 安定したIDが取れない場合はActorNumber

これにより、特定の人だけ鬼になり続けたり、逆に一切鬼になれないような偏りを減らします。

複数鬼対応

ホストは鬼の人数をConfigで設定できます。 1ラウンド内で複数人の鬼を選べます。

複数鬼に対応するため、以下の処理を補正しています。

• 役職判定
• 鬼の攻撃判定
• 逃げ側全滅判定
• 鬼全滅判定
• ネームタグ処理
• UI表示
• ラウンド状態管理

ホスト設定同期

元のPropHuntの一部設定は、各プレイヤーのローカル設定を参照します。 このMODでは、ホスト側のPropHunt設定をルームプロパティ経由で全員に同期します。

ホストの設定が部屋のルールとして扱われます。 これにより、プレイヤーごとに設定値が違って挙動がズレる問題を防ぎます。

同期対象の例:

• 隠れる時間
• 鬼ロック時間
• ラウンド時間
• ミス時HP減少量
• 鬼スキャン距離
• 鬼スキャンクールダウン

キー設定は同期しません。 キー設定は各プレイヤー個人の設定として扱います。

鬼ロック解除カウントダウン

鬼ロック解除タイミングはホスト基準で同期されます。 全員が同じタイミングでカウントダウンを見ます。

表示と音は以下の流れです。

• 3
• 2
• 1
• START

STARTのタイミングで鬼ロックが解除されます。

残り時間表示

PropHunt中、特定のタイミングで残り時間が画面中央に表示されます。

分表示:

• 5分
• 4分
• 3分
• 2分
• 1分

秒表示:

• 30秒
• 20秒
• 10秒
• 9秒
• 8秒
• 7秒
• 6秒
• 5秒
• 4秒
• 3秒
• 2秒
• 1秒

最後の10秒は「残り」のような余計な表記を付けず、秒数のみ表示します。

多言語対応

PropHunt_Fixの表示文と、補正対象のPropHunt HUD文を多言語化します。

対応言語:

• 英語
• 日本語
• 中国語
• 韓国語
• ロシア語
• フランス語
• スペイン語
• ドイツ語
• ポルトガル語

configフォルダ内の AutoTranslatorConfig.ini から Language= を読み取れます。 対応言語の場合はFix側の言語設定も自動的に合わせます。 取得できない場合や未対応言語の場合は英語に戻します。

役職に応じた見た目補正

鬼は赤目になります。 非鬼の目の色は変更しません。 非鬼の目を光らせると隠れている時に見えやすくなるため、意図的に廃止しています。

ネームタグは役職に応じて補正されます。

• 逃げ側は逃げ側の名前を通常表示
• 逃げ側は鬼の名前を赤表示
• 鬼は他の鬼の名前を赤表示
• 鬼は逃げ側の名前を見えないようにする
• ネームタグの距離や位置は強制変更しない

これにより、遠距離ネームタグのバグを避けながら役職を見分けやすくしています。

鬼人数表示

ラウンド開始前に鬼の人数だけ表示します。 誰が鬼かは表示しません。

例:

Hunters: 2

部屋数制御

ホストはPropHunt用に生成される部屋数を設定できます。

設定可能範囲は1〜20です。 初期値は2です。

PropHunt中は、高レベルでしか自然生成されない部屋も低レベルで生成候補に入るように補正します。 これにより、レベル1を繰り返すPropHuntでも部屋パターンが少なくなりすぎないようにします。

マッププレイヤーカウントアップグレード配布

全員にマッププレイヤーカウントアップグレードを配布できます。 初期値はオンです。

変装中の懐中電灯修正

元のPropHuntでは、逃げ側が貴重品に変装中でも、歩いたり走ったりすると懐中電灯が一時的に見えることがあります。 このMODでは、本家側の移動時再表示処理が動いた後でも、変装中は毎フレーム懐中電灯が表示されないように修正します。

抑制対象:

• FlashlightController
• Lightコンポーネント
• MeshRendererコンポーネント
• 懐中電灯GameObjectのactive状態

鬼ロック中の補助処理

鬼がロックされている間、PropHuntラウンドを遊びやすくするための補助処理を行います。

ホスト側の処理:

• 全貴重品を発見済みにする

各クライアント側の処理:

• 全部屋を探索済みにする

非鬼の処理:

• 鬼ロック中はスタミナを常に満タンにする

補助処理は、不要な全探索や周期ログでラグが出ないように軽量化しています。

変身貴重品の発見修正

元のPropHuntでは、見えている変身貴重品の位置と実際のプレイヤー本体の位置が少しズレることがあります。 そのため、鬼が見えている貴重品ではなく、見えないプレイヤー本体側を探す必要がある状態になる場合があります。

このMODでは、鬼が見えている変身貴重品に対して掴み操作を行うことで、その非鬼を発見できるように補正します。 発見判定は、隠れているプレイヤー本体だけではなく、画面上に見えている変身貴重品の位置を基準にします。

変身貴重品の当たり判定修正

元のPropHuntでは、変身貴重品の当たり判定が実質的に不足し、壁、床、天井、テーブルなどにめり込める場合があります。

このMODでは、変身貴重品に当たり判定補助を追加します。 見えている貴重品が壁などのColliderへ入り込んだ場合、外へ押し戻すことで不正な隠れ方を防ぎます。

プレイヤー本体のColliderを直接置き換える方式ではなく、REPO本体の移動、死亡、蘇生、Photon同期を壊しにくい方式で補正しています。

Alt固定修正

元のPropHuntでは、非鬼が空中でAlt固定した場合、見えている変身貴重品は空中に残り、実際のプレイヤー本体だけが落下する場合があります。

このMODでは、Alt固定中はプレイヤー本体も変身貴重品と一緒に固定されるように補正します。 また、発見、死亡、リセット、次ラウンド移行時に、固定されていた変身貴重品が残らないように消します。

Alt固定中のRigidbody処理では、kinematicなRigidbodyへ速度を代入しないようにして、Unity警告が連続出力される問題も防ぎます。

内部表示の非表示化

REPOのPhysGrab内部表示が、緑やピンクの球として見えてしまう場合があります。 このMODでは、これらの内部表示を非表示にしてPropHunt中に見えないようにします。

状態リセット改善

レベル開始、レベル終了、シーン遷移、ラウンド再開始時に、ローカル側のPropHunt状態をリセットします。

これにより以下の残留を防ぎます。

• 次ラウンドへ透明状態が引き継がれる
• 次ラウンドへ変身状態が引き継がれる
• 次ラウンドへAlt固定状態が引き継がれる
• 次の役職でも移動ロックが残る
• 発見済みの非鬼が使っていた固定貴重品だけが残る

勝敗後のボイスチャット

勝敗判定後、次ステージへ移動するまでの間は全員の声が全員に聞こえるようになります。 生存者、死亡者、離れている人も会話できます。

音声改善

以下の音量を個別に設定できます。 音量は0〜100の整数です。 元の最大音量を100%として扱います。 初期値は50%です。

• 死亡音
• 勝利音
• カウントダウン電子音
• メインメニュー音楽

設定項目

Gameplay.HunterCount

説明: Number of hunters selected each round.各ラウンドで選ばれる鬼の人数

初期値: 1

最小値: 1

最大値: 20

Gameplay.RoundRoomCount

説明: Number of rooms generated for PropHunt rounds.PropHuntラウンドで生成する部屋数

初期値: 2

最小値: 1

最大値: 20

Gameplay.GiveMapPlayerCountUpgrade

説明: Give the map player count upgrade to all players.全員にマッププレイヤーカウントアップグレードを配布

初期値: true

設定可能値: true / false

Gameplay.RefillHuntersWhenHunterLeaves

説明: Refill hunters when a hunter leaves during a round.ラウンド中に鬼が退出した場合に鬼を補充

初期値: true

設定可能値: true / false

Visual.Language

説明: Language used by PropHunt_Fix text.PropHunt_Fixの表示言語

初期値: English

設定可能値: English, Japanese, Chinese, Korean, Russian, French, Spanish, German, Portuguese

Audio.DeathSoundVolumePercent

説明: Death sound volume. 100 is the original full volume.死亡音量。100が元の最大音量

初期値: 50

最小値: 0

最大値: 100

Audio.WinSoundVolumePercent

説明: Win sound volume. 100 is the original full volume.勝利音量。100が元の最大音量

初期値: 50

最小値: 0

最大値: 100

Audio.CountdownSoundVolumePercent

説明: Countdown beep volume. 100 is the original full volume.カウントダウン電子音量。100が元の最大音量

初期値: 50

最小値: 0

最大値: 100

Audio.MainMenuMusicVolumePercent

説明: Main menu music volume. 100 is the original full volume.メインメニュー音楽音量。100が元の最大音量

初期値: 50

最小値: 0

最大値: 100

Debug.WriteHunterSelectionLog

説明: Write detailed hunter selection and sync logs.鬼抽選と同期の詳細ログを出力

初期値: false

設定可能値: true / false

導入方法

1. BepInEx 5 を導入
2. オムニさんのPropHuntを導入
3. PropHunt_Fixを導入
4. 部屋に入る全員がPropHuntとPropHunt_Fixを導入していることを確認
5. 通常通りゲーム開始

ホスト向けメモ

ホストの設定が部屋のルールになります。 PropHunt_Fixはホスト側のPropHunt設定を全員へ同期します。

開始前に確認するとよい項目:

• 全員がPropHuntを導入しているか
• 全員がPropHunt_Fixを導入しているか
• 鬼人数
• 部屋数
• 音量
• 表示言語

既知の仕様

非鬼の目の色は変更しません。 隠れている時に目の光で位置がバレるのを防ぐためです。

ネームタグは遠距離に強制表示しません。 通常表示されているネームタグだけを役職に応じて色変更または非表示にします。

変身貴重品の発見処理は、鬼が見えている変身貴重品に掴み操作を行った時点で発見する方式です。 鬼が変身貴重品を実際に持ち上げて運ぶ仕様ではありません。

更新内容

1.2.0

このリリースでは、変身貴重品の発見、当たり判定、Alt固定、状態リセット、設定同期、処理負荷の改善を中心に修正しています。 鬼は見えている変身貴重品に対する掴み操作で非鬼を発見でき、変身貴重品は壁などへめり込みにくくなり、Alt固定中はプレイヤー本体も一緒に固定されます。

また、一定間隔でラグが出る原因になり得る重い全探索処理と周期ログを削減しています。

1.1.0

このリリースでは、変装中の懐中電灯修正の再強化と、鬼ロック中の補助処理を追加しています。 本家側のUpdate処理後に懐中電灯を抑制し、ロック中の全貴重品発見はホスト側、全部屋探索済みは各クライアント側で処理します。

クレジット

このMODはオムニさんのPropHunt向けの修正および拡張パッチMODです。 元のPropHuntの仕様とコンセプトはオムニさんのものです。

※AI生成MOD