search

codengine / SOTFEdit

A Sons of The Forest Savegame Editor
MIT License
104 stars 6 forks source link
editor savegame savegame-editor sons-of-the-forest

readme

SOTFEdit - Sons of The Forest Savegame Editor

Screenshot

Build GitHub release (latest by date) GitHub all releases GitHub

A savegame editor for "Sons of The Forest".

Discord

Disclaimer

This project is in no way or form associated with the developers of the game. It is just a non-commercial fan project, nothing more, nothing less.

Features

Download

Requirements

Usage

Inventory

Storage

Armor

Armor protects you from most hazards. However you are still going to drown and die from fall damage.

NPCs

The game groups some enemies into "families". Most likely they won't attack each other and raid the player.

One word about modifying NPCs: Some enemies are in caves/bunkers and have a different GraphMask. When this option is selected (Only in the same area as this actor) only enemies in the same "phase" are edited.

So, if you just want to remove babies in caves, select this option. If you remove all of them, just deselect it.

Spawners: I haven't fully investigated how the game works with those spawners. When you delete them the game will re-create them on the next game save. So this would be one way to increase the number of enemies.

Structures

This tool lets you "almost" finish blueprints, set them to "unfinished" or remove them. Why "almost"? Because it is too complex to convert blueprints to final buildings. So this tool will change the blueprints to require one last item until a blueprint is finished.

The cool thing about this is that you can use it in order to have an easy source for logs for example. Just set some shelters, change them to "almost finished", take them down and all logs will drop to the ground.

Another cool thing is that you can use it to build stuff in caves or bunkers. The process is the same: Just set the blueprints, mark them as "almost finished", take them down and use the resources to build new stuff.

If you want to build larger structures like shelters in a cave or bunker, you have to place a small blueprint first ( like a chair), then change its type and save.

Map

The map combines static information about points-of-interest with dynamic information that are read directly from the savegame. Some positions are missing but they may be added in the future.

Features

Options

You can enable or disable icons using the "Options" button in the top left corner.

Some important notes regarding the filters:

Teleportation

You can only teleport to locations where we have the exact coordinates either from the savegame itself or attached to the POI.

Kelvin and Virginia do not appear underground, so teleportation for them is disabled if the target location is underground.

By default an offset is added to the target location. This is done so that you do not spawn inside an enemy which would catapult you into the sky and most likely kill you. You can adjust the target location using those numbers. X and Z represent the longitute/latitude and Y represents the height.

Spawning

Most enemies can be spawned at all areas. Virginia and Kelvin can only be spawned at the Surface. Please note that if you spawn too many it may have a severe impact on your performance or even crash your game.

Moreover, the game will not spawn all enemies at the same time. If you spawn 200 enemies the game will create ~25 enemies and when they are killed, after some time, the next ~25 enemies will spawn.

Weather

There is one very important thing. If you only change the season, it will be reverted immediately when the game progresses. To fix that, you also have to adjust the played time at "Game State". It is calculated based on the length of the season. Here is an example:

The in-game season will be winter, because:

So if you want to change the weather to Summer, you need to adjust the playtime days to something between 10 and 19.

Here is a list of number of days per season per season length setting:

Reviving

If you want to revive either or both followers, there are some things to consider:

Spawning

This feature is quite experimental and allows the duplication of Kelvin and Virginia. It turns out that the game can not spawn, for some reason, more than 5 Virginias. If the value is higher, they would spawn somewhere unreachable.

Kelvin was tested successfully with 20, so this is also the maximum now.

If you want to exceed this maximum, you would have to save, fire up the tool, spawn and load the game again.

Be careful: This feature will most likely kill your performance and may corrupt your savegame.
Make sure to enable backups!

Troubleshooting

One of the items in inventory is listed as "Unknown"?

My game does not work anymore?

I get errors and the application does strange things

I can not change "IsRobbyDead" or "IsVirginiaDead"

The program does not start

Antivirus (Windows Defender for example, Smartscreen) is complaining

"Could not load file or assembly"

My changes are not applied or reverted

Lakes, rivers etc. are gone

Contributing

Feel free to report any unknown items or any feature requests. PRs are also welcome.

Final Words

Big thanks to Gronkh for your many years of "Influenz". Especially without your "The Forest" streams I would have never known anything about that game.

Credits

Attributions

Icons used for items are property of Endnight Games.

POIs and screenshots originate from https://github.com/lmachens/sons-of-the-forest-map who really did a great job to collect all data.

Icons