PeakSpectatorMode (更好的观战视角)

English | 中文在下面

A match-spectating / free-camera mod for PEAK. Provides a GodCam-style free-fly view, smooth player switching, soft follow, overhead player labels, x-ray silhouettes, and automatic compatibility with several popular mods.

All player-facing text is bilingual (English / 中文). In-game text follows the game's language automatically, and the config UI shows both languages. See Language below.

Features

Core camera

• F3 toggle the free camera (GodCam)
• ESC exit the free camera while spectating
• F4 reset the camera near the local player
• Q / E switch to the next / previous player (living players only)
• WASD + Space/E/LeftCtrl/Q free flight (same as GodCam defaults)
• LeftShift speed boost
• Alt hold to smoothly slow the free camera by a configurable multiplier (default 33%); release to smoothly restore
• Scroll wheel adjust FOV
• X hold for telescope zoom
• Mouse2 (wheel click) reset scroll zoom
• Uses a configurable move damping (default 3) to keep free-camera movement stable

Soft follow

• Auto-starts after the transition to a player completes
• While following you can freely rotate, adjust zoom and nudge position without interrupting it
• Exits only when the camera is farther than the soft-follow max distance (default 20 m)
• A right-pointing white arrow is shown to the left of the followed player's name

Overhead player labels

• In free camera, shows each player's name + altitude, scaled by distance
• C 3-step cycle: name + arrow -> name only -> hide all -> name + arrow
• F temporarily show/hide all overhead labels
• Overhead arrow style options: Rounded Glass / Outline Glass

X-ray silhouettes

• When a player is occluded, a translucent same-skin-tone silhouette is shown so you never lose track

HUD control

• In free camera the HUD is minimized by default (hides interaction prompts, inventory, crosshair, vanilla names, etc.), keeping the stamina bar, top timer and top-right map

Forced death

• Alt + F3 hold for 3 seconds to force the local player to die (a quick way to enter ghost spectating)
• Automatically disabled when GhostSpectator compatibility is active (no need if you're already a ghost)

Language

• In-game text (e.g. the forced-death warning) follows the game's current language automatically: Simplified/Traditional Chinese shows Chinese, otherwise English.
• Config UI: every section, key name and description shows English and Chinese together.
• Logs: 0. General / Log Language (Auto / English / Chinese) controls console/log message language. Auto follows the in-game language.

Third-party compatibility

When the mod detects the following mods it enables the matching compatibility logic automatically (all are always on).

GhostSpectator

• Disables Alt+F3 forced death while in permanent ghost-spectator state
• Takes over the spectator HUD while the F3 free camera is active
• Filters out permanent spectators in Summit Roster to avoid fake heights

BetterPlayerDistance v2

• Temporarily hides BPD2's name and distance labels when entering the F3 free camera (avoids double-HUD overlap)
• Restores BPD2's original user config when exiting F3

Summit Roster

• Moves the progress bar to the right side of the screen (optional)
• Shows an indicator arrow for the currently observed player
• Adds an 8-direction shadow to the font for readability
• Fallback filter for abnormal altitudes (>3000 m)

PEAKTrails

• Toggle player trails with a dedicated key R while in free camera

PeakStatsEx

• Temporarily extends the teammate stamina-bar display distance to 9999 m in free camera
• Temporarily forces the item icons on teammate stamina bars to show in free camera; on exit, if PeakStatsEx's local config disables item display, it proactively clears the leftover icons
• When Show Full PeakStatsEx Info is on, F3 temporarily shows PeakStatsEx's full stats (timer, height, fog/lava, map/biome, stamina values and hazard countdowns, etc.); when off it stays minimal

Performance

This mod is built for low overhead:

• Near-zero per-frame cost when not spectating — x-ray silhouettes, overhead labels, etc. only work while F3 is active.
• While spectating, label text/style/renderer queries are cached and throttled; only positions update every frame to keep following smooth.
• Coexists with translation mods (XUnity AutoTranslator) without re-triggering label text translation every frame.
• Summit Roster compatibility runs only once per frame; no ongoing cost when the relevant third-party mod isn't installed.

Installation

Requirements

• BepInExPack_PEAK 5.4.75301+
• Only depends on BepInExPack_PEAK; compatibility logic auto-enables when the corresponding third-party mod is detected.

Steps

1. Install BepInExPack_PEAK
2. Put PeakSpectatorMode.dll, manifest.json, README.md, CHANGELOG.md into <PEAK install dir>/BepInEx/plugins/PeakSpectatorMode/
3. Launch the game; the config file is generated at <PEAK>/BepInEx/config/com.AiAe.peakspectatormode.cfg

Configuration

After launching the game, the config file is at:

<PEAK>/BepInEx/config/com.AiAe.peakspectatormode.cfg

Main config groups:

• 0. General: Log Language (Auto / English / Chinese)
• 1. Hotkeys: F3/F4/Q/E/F/C/R/X, the Alt+ forced-death key, etc.
• 2. Camera: move/turn speed and damping, Alt slow multiplier, telescope multiplier, soft-follow toggle and distance threshold, free-camera teammate stamina distance, show full PeakStatsEx info
• 3. Display: name font size, world altitude font size, marker/label opacity, overhead arrow style

Known issues

• Q is both GodCam's descend key and the default "previous player" key, so pressing Q also descends the camera. Rebind in the config if you want them separate.
• Config was slimmed to a few groups; old config files may still contain legacy keys such as 4. Advanced / 5. Compatibility, but the new version no longer reads them.
• The following are fixed-on or fixed-value and no longer produce config entries: free-camera minimal HUD, overhead labels, x-ray detail layer, debug mode, all compatibility toggles, forced-death toggle, all advanced fine-tuning options.

Closing note:

I'm very sorry, I don't have programming skills. I can only use AI to realize my ideas. Before release, I have conducted quite sufficient tests to ensure normal operation, but there is still a possibility of errors. If this still occurs, you can find me in the official Discord group of PEAK @-AIAE-

License

MIT License

PeakSpectatorMode (更好的观战视角)

English | 中文

PEAK 的比赛观战 / 自由相机 mod。提供 GodCam 风格的自由飞行视角、平滑切换玩家、软跟随、头顶玩家信息标记、轮廓透视，并与多个常用 mod 自动兼容。

所有面向玩家的文本均为中英双语。游戏内文本自动跟随游戏语言，配置界面同时显示中英。详见下方 语言 一节。

功能

核心相机

• F3 切换自由相机（GodCam）
• ESC 观战时退出自由相机
• F4 重置相机到本地玩家附近
• Q / E 切换观察的下一个/上一个玩家（仅活人）
• WASD + Space/E/LeftCtrl/Q 自由飞行（同 GodCam 默认）
• LeftShift 加速
• Alt 按住后自由相机移动速度按配置倍率平滑降低（默认 33%），松开平滑恢复
• 滚轮 调整 FOV
• X 按住望远镜放大
• Mouse2 (滚轮按下) 重置滚轮缩放
• 切换期间使用可配置移动阻尼（默认 3）稳定自由相机移动手感

软跟随

• 切换到玩家后过渡完成自动开始软跟随
• 跟随期间可自由旋转视角、调焦距、微调位置（不打断）
• 仅当相机距目标 > 软跟随最大距离（默认 20m）时退出
• 被跟踪玩家头顶名称左侧显示朝右白色箭头作指示

头顶玩家标记

• 自由相机下显示玩家名称 + 海拔，距离自适应缩放
• C 三段循环：名称+箭头 → 仅名称 → 全部隐藏 → 名称+箭头
• F 临时显示/隐藏整体头顶标记
• 头顶箭头风格可选：圆角玻璃 / 线框玻璃

轮廓透视

• 玩家被遮挡时显示半透明同肤色剪影，不会跟丢

HUD 控制

• 自由相机模式下默认精简 HUD（隐藏交互、物品栏、准星、原版名字等），保留体力条、顶部时间和右上角地图

强制死亡

• Alt + F3 长按 3 秒强制让本地玩家死亡（用于快速进入幽灵观战）
• 与 GhostSpectator 兼容时自动禁用（已经是幽灵就不需要）

语言

• 游戏内文本（如强制死亡警告）自动跟随游戏当前语言：简体/繁体中文显示中文，其他显示英文。
• 配置界面：每个分组、键名与描述均中英并列显示。
• 日志：0. General / Log Language（日志语言，Auto / English / Chinese）控制控制台/日志信息语言，Auto 跟随游戏内语言。

第三方兼容

本 mod 检测到以下 mod 时自动启用相应兼容逻辑，全部兼容默认固定启用。

GhostSpectator

• 进入永久幽灵观战态时禁用 Alt+F3 强制死亡
• F3 自由相机激活时接管观战 HUD
• Summit Roster 中过滤掉永久观察者，避免显示假高度

BetterPlayerDistance v2

• 进入 F3 自由相机时临时关闭 BPD2 的名称和距离标签（避免双 HUD 重叠）
• 退出 F3 时恢复 BPD2 的用户原始配置

Summit Roster

• 把进度条移到屏幕右侧（可选）
• 显示当前观察玩家的指示箭头
• 字体加 8 方向阴影提升可读性
• 海拔异常 (>3000m) 兜底过滤

PEAKTrails

• 自由相机模式下用独立按键 R 切换玩家轨迹显示

PeakStatsEx

• 自由相机模式下临时扩大队友体力条显示距离到 9999m
• 自由相机模式下临时强制显示队友体力条上的物品图标，退出后若 PeakStatsEx 本地配置关闭物品显示，会主动清理残留图标
• Show Full PeakStatsEx Info（自由相机显示完整 peakstatsex 信息）开启后，F3 内临时显示 PeakStatsEx 的完整统计信息（计时、高度、雾/岩浆、地图/生态、体力数值和异常倒计时等）；关闭时保持精简显示

性能

本 mod 注重低开销：

• 未进入观战时几乎零每帧成本——轮廓透视、头顶名牌等仅在 F3 激活时才工作。
• 观战中名牌的文字、样式、渲染器查询均做缓存与降频，仅位置每帧更新以保持跟随丝滑。
• 与翻译类 mod（XUnity AutoTranslator）共存时，避免每帧重复触发名牌文本翻译。
• Summit Roster 兼容每帧只跑一次；未安装相应第三方 mod 时不产生持续开销。

安装

必要前置

• BepInExPack_PEAK 5.4.75301+
• 仅依赖 BepInExPack_PEAK；兼容逻辑会在检测到对应第三方 mod 时自动启用。

安装步骤

1. 安装 BepInExPack_PEAK
2. 将 PeakSpectatorMode.dll、manifest.json、README.md、CHANGELOG.md 放入 <PEAK 安装目录>/BepInEx/plugins/PeakSpectatorMode/
3. 启动游戏，配置文件生成于 <PEAK>/BepInEx/config/com.AiAe.peakspectatormode.cfg

配置

启动游戏后，配置文件位于：

<PEAK>/BepInEx/config/com.AiAe.peakspectatormode.cfg

主要配置项分类：

• 0. General（常规）：日志语言（Auto / English / Chinese）
• 1. Hotkeys（热键）：F3/F4/Q/E/F/C/R/X、Alt+强制死亡主按键等可配置按键项
• 2. Camera（相机）：移动/转向速度和阻尼、Alt 慢速倍率、望远镜倍率、软跟随开关与距离阈值、自由相机队友体力条距离、自由相机显示完整 peakstatsex 信息
• 3. Display（显示）：名字字号、世界海拔字号、标记/标签透明度、头顶箭头样式

已知问题

• Q 键既是 GodCam 的下降键，也是默认的"上一玩家"键，按 Q 时相机会同时下降。如需分离请在配置中改键。
• 配置项已精简为若干组；旧配置文件中可能仍保留旧版 4. 高级功能 (Advanced)、5. 模组兼容 (Compatibility) 等历史键，但新版不再读取这些键。
• 以下功能已固定启用或固定为当前参数，不再生成配置项：自由相机精简 HUD、头顶标记、透视细节层、调试模式、全部兼容开关、强制死亡开关、全部高级微调项。

写在最后

很抱歉，我没有编程的能力，我只能使用AI来实现我的想法，在发布前我已进行了相当充分的测试确保能正常运行，但依然有可能出现错误，如果这依然发生了，你可以在discord的PEAK官方群组里找到我@-AIAE-

许可

MIT License