BackupCam 1.1.0, backup camera on the golf cart GPS screen

2026-09-22 22:40:11 -07:00
commit 048bf77543
7 changed files with 832 additions and 0 deletions
@@ -0,0 +1,95 @@
+# BackupCam
+
+Shows a backup camera on screen while you reverse the golf cart in Sons of the
+Forest.
+
+## Multiplayer
+
+Client side only. Nothing gets installed on a dedicated server, and other
+players do not need the mod. Works on dedicated servers, on games hosted by a
+player, and in single player.
+
+## Installation
+
+### Easy install
+
+Close the game, open PowerShell and paste:
+
+```powershell
+irm https://raw.githubusercontent.com/JustinOros/sotf-backupcam/main/Install.ps1 | iex
+```
+
+It finds your game, installs RedLoader if needed, and installs the latest
+BackupCam. Run it again any time to update.
+
+### Manual install
+
+#### Step 1: Install RedLoader
+
+[RedLoader](https://github.com/ToniMacaroni/RedLoader/releases/latest) is the mod
+loader for Sons of the Forest. The game cannot load any mod without it, so
+install it first. You only have to do this once.
+
+1. Download `RedLoader.zip` from the
+   [latest RedLoader release](https://github.com/ToniMacaroni/RedLoader/releases/latest)
+2. Extract it into your Sons of the Forest folder, the one containing
+   `SonsOfTheForest.exe`, usually
+   `C:\Program Files (x86)\Steam\steamapps\common\Sons Of The Forest`
+3. Launch the game once and wait until you reach the main menu. The first launch
+   takes a few minutes while RedLoader processes the game files
+4. Check that `MODS` appears on the main menu, then quit
+
+#### Step 2: Install BackupCam
+
+1. Download `BackupCam.zip` from the
+   [latest release](https://github.com/JustinOros/sotf-backupcam/releases/latest)
+2. Extract it into the `Mods` folder inside your game folder
+3. You should end up with:
+
+```
+Mods\BackupCam.dll
+Mods\BackupCam\manifest.json
+```
+
+## Usage
+
+Get in a golf cart and drive backward. The camera feed appears at the bottom of
+the screen, mirrored like a real backup camera, and hides shortly after you stop
+reversing.
+
+Press F1 to open the console, then use these commands:
+
+| Command | Action |
+| --- | --- |
+| `backupcamoffset` | Show the current camera height, distance and tilt |
+| `backupcamoffset 1.1 -1.3 20` | Set camera height, distance behind the cart, and downward tilt |
+| `backupcamdump` | Write the golf cart's object and material list to `_RedLoader\Latest.log` |
+
+## Uninstall
+
+Close the game, open PowerShell and paste:
+
+```powershell
+& ([scriptblock]::Create((irm https://raw.githubusercontent.com/JustinOros/sotf-backupcam/main/Install.ps1))) -Remove
+```
+
+Or from a clone of this repo, run `.\Install.ps1 -Remove`. This removes only
+BackupCam. RedLoader and your other mods are left alone.
+
+## Building from source
+
+Requires the .NET 8 SDK and RedLoader installed with its game assemblies
+generated.
+
+```powershell
+.\build.ps1 -Install
+```
+
+Use `-Package` to build `BackupCam.zip` for a release. Pass `-GameDir "path"` if
+the game is not found automatically.
+
+## Troubleshooting
+
+Check `_RedLoader\Latest.log` in your game folder. BackupCam logs a line when it
+loads. If the camera never shows, run `backupcamdump` while sitting in the cart
+and include the log when reporting the problem.