justin/sotf-modloader
1
0
Fork 0
Code Issues Pull Requests Actions 3 Packages Projects Releases Wiki Activity

Add Windows app, zip download and SignPath signing
Build Windows app / app (push) Waiting to run
Details

Browse Source
This commit is contained in:
Justin Oros
2026-09-28 14:24:42 -07:00
parent 079caa599d
commit a22512b506
18 changed files with 1494 additions and 18 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+34 -8
View File
@@ -1,26 +1,39 @@
# sotf-modloader
A web page for installing, updating and removing Sons of the Forest mods with one click.
Install, update and remove Sons of the Forest mods with one click.
Live site: https://justinoros.github.io/sotf-modloader/
## For players
1. Open the site in Chrome or Edge on Windows.
2. Click **Choose game folder** and pick your Sons of the Forest install folder.
3. Install RedLoader if it isn't installed yet, then install the mods you want.
The site offers three ways to install:
The page remembers your folder. Close the game before installing or updating.
1. **Windows app (recommended).** Download `SotfModLoader.exe` from the site and run it. It finds your game through Steam, including installs inside Program Files, and installs RedLoader and mods with one click.
2. **Zip download.** One zip with RedLoader and every mod. Extract it into your Sons of the Forest folder, the one that contains `SonsOfTheForest.exe`.
3. **Install from the page.** Works in Chrome or Edge when the game is not inside Program Files. Browsers are not allowed to open folders there.
Close the game before installing or updating.
## How it works
A GitHub Actions workflow runs every 6 hours, on every push to `main`, and on demand. It:
The `Build and deploy` workflow runs every 6 hours, on every push to `main`, and on demand. It:
- finds every repo owned by the account with the `sotf-mod` topic and mirrors the zip from its latest release
- mirrors the latest RedLoader release
- builds `downloads/sotf-mods.zip` with RedLoader and every mod
- publishes everything with a `manifest.json` to GitHub Pages
The page writes files straight into the game folder using the browser's File System Access API.
The Windows app in `app/` reads the same `manifest.json`.
## Releasing the Windows app
Push a tag starting with `app-v`:
```
git tag app-v1.0.0 && git push origin app-v1.0.0
```
The `Build Windows app` workflow builds `SotfModLoader.exe`, signs it with SignPath when signing is set up, publishes a GitHub release and refreshes the site.
## Setup
@@ -34,4 +47,17 @@ The page writes files straight into the game folder using the browser's File Sys
- `version` in `manifest.json` matches the release tag, so update detection works.
- `platform` in `manifest.json` is `Client`, `Server` or `Universal`.
After publishing a mod release, run the workflow manually to update the site right away.
## Code signing policy
Free code signing provided by [SignPath.io](https://about.signpath.io), certificate by [SignPath Foundation](https://signpath.org).
- Committers and reviewers: [JustinOros](https://github.com/JustinOros)
- Approvers: [JustinOros](https://github.com/JustinOros)
## Privacy policy
This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it. It downloads the mod list and mod files from this project's GitHub Pages site and GitHub releases.
## License
MIT. RedLoader is by ToniMacaroni and is redistributed unmodified under the Apache License 2.0.