PEAK
You are viewing a potentially older version of this package. View Latest Version
Install with App

Details

Date Uploaded
Downloads
658
Size
357KB

BadScoutWatcher

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.

Requirements

Install these before BadScoutWatcher (a mod manager such as Thunderstore Mod Manager or r2modman installs them automatically):

  • BepInExPack PEAK - the BepInEx mod loader for PEAK.
  • ModConfig - used to edit the mod's settings.

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 a player who causes 6 or more item events (spawns, drops, or inventory additions) within 0.5 seconds. Repeat flags for the same player are spaced at least 6 seconds apart. With Anti-Item Flooding on, once the player is flagged every new item they create is removed until no new item has appeared for 0.5 seconds, then everything returns to normal. Only the spam items are removed: existing items such as luggage contents, carried or backpack items, other players' drops and world items are never touched. The host removes the items for everyone; on a client they are removed from your own game only. Trusted players are skipped. Item events from the room host (game-driven spawns) are never counted, and the check is paused during frame hitches, high ping spikes and for 2 seconds afterwards, so lag does not cause false flags.
  • 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.
  • Extra Detectors (2.0.0): Seventeen additional checks built into the mod, each with its own on/off switch in Settings > Extra Detectors (and in the config file). They are tuned to avoid false flags: movement checks pause during lag, warps, revives and while a player is carried or trapped; a detection is held for 0.6 seconds and dropped if a warp or revive arrives at the same moment; weaker or repeat-prone checks must be seen twice within two minutes before anything is flagged; and every check has a per-player cooldown. All are on by default and can each be switched off in Settings (or with Enable all / Disable all): Teleport, Fling, Walking on air, Defying gravity, Force spam, Replayed clip, Earrape, Speed, Super jump, Flight, Impossible landing, Endless stamina, No hunger, Cold/heat immunity, Noclip, Not speech and Nonstop audio. Network checks are included as well (Below the map, Host-only object, slow item spam and Puppeteer, Forced mute, Forced run end, Kick without being host, Timer change without being host, Impossible push, Self-warp and Spawn request); they look at who sent a game command, so they work as host or client, ignore the first 10 seconds after you join a room, and treat a player who was host in the last 30 seconds as host. The voice checks only listen to the audio PEAK already plays for remote players; nothing is recorded or saved.
  • 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 (2.0.0): Rejects malformed incoming Photon RPC payloads (missing sender, invalid view ID, method index or argument list). If a sender exceeds 60 RPCs per second it only logs a warning. It also blocks commands a player is not allowed to send: kicks while the run's kick mode is off, warps, spawn-in-hand requests, pushes, puppeteering (die, pass out, petrify, stick), host-only commands and commands on scouts the sender doesn't control (BlockUnauthorizedRpcs, on by default). Anything from you, the host or a recent host is never blocked. A blocked teleport that still happens raises an "RPC shield bypass" flag. BlockUnidentifiedRpcs (off by default) can also drop commands that come from no known mod.
  • Mod detector (2.0.0): Lists the mods of other players from the signals their mods leave: player properties, RPC names and BadScoutWatcher's own handshake (ShareMyMods). A built-in registry (BadScoutWatcher.KnownMods.txt, scanned from thousands of mod DLLs) names mods you don't have installed. When several mods share one signal it is one row with short names (for example PkSt / PkStEx); hover a short name to see its full name, and press "+N more" on a long row to list them all. Known cheat mods (Cherry, Atlas, PEAK-MX, Peak Admin Menu, Cube X) are reported, and Advanced Console is shown as an admin console. If the host has PEAKLib.Core, the host's exact plugin list is shown on their Mods page. A mod can only be seen if it sends something other players receive; client-only mods stay hidden.
  • Blacklist (2.0.0): Blacklist a player or a mod. A blacklisted mod row blacklists every mod in that row, by full name. The blacklist can Kick or Ban (Action).
  • Host controls: Kick (soft, the player can rejoin) and Ban (the game's ban, the player cannot rejoin that lobby) are separate buttons for untrusted players. Optional Auto-Kick removes a player who reaches 100 threat or uses a known cheat mod (AutoKickCheatMods), and can Kick or Ban (AutoKickAction). Anti-Item Flooding works for the host and for clients.
  • Local mute and trust controls: Mute silences one remote player's voice for you only, using PEAK's own per-player voice mute, so other players, footsteps and game audio are unaffected. It is re-applied automatically if the game resets it (for example when a player respawns). You cannot mute yourself. Trusted players are excluded from suspicion scoring, and their Kick button is hidden.
  • Lobby logs: Saves a dated log for each lobby you join to BepInEx/BadScoutWatcherLobbyLogs/ (for example Lobby_2026-10-18_20-47-03.log). It records who was present, joins and leaves, detection flags, kicks, and mute/trust actions, each with a timestamp. The detailed log also records skipped checks and evidence, and a LOBBY RESULT block at the end lists every player as CLEAN, FLAGGED or LIKELY CHEATING. Turn it off with SaveLobbyLogs in the config.
  • Menu and theme settings: Toggle the overlay with F2 by default, change its keybind, and customize its appearance.

Threat tiers

Score Tier Color
0–24 Clean Light gray #D9D9E6
25–49 Low risk Green #00FF00
50–74 Medium risk Orange #FFA500
75–99 High risk Red #FF0000
100 Cheating Magenta #FF00FF

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, and broadcast recovery require the room Master Client (host), and only the host can remove flood items for everyone. A non-host can only affect the local view of other players, including removing flood items from their own game.
  • RPC Shield is a basic payload filter and rate monitor, 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: the original checks (Item Flood, Airborne, Velocity, Teleport and Landing) are off and can be switched on under Original Checks in the config; the Anti-Fling Guard is off; Anti-Item Flooding, RPC Shield, blocking unauthorized RPCs, the Extra Detectors, and opening the menu on startup are on.
  • Built for PEAK with BepInEx. Install the DLL through a compatible PEAK mod profile.
  • Balanced auto-kick (host only, on by default): a player is kicked only when the evidence is strong: a forced run end; two proof-level violations; two item floods; one proof-level violation plus 60% threat; or full threat from at least 3 flags by at least 2 different checks. Trusted players are never kicked and nothing is kicked while the lobby is lagging. Switch it off with the Auto-Kick toggle or AutoKick in the config; AutoKickThreat sets the threat level.
  • Player overlay: an always-on list in the corner of the screen: danger score on the left, player name on the right, the mod name on top. The host and trusted players show a tag instead of a score. It has no buttons; drag it while the menu (F2) is open, and it stays out of the warning banner's way. Turn it off or reset its position in Settings.

Credits

  • Kristal483: compiling and assembling the mod, and testing.
  • KARASUMA: testing and helping.
  • KarmaTYP: helping.
  • SummitWatch by Java: the extra detectors, and testing.
Thunderstore development is made possible with ads. Please consider making an exception to your adblock.