BadScoutWatcher

BadScoutWatcher 1.0.0

BadScoutWatcher is a BepInEx mod for PEAK that monitors multiplayer movement and item-drop activity, records suspicious events, and displays a per-player suspicion score. It also includes optional host enforcement and anti-fling protections.

AI disclosure: BadScoutWatcher was made with AI assistance.

Features

• Suspicion meter and evidence: Shows tracked players, threat scores, color-coded risk tiers, recent detections, and event history. Scores cap at 100 and decrease by 10 points for every 60 seconds without a new flag.
• Airborne detection (+10): Flags a remote player who remains ungrounded for 10 seconds without landing or taking injury. Climbing and recognized flight states are excluded. The event records the highest sampled position.
• Speed detection (+10): Flags remote movement averaging more than 28 m/s across a three-frame sample buffer.
• Item-flood detection (+30): Flags when more than four item drops are observed in a one-second window and the rapid-drop sequence also exceeds four, with consecutive drops less than 0.25 seconds apart. When enabled on the host, the detected spawned item is removed where possible.
• Landing / Height Damageable Fall (+5): Checks falls of at least 22 m. It waits 1.5 seconds after landing and flags only if no fall injury is detected. Lower falls do not trigger this check.
• Warp detection (+5): Flags a position change greater than 50 m over a sampling interval shorter than two seconds, unless PEAK identifies it as a recent game warp.
• Anti-Fling Guard: Temporarily disables collisions between the local player and a high-speed remote player. If a player stays airborne for five seconds, it uses PEAK’s warp routine to return them to their most recently saved grounded point and stop ragdoll velocity. As host, the recovery is sent to the other clients as well.
• RPC Shield: Can reject malformed incoming Photon RPC payloads and limit each remote sender to 60 accepted RPCs per rolling second.
• Host controls: Manual kick is available for untrusted players. Optional Auto-Kick removes a player who reaches 100 threat. The host can also enable item removal for detected floods.
• Local mute and trust controls: Mute silences audio sources on the tracked player object locally. Trusted players are excluded from suspicion scoring, and their Kick button is hidden.
• Menu and theme settings: Toggle the overlay with F2 by default, change its keybind, and customize its appearance.

Threat tiers

Important notes

• BadScoutWatcher uses movement packets and observed item-drop events as heuristics. A flag is evidence to review, not proof that someone is cheating; unusual gameplay or network conditions can cause false positives.
• Movement-based threat scoring inspects remote players. The local player is not movement-scored by these detectors, although the Anti-Fling Guard has a separate local recovery path.
• Kick, Auto-Kick, item removal, and broadcast recovery require the room Master Client (host). A non-host can only affect the local view of other players.
• RPC Shield is a basic payload and rate filter, not a complete network security system. If an unexpected Photon/game type causes inspection to fail, it logs the error and allows that RPC through.
• Default settings: Auto-Kick is off; item deletion, RPC Shield, Anti-Fling Guard, and opening the menu on startup are on.
• Built for PEAK with BepInEx. Install the DLL through a compatible PEAK mod profile.