PeakVs

PeakVs turns a normal PEAK multiplayer run into a checkpoint race. Everyone climbs the same mountain, but each racer gets private loot and private item effects.

This is an early multiplayer release. Every player in the lobby must install the same PeakVs version. Host-only installation is not supported.

Race rules

• Other racers remain visible as translucent scouts, with player-to-player collisions and helping disabled.
• Every racer can independently open each luggage container and collect its contents. A luggage roll is deterministic, so each racer receives the same opportunity without consuming anyone else's copy.
• Existing world loot is cloned into a private Photon group for each racer.
• Held items and spawned item effects are private to their owner. This includes rope launchers, rope spools, anchors, rope grabs, and similar network-spawned effects.
• Campfire areas suppress hunger even before the fire is lit.
• Scoutmaster spawning and targeting are disabled.
• The Cursed Skull, Scout Effigy, Scoutmaster bugles, and items marked by PEAK as multiplayer-only are excluded.
• The respawn statue gives each racer an Ancient Idol instead of reviving other racers.
• The top-center TextMeshPro race HUD uses PEAK's own display font and shows the current biome timer plus every player's finish or FF time.
• Touching the current campfire records a finish. Dying records an FF for that biome.
• When every connected racer has finished or FF'd, the host lights the checkpoint automatically. Dead racers are revived, all racers are gathered at the campfire, and the next biome timer begins from a common start.

Installation

Install through a Thunderstore-compatible mod manager, or copy BepInEx/plugins/PeakVs/PeakVs.dll into your PEAK installation's BepInEx/plugins/PeakVs folder.

All racers must use PeakVs 0.2.0 together. The HUD reports MOD MISMATCH when a peer has not published matching race state; the checkpoint waits rather than advancing an incomplete lobby.

Configuration

Press F6 in PEAK to open the PeakVs menu. Every racer can change the HUD and rival display locally. The host also gets race controls for toggling automatic advancement, restarting the current split, or forcing a stuck checkpoint.

The same options are stored in BepInEx/config/dev.peakvs.racemode.cfg:

• Visuals.RemoteScoutOpacity: opacity for other racers, from 0.15 to 0.9 (default 0.45).
• HUD.ShowRaceHud: show or hide the timer and standings (default true).
• HUD.HudScale: scale the timer and standings from 0.7 to 1.5 (default 1.0).
• HUD.MenuToggleKey: key used to open the PeakVs menu (default F6).
• Race.AutoLightCheckpoints: automatically advance after all results are in (default true).

Compatibility

• Built for PEAK 2.0.a (8aea2f16d).
• Built for BepInEx 5 / BepInExPack PEAK 5.4.75301.
• Mods that replace inventory authority, luggage spawning, campfire progression, player interaction, or Photon item instantiation can conflict with PeakVs.

Report multiplayer issues with the host and client BepInEx/LogOutput.log files and the exact PEAK/PeakVs versions.