PROP HUNT v1.2.8

Hide as Valuables, hunt the fakes, repeat.

Message to my awesome friends and the players who use my mods.

• If you need support for my mods or just want to hang out join my new personal server on Discord: https://discord.gg/WZ6fWG4v3u

Update 1.2.8

• Simple Manifest, README - update/change.

Update 1.2.5 (Changelog)

• Fixed issues with host locking forever.
• Fixed healing per round.

Update 1.2.0 (Changelog)

• Added locking! Lock into position as valuables and look around! (Default key is LeftALT)
• Levels now Switch every round!

How to Play (For Players)

• One Hunter, the rest are Hiders.
• As a Hider, aim at a Valuable and press V to disguise. Press V again to clear your disguise.
• Press C to switch between first person and third person view. This is local only and will not break your disguise.
• Press Left ALT to lock your position. While locked, you can move your mouse to look around without your prop rotating. Press it again to unlock.
• As the Hunter, use Right Mouse (RMB) to scan a suspected Hider. If you hit them, they are eliminated. If you miss, you lose 5 HP.
• Hiders sometimes see a faint light while moving in the dark (this is local only, the Hunter does not see it).
• You can edit the CONFIGs in your mod manager to set some things how you like!

Round flow

1. Pre-hide phase (30 seconds)

   • Hiders pick a prop to disguise as.
   • The Hunter is locked in place.
   • Everyone’s health is topped up.

2. Active round (5 minutes)

   • Hunter scans with RMB.
   • Misses cost HP.

3. Win conditions

   • All Hiders dead (Hunter wins).
   • Hunter dead or timer runs out (Hiders win).

4. Next round

   • Short banner, random new level loads, and the Hunter role rotates.

Content and maps

• Hiders can disguise as any Valuable (vanilla or modded).
• Works on all vanilla and modded maps.
• Enemy spawns are disabled in Prop Hunt mode.
• Levels are loaded with maximum Valuables for disguise variety.

Technical Notes (For Modders/Devs)

This section is only for those who want to know how it works under the hood. Players do not need to read this part.

Networking & Roles

• Roles and state are synced with Photon room properties:
  • PH_Active, PH_Hunter (actor number), PH_PropVID per player.
• Master client rotates the Hunter each round.

Pre-hide & Round logic

• Waits for Main gameplay and avatars before arming pre-hide.
• Timer starts only after pre-hide ends.
• Hunter input and speed are clamped during pre-hide.

Disguise System

• On V, the PhotonViewID of the targeted Valuable is cached and synced.
• Each client locally clones the prop’s renderers onto the Hider and shrinks the rig to near-invisible size.
• No colliders or rigidbodies cloned. RPCs buffered so late joiners see disguises.

Position Locking

• On Left ALT, the local disguise clone is unparented from the player so it stays static in world space.
• Player input is disabled to prevent sliding, but camera look remains enabled for scouting.

Flashlight Handling

• While disguised, crouch is spoofed during OnPhotonSerializeView writes so remotes never see your flashlight.
• The small glow seen while moving is client-side only.

Camera Toggle

• Simple local offset around the player’s original view.
• Does not affect network or disguise state.

Hunter Gun

• Active only while the round is live.
• Ray up to approx 60m, eliminates on hit.
• Misses cost HP.

Health Fairness

• Host heals players during and after pre-hide.
• Late joiners are topped up when avatars spawn.

Round End

• Winner is broadcast, banner displayed.
• Master Client selects a new random level and reloads the room.

Default Balance Values

• PreHideSeconds = 30
• HunterLockSeconds = 30
• RoundSeconds = 300
• GunRangeMeters approx 60
• GunCooldown approx 0.18s
• MissPenaltyHP = 5

Known Quirks

• Late joining is supported, but disguises may be delayed until your avatar finishes spawning.

Credits

Created by Omniscye/Empress & OrigamiCoder