FreeGhost

FreeGhost

English | 中文

Recommended companion mod / 推薦搭配使用：EnhancedPing

English

FreeGhost turns PEAK's Ghost into a first-person free-flight mode after you die, while remaining fully client-side.

Highlights

• Fly freely after death: Explore the area in first person without collisions.
• Natural controls: Move, look, ascend, descend, and sprint using your current PEAK bindings.
• Switch anytime: Press R or the gamepad north face button to toggle between free flight and PEAK's normal spectate camera.
• Visible to other players: Your Ghost position is synchronized using the game's existing networking.
• No team-wide install required: Only the player using FreeGhost needs the mod.

Installation

Install Mod Manager or r2modman, or place FreeGhost.dll directly in PEAK's BepInEx/plugins directory. FreeGhost requires BepInEx 5.

Controls

| Action | Input |

|---|---|

| Move | PEAK's movement input |

| Look | PEAK's look input |

| Ascend | Jump |

| Descend | Crouch |

| Move faster | Sprint |

| Toggle free flight | R / gamepad north face button by default |

Movement follows the camera's horizontal direction. Looking up or down does not change the movement plane; use Jump and Crouch to control altitude. Your in-game keyboard, mouse, and controller bindings continue to work.

By default, each Ghost session starts with PEAK's normal spectate camera. Set General.Default Mode to Free to start in free-flight mode instead. In either case, press the toggle shortcut to switch modes without changing the current spectate target; entering free flight resumes from the current camera position.

Free flight is limited to a configurable radius around the position where you entered the mode. The default radius is 1 km. Movement and mode switching pause while a menu is open, the game is paused, or player input is otherwise blocked.

Configuration

The config file is generated at BepInEx/config/com.github.lllei.FreeGhost.cfg.

| Key | Default | Allowed range |

|---|---:|---:|

| General.Enabled | true | boolean |

| General.Default Mode | Normal | Free or Normal |

| Movement.Base Speed | 8.0 | 0.1 to 1000 m/s |

| Movement.Sprint Multiplier | 2.5 | 1 to 20 |

| Movement.Max Distance | 1000 | 10 to 10000 m |

| Movement.Mode Toggle Keyboard Path | /r | Unity Input System button path |

| Movement.Mode Toggle Gamepad Path | /buttonNorth | Unity Input System button path |

| Networking.Sync To Vanilla Clients | true | boolean |

Invalid numeric values are clamped or replaced with safe defaults at runtime. Both toggle bindings accept Unity Input System button paths. /buttonNorth is Xbox Y, PlayStation Triangle, or Nintendo X.

Compatibility notes

Only the player using FreeGhost needs to install it. Other players can see the moving Ghost without installing the mod, and FreeGhost does not add custom network messages.

Building

Copy PeakGameDir.props.example to the gitignored PeakGameDir.props and set the PEAK directory, or set PEAK_GAME_DIR.

dotnet test tests\FreeGhost.Core.Tests\FreeGhost.Core.Tests.csproj -c Release

dotnet build FreeGhost.sln -c Release

dotnet msbuild src\FreeGhost\FreeGhost.csproj -t:Deploy -p:Configuration=Debug

dotnet msbuild src\FreeGhost\FreeGhost.csproj -t:PackageThunderstore -p:Configuration=Release

Normal builds never write to the game directory. Deploy is explicit. Packaging writes artifacts/lllei-FreeGhost-.zip.

For a release, update Version in FreeGhost.csproj and version_number in manifest.json. Packaging stops if the manifest and compiled DLL versions do not agree.

中文

FreeGhost 會在你死亡後把 PEAK 的 Ghost 變成第一人稱自由飛行模式，並且只需本地安裝。

功能亮點

• 死亡後自由飛行： 以第一人稱無碰撞探索周圍區域。
• 沿用遊戲操作： 移動、視角、升降和加速都使用 PEAK 當前的按鍵綁定。
• 隨時切換： 按 R 或手柄北側面鍵即可在自由飛行和原版觀戰相機之間切換。
• 其他玩家可見： Ghost 位置通過遊戲現有的網絡同步顯示給其他玩家。
• 無需全隊安裝： 只有使用 FreeGhost 的玩家需要安裝本 Mod。

安裝

可以通過 Mod Manager 或 r2modman 安裝，也可以將 FreeGhost.dll 直接放入 PEAK 的 BepInEx/plugins 目錄。FreeGhost 需要 BepInEx 5。

操作方法

| 操作 | 輸入 |

|---|---|

| 移動 | PEAK 的移動輸入 |

| 觀察 | PEAK 的視角輸入 |

| 上升 | 跳躍 |

| 下降 | 蹲下