Startup stops because asset backups are incompatible: Difference between revisions
From Shroudforge
More actions
Bonsaibauer (talk | contribs) Create en-GB source page for translation |
Bonsaibauer (talk | contribs) Keep guide category and add Problems:Shroudforge |
||
| (2 intermediate revisions by the same user not shown) | |||
| Line 15: | Line 15: | ||
<translate> | <translate> | ||
<!--T:1--> | |||
Troubleshooting for older ShroudForge releases. Versions 1.6.8, 1.7.0 and 1.7.3 can stop before Enshrouded starts when their asset backup files do not match the installed game files. | Troubleshooting for older ShroudForge releases. Versions 1.6.8, 1.7.0 and 1.7.3 can stop before Enshrouded starts when their asset backup files do not match the installed game files. | ||
== Why startup stops == | == Why startup stops == <!--T:2--> | ||
<!--T:3--> | |||
ShroudForge keeps working backups of <code>enshrouded.kfc</code> and <code>enshrouded.kfc_resources</code> so it can restore the game files before preparing asset mods. These <code>.bak</code> files may come from an older Enshrouded version or another mod. If the KFC backup does not match the current game file, older ShroudForge releases cannot safely restore it and stop startup. | ShroudForge keeps working backups of <code>enshrouded.kfc</code> and <code>enshrouded.kfc_resources</code> so it can restore the game files before preparing asset mods. These <code>.bak</code> files may come from an older Enshrouded version or another mod. If the KFC backup does not match the current game file, older ShroudForge releases cannot safely restore it and stop startup. | ||
== If you use ShroudForge 1.7.5 or later == | == If you use ShroudForge 1.7.5 or later == <!--T:4--> | ||
<!--T:5--> | |||
When the KFC backup is incompatible, these versions can move both working backups to the ShroudForge recycle bin and capture new backups from the current game files. This recovery requires <code>shroudforge/shroudforge-updater.exe</code> in the Enshrouded installation. If the log says the updater is unavailable, repair or reinstall ShroudForge with the complete release package, then start the game again. Keep the <code>.bak</code> files in place while repairing the installation. | When the KFC backup is incompatible, these versions can move both working backups to the ShroudForge recycle bin and capture new backups from the current game files. This recovery requires <code>shroudforge/shroudforge-updater.exe</code> in the Enshrouded installation. If the log says the updater is unavailable, repair or reinstall ShroudForge with the complete release package, then start the game again. Keep the <code>.bak</code> files in place while repairing the installation. | ||
== Manual fix for versions 1.6.8, 1.7.0 and 1.7.3 == | == Manual fix for versions 1.6.8, 1.7.0 and 1.7.3 == <!--T:6--> | ||
<!--T:7--> | |||
Use these steps only with the listed older ShroudForge versions. | Use these steps only with the listed older ShroudForge versions. | ||
<!--T:8--> | |||
# Close ShroudForge and Enshrouded completely, including any dedicated server process. | # Close ShroudForge and Enshrouded completely, including any dedicated server process. | ||
# Open the Enshrouded installation folder. A common Steam path is <code>SteamLibrary\steamapps\common\Enshrouded</code>, but use the library folder where your game is installed. | # Open the Enshrouded installation folder. A common Steam path is <code>SteamLibrary\steamapps\common\Enshrouded</code>, but use the library folder where your game is installed. | ||
| Line 37: | Line 42: | ||
# Restart ShroudForge. It should create fresh working backups from the current game files. | # Restart ShroudForge. It should create fresh working backups from the current game files. | ||
<!--T:9--> | |||
Do not delete the <code>.kfc</code> or <code>.kfc_resources</code> game files, or any other backup files. If startup still fails, keep the remaining files and share the ShroudForge log with support. | Do not delete the <code>.kfc</code> or <code>.kfc_resources</code> game files, or any other backup files. If startup still fails, keep the remaining files and share the ShroudForge log with support. | ||
| Line 42: | Line 48: | ||
[[Category:guide:Shroudforge]] | [[Category:guide:Shroudforge]] | ||
[[Category:Problems:Shroudforge]] | |||
Latest revision as of 21:47, 6 November 2026
Troubleshooting for older ShroudForge releases. Versions 1.6.8, 1.7.0 and 1.7.3 can stop before Enshrouded starts when their asset backup files do not match the installed game files.
Why startup stops
ShroudForge keeps working backups of enshrouded.kfc and enshrouded.kfc_resources so it can restore the game files before preparing asset mods. These .bak files may come from an older Enshrouded version or another mod. If the KFC backup does not match the current game file, older ShroudForge releases cannot safely restore it and stop startup.
If you use ShroudForge 1.7.5 or later
When the KFC backup is incompatible, these versions can move both working backups to the ShroudForge recycle bin and capture new backups from the current game files. This recovery requires shroudforge/shroudforge-updater.exe in the Enshrouded installation. If the log says the updater is unavailable, repair or reinstall ShroudForge with the complete release package, then start the game again. Keep the .bak files in place while repairing the installation.
Manual fix for versions 1.6.8, 1.7.0 and 1.7.3
Use these steps only with the listed older ShroudForge versions.
- Close ShroudForge and Enshrouded completely, including any dedicated server process.
- Open the Enshrouded installation folder. A common Steam path is
SteamLibrary\steamapps\common\Enshrouded, but use the library folder where your game is installed. - If another mod may have changed the current
.kfcfiles, verify Enshrouded's files through Steam first. If you want to keep a copy of the old backups, copy them outside the game folder before continuing. - Delete only these files if they are present:
enshrouded.kfc.bakenshrouded.kfc_resources.bak
- Restart ShroudForge. It should create fresh working backups from the current game files.
Do not delete the .kfc or .kfc_resources game files, or any other backup files. If startup still fails, keep the remaining files and share the ShroudForge log with support.