README.md

# sotf-inventory

A browser based inventory editor for Sons of the Forest. Runs entirely on your computer, nothing is uploaded.

Live page: https://justinoros.github.io/sotf-inventory/

## How to use

1. Close Sons of the Forest.
2. Open your save folder: `%USERPROFILE%\AppData\LocalLow\Endnight\SonsOfTheForest\Saves\<SteamID>\SinglePlayer\<SaveID>\`
3. Copy `SaveData.zip` somewhere safe as a backup.
4. Drag `SaveData.zip` onto the page, or click Browse.
5. Search for items and set their counts. Counts are limited from 0 to the in game max for each item.
6. Click Save to download the new `SaveData.zip`.
7. Replace the old `SaveData.zip` in your save folder with the new one and start the game.

Can't find your save? Close the game, open PowerShell and paste:

```
irm https://raw.githubusercontent.com/JustinOros/sotf-inventory/main/Find-SaveData.ps1 | iex
```

It opens Explorer with your most recent `SaveData.zip` selected.

A loose `PlayerInventorySaveData.json` also works if you prefer to edit the extracted file.

## Notes

* Unequip items in game before you save and quit. Equipped items are shown but locked.
* Items the editor doesn't recognize are marked unknown and can only be lowered, not raised.
* Blueprints also need entries in `PlayerStateSaveData.json` to show as unlocked. This tool only edits inventory.
* Browsers can't open a file dialog at a specific folder. Use Copy path and paste it into the dialog's address bar. Chrome and Edge remember the last folder you picked.

## Hosting on GitHub Pages

Push the repo, then go to Settings, Pages, and set the source to the `main` branch root.

## Files

* `index.html` page layout
* `styles.css` theme
* `app.js` load, edit, and save logic
* `items.js` item IDs, names, categories, and max counts
* `Find-SaveData.ps1` opens Explorer at your latest `SaveData.zip`

## Credits

Item IDs, names, and inventory limits come from [SOTFEdit](https://github.com/codengine/SOTFEdit) by codengine, MIT License.

Not affiliated with Endnight Games.
Initial SOTF inventory editor for GitHub Pages 2026-09-21 19:42:31 -07:00			`# sotf-inventory`

			`A browser based inventory editor for Sons of the Forest. Runs entirely on your computer, nothing is uploaded.`

			`Live page: https://justinoros.github.io/sotf-inventory/`

			`## How to use`

			`1. Close Sons of the Forest.`
			2. Open your save folder: `%USERPROFILE%\AppData\LocalLow\Endnight\SonsOfTheForest\Saves\<SteamID>\SinglePlayer\<SaveID>\`
			3. Copy `SaveData.zip` somewhere safe as a backup.
			4. Drag `SaveData.zip` onto the page, or click Browse.
			`5. Search for items and set their counts. Counts are limited from 0 to the in game max for each item.`
			6. Click Save to download the new `SaveData.zip`.
			7. Replace the old `SaveData.zip` in your save folder with the new one and start the game.

Add Find-SaveData.ps1 helper and PowerShell command on loader card 2026-09-21 22:07:59 -07:00			`Can't find your save? Close the game, open PowerShell and paste:`

			```
			`irm https://raw.githubusercontent.com/JustinOros/sotf-inventory/main/Find-SaveData.ps1 \| iex`
			```

			It opens Explorer with your most recent `SaveData.zip` selected.

Initial SOTF inventory editor for GitHub Pages 2026-09-21 19:42:31 -07:00			A loose `PlayerInventorySaveData.json` also works if you prefer to edit the extracted file.

			`## Notes`

			`* Unequip items in game before you save and quit. Equipped items are shown but locked.`
			`* Items the editor doesn't recognize are marked unknown and can only be lowered, not raised.`
			* Blueprints also need entries in `PlayerStateSaveData.json` to show as unlocked. This tool only edits inventory.
			`* Browsers can't open a file dialog at a specific folder. Use Copy path and paste it into the dialog's address bar. Chrome and Edge remember the last folder you picked.`

			`## Hosting on GitHub Pages`

			Push the repo, then go to Settings, Pages, and set the source to the `main` branch root.

			`## Files`

			* `index.html` page layout
			* `styles.css` theme
			* `app.js` load, edit, and save logic
			* `items.js` item IDs, names, categories, and max counts
Add Find-SaveData.ps1 helper and PowerShell command on loader card 2026-09-21 22:07:59 -07:00			* `Find-SaveData.ps1` opens Explorer at your latest `SaveData.zip`
Initial SOTF inventory editor for GitHub Pages 2026-09-21 19:42:31 -07:00
			`## Credits`

			`Item IDs, names, and inventory limits come from [SOTFEdit](https://github.com/codengine/SOTFEdit) by codengine, MIT License.`

			`Not affiliated with Endnight Games.`