You are viewing a potentially older version of this package. View all versions.
Kristal483-BadScoutWatcher-2.0.0 icon

BadScoutWatcher

An anti-cheat and player monitoring mod for PEAK, for hosts and clients.

Date uploaded a day ago
Version 2.0.0
Download link Kristal483-BadScoutWatcher-2.0.0.zip
Downloads 54
Dependency string Kristal483-BadScoutWatcher-2.0.0

This mod requires the following mods to function

BepInEx-BepInExPack_PEAK-5.4.2403 icon
BepInEx-BepInExPack_PEAK

BepInEx pack for PEAK. Preconfigured and ready to use.

Preferred version: 5.4.2403
PEAKModding-ModConfig-1.8.2 icon
PEAKModding-ModConfig

Easily configure mods inside your game.

Preferred version: 1.8.2

README

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.

CHANGELOG

Changelog

2.0.0

Extra detectors (from SummitWatch by Java)

  • Added 17 extra detectors (movement, flight, speed, teleport, noclip, stamina, hunger, cold/heat, force spam, voice and more). Each has its own switch in Settings > Extra Detectors, with Enable all / Disable all.

  • Added 8 network rules: Puppeteer, Forced mute, Forced run end, Kick without being host, Timer change without being host, Impossible push, Self-warp and Spawn request.

  • Added Below the map, Host-only object (ghost ball / petrified scout) and a slow item-spam rule.

  • Flags that only a cheater can cause now go straight to 100% threat (host-only objects, Noclip, spawn-in-hand requests and similar).

  • The original BadScoutWatcher checks are now off by default.

  • Extra detector flags are worth 5 or 15 points, except Cold/heat, Hunger, Stamina and Replayed clip, which are worth 10.

  • Repeat flags of the same check on the same player wait 5 s (strong and proof checks) or 20 s (all others).

RPC Shield

  • Unauthorized RPCs are now blocked, not only flagged: kicks, warps, spawn-in-hand, pushes, puppeteering (die, pass out, petrify, stick), host-only commands and commands on scouts the sender doesn't control. Anything from you, the host or a recent host is never blocked.

  • The hook runs first, so another mod can no longer hide an RPC from it.

  • New flag "RPC shield bypass" when a blocked teleport still happened.

  • Optional setting to also block unidentified signals (off by default).

  • Timer change without being host now also covers the time of day, and nine more host-only commands are blocked from non-hosts (run timer update, rope sync, eruptions, lava, wind, player spawns, island load, airport load).

UI

  • Settings are now split into categories: General, Keybinds, Protection Rules, Extra Detectors, Opacity, Customize and Blacklist. The category buttons wrap to fit long translated names.

  • New Opacity category with sliders (each with a Reset button) for banner background, banner text, overlay background, overlay text, menu background and box / bubble.

  • Revamped menu, overlay and banner look (UI styles, player overlay and window rebuilt).

  • Blacklist has its own category and page (flagged players saved between games; the blacklist can Kick or Ban).

  • Languages: the menu is translated into 11 languages (English, Spanish, Portuguese, French, German, Russian, Turkish, Arabic, Chinese, Japanese, Korean). Pick one in Customize. Logs and flag descriptions stay in English.

  • UI resizer: Menu size (0.8x to 1.6x) and Text size (1x to 2x) sliders in Customize. The windows grow with the text.

  • Keybinds category: menu key (F2 by default), plus new keys to toggle the player overlay and the warning banner.

  • Color Picker: more colors to edit (menu background and boxes, banner background / title / detail / accent bar, overlay background / names / accent line).

  • Extra Detectors page: Enable all, Disable all and Test banner buttons.

  • Player overlay: an always-on list of players with their danger score on the left and name on the right. Drag it while the menu is open; the position is saved. It has an on/off toggle.

  • Warning banner: revamped, with its own on/off toggle, its own colors and opacity.

  • Colored names: nicknames with color markup show in their colors on the banner and player list. A switch in Customize turns it off. Logs always use plain names.

  • Launcher button: a small "BSW" box in the top-right corner that opens the menu when clicked. Drag it to move it (the position is saved) and press "Reset launcher position" in Settings > General to put it back. Turn it on or off in Settings > General, or with an optional key in Settings > Keybinds.

  • Close button (X) in the top-right corner of the menu. The version and menu key hint moved to the bottom of the menu.

  • Mods page: rows with many mods use short names with hover and a "+N more" expansion.

Kick and Ban

  • Kick and Ban are now two separate buttons. Kick is the soft kick; Ban uses the game's ban, which stops the player rejoining.

  • Auto-kick and the blacklist can each be set to Kick or Ban in the config.

  • Auto-kick now also removes players with a single 100% flag and players using a cheat mod.

  • Fixed a false "kick while kick mode is off" flag at the ending scene and credits.

  • Fixed the kick-mode check never reading the lobby's real kick setting, so kicks by players without kick mode (for example PeakKick) were allowed. Such kicks are flagged and dropped, and a log line is written if the setting cannot be read.

Mod detector

  • Added a known-mods registry (BadScoutWatcher.KnownMods.txt) built from thousands of mod DLLs. It names mods that you don't have installed, by their RPCs and player properties.

  • When several mods share one signal, it is one row with short names (for example PkSt / PkStEx). Hover a short name to see that mod's full name. Rows that are too long get a "+N more" button that lists every mod. Blacklisting the row blacklists all of them with their full names.

  • Added cheat-mod markers: Cherry, Atlas, PEAK-MX, Peak Admin Menu, Cube X and Advanced Console. They are listed on the Mods page and count for "kick cheat-mod users".

  • Mod property names (for example ImCritter.Mod) are now shown as mods, not as unidentified signals.

  • When the host has PEAKLib.Core, the host's exact plugin list is shown on the host's Mods page.

Fewer false flags

  • Ending cutscene and credits no longer trigger air checks.

  • Dead (ghost), spectating and knocked-out scouts are no longer flagged for movement.

  • Cold/heat: huddling (within 3.2 m of another scout), lit lanterns, stoves, geysers and hot springs, and items that remove cold or heat (Heat Pack, Cure-All, Scout's Tenacity, Napberry, Blowgun) are no longer flagged. Weather and campfires that affect several players at once are skipped.

  • Force spam: several players pushing the same scout at the same moment (a game event) is no longer flagged, and dead scouts can't shove.

  • Teleport spikes over 40 m no longer give a huge Airborne flag, and the Airborne number now shows the real threshold.

Lobby log

  • Detailed lobby log with SKIP, EVIDENCE, LAG and item-trace lines.

  • A LOBBY RESULT block at the end of each lobby log with CLEAN / FLAGGED / LIKELY CHEATING for every player.

Fixes

  • One failing step in the update loop can no longer stop the hotkeys, overlay or banners. The error is logged once.

  • Compatible with the game update that changed WarpPlayerRPC.

  • Fixed the Mods button disappearing when a game starts, and the camera freezing while the menu is open.

  • Added the Ban button to every language, and a Requirements section in the README (BepInExPack PEAK, ModConfig).

1.1.3

  • Adding opacity for Boxes / Bubbles.

  • Fixed Corner Roundness.

  • Fixed some UI and Text.

  • And some changes.

1.1.2

  • Adding the lobby logs, you can now view flags and the history of the lobbies in a folder called BadScoutWatcherLobbyLogs.

1.1.1

  • Fixing the mute button and some optimizations.

1.1.0

  • Added coloring wheel, item flood, anti-fling, sync, banner, and player voice mute fixes.

1.0.4

  • Delete or stop item spamming under testing in this version.

1.0.3

  • Fixed the text clipping. The banner now has more vertical padding and extra height around its measured text, and button padding is smaller so labels fit inside fixed-height buttons.

1.0.2

  • Updated the item-spam rapid-drop interval to 300 ms. The existing threshold of more than four drops within one second remains unchanged.

1.0.1

I found and fixed several sync hazards, then built BadScoutWatcher 1.0.1.

  • The RPC Shield now warns about high RPC rates without dropping valid game RPCs, which could interrupt movement or spectating updates.
  • Clients no longer warp remote character copies locally, and disabling Anti-Fling no longer writes a cached position back onto a replicated character.
  • Remote recovery now requires a suspected fling. Stable, near-ground packets that incorrectly report "not grounded" are treated as ground contact after 0.75 seconds.

The existing BepInEx log showed no RPC drops or movement-detector errors, so I can't confirm those caused the freeze. It did show implausible height readings, including about 5,004 m. I also couldn't verify Alpine Extended's blizzard behavior directly; its wind may still trigger a speed warning because the mod has no weather-state integration.