GhostSpectator

GhostSpectator

A BepInEx plugin for PEAK that lets a player spawn into every match as a permanent ghost, never alive, never revived, so they can spectate, switch between live players, and talk on voice chat exactly like a vanilla ghost.

Primary repository: This project is developed at forgejo.bryantserver.com/SisyphusMD/GhostSpectator. The GitHub copy is a read-only mirror.

Why

PEAK already has a ghost mechanic: when a player dies, they become a camera that follows live teammates and can talk on voice. This mod makes that state the starting state for one player, so you can join the lobby as a permanent ghost spectator and follow your teammates' climb.

How it works

PEAK gates the vanilla ghost camera, voice handler, and player-ghost spawning on a single boolean: CharacterData.fullyPassedOut. GhostSpectator sets that flag (and dead) on the local player's Character.Start when the run starts, i.e., only on the island scene, not in the airport lobby. This way the spectator is alive in the airport (can walk around, socialize, watch you press the kiosk) and becomes a ghost the moment the run begins. To keep the spectator from breaking other players' revive economy, the mod also filters the local spectator out of every revive-candidate pool the game builds (Scout Effigy, Ancient Statue, Respawn Chest) and adjusts per-player item spawns, fog/lava pacing, and the end-of-run UI to ignore spectator presence.

Beyond the single-player ghost mechanic, GhostSpectator raises PEAK's room cap from 4 to 4 live + 16 spectator (20 total), gates mid-run joiners through a [Play] vs [Spectate] popup, and locks each player's role for the duration of a run.

Installation

PEAK mods are distributed through, a community-hosted mod registry for Unity games. There are two common ways to install: through a graphical mod manager (recommended, handles dependencies and updates) or by dropping files into the game's BepInEx folder manually.

Requirements

• PEAK (Steam) -- store page
• BepInExPack PEAK -- the mod loader. Listed as a dependency of GhostSpectator, so the mod manager pulls it automatically.

Recommended: Mod Manager

• Install one of:
• r2modman -- cross-platform, open source.
• Mod Manager -- official Overwolf-based client (Windows).
• In the mod manager, select PEAK as the game, then find and install GhostSpectator by SisyphusMD. The manager will pull BepInExPack_PEAK automatically as a dependency.
• Launch PEAK through the mod manager (the "Start modded" button). Launching from Steam directly will bypass the mods.

Manual install

• Download BepInExPack PEAK.
• Extract its contents into your PEAK install directory (alongside PEAK.exe). On a default Steam install this is at:
• Windows: C:\Program Files (x86)\Steam\steamapps\common\PEAK\
• Linux: ~/.local/share/Steam/steamapps/common/PEAK/
• Launch PEAK once so BepInEx generates its directory structure, then quit.
• Download the latest GhostSpectator zip from any of:
• forgejo releases (primary)
• GitHub releases (mirror)
• (package page)
• Open the zip and copy plugins/SisyphusMD.GhostSpectator.dll into /BepInEx/plugins.
• Launch PEAK. The plugin generates its config file at /BepInEx/config/SisyphusMD.GhostSpectator.cfg.

Usage

Toggling spectator mode

In the airport lobby, click the power button in the top-left Ghost Spectator panel to toggle. The button is gray when OFF (the default) and green when ON. The setting persists across launches.

The panel shows two sections: LIVE n/4 with one row per live-climber slot (empty slots show as "(open)"), and SPECTATORS n/16 with the current spectators. Each spectator row has a ghost icon tinted by that player's chosen skin color.

When ON, you'll stay alive in the airport (walk around, socialize, watch the host press the kiosk) and transition to the ghost camera the moment the run starts on the island. Standard ghost-camera controls apply (hotbar 1/2 to switch between li