Latest release · Post an issue
- Table of contents
- AstroSaveConverter
- Convert your game saves
- Manual rollback procedure
- FAQ
- Contributing
- Special thanks
/!\ PLEASE ONLY USE THIS TOOL ON COPIES OF YOUR SAVE FILES. USE AT YOUR OWN RISK /!\
We aren't confident it will work in every case, please give us your feedback !
Be warned : content of your backpack may disappear. Please make sure you empty it before saving your game.
We can't afford to authenticate our software with a licence (waaaay too expensive) so you will have a Windows prompt if you try to run the .exe file. No worries, it's safe ! You must click on "more info" in order to be able to run the software
This project aims to help Astroneer players switching from Microsoft XBOX save format to Steam save format. Astroneer can be played either on Steam or on XBOX Gamepass and both have different ways to store save files. Steam games are saved in one file, no matter the size of the save, while XBOX won't go over 16MB files, splitting the saves into several chunks if they get too big.
The tool is meant to convert Microsoft XBOX save files into Steam save files. In order to do so, it reads the "container" file that states how Microsoft XBOX saves are divided (name and number of chunks that compose each saves). It will then assemble those chunks into one file that can be used by Steam or dedicated servers.
AstroSaveConverter now allows you to convert your Steam saves into Microsoft XBOX format !
- Please only use this tool with copies of your game saves.
- XBOX saves can be found by pressing the Windows key + R and pasting this :
cmd /c Powershell.exe "explorer ((Get-ChildItem $env:LOCALAPPDATA\Packages\SystemEraSoftworks*\SystemAppData\wgs\ -Recurse -Filter container.*).FullName | Where-Object { ((gc $_) -replace \"`0\",\"\") -match '\$(\d){4}'} | Split-Path)"
Steam saves can be found here :
%LocalAppData%\Astro\Saved\SaveGames
- Copy all the files in a new folder on your desktop. Place AstroSaveConverter.exe in that new folder and run it.
- The tool will automatically detect the container file(s) and ask you to chose one.
- It will then ask you to choose wich save(s) you want to convert. Select one or several.
- You will be able to rename the save. Saves can only contain alphanumeric characters and must be less than 30 characters long.
- If the save already exists, you will be able to rename or overwrite the existing file.
- Congratulations, you're done ! AstroSaveConverter will now generate your new save file.
- In a dedicated Steam save folder in case you converted from Microsoft XBOX to Steam
- Directly in your game folder if you converted from Steam to Microsoft XBOX. All you have to do is to launch your game
If your save files have disappeared or have been corrupted, here's how to put the old ones back. Please always make sure to create a copy of your game save folder before using AstroSaveConverter even though we automatically create one for you
- Make sure to close any running Astroneer program
- Go to your Steam save directory by pressing the Windows
key + R and pasting this :
%LocalAppData%\Astro\Saved\SaveGames - Copy the backed up Steam save files into this folder
- Make sure to close any running Astroneer program
- Wait for 1 minute for the game to update its save folder
- Open your Microsoft XBOX game save directory by pressing the Windows key + R and pasting this :
cmd /c Powershell.exe "explorer ((Get-ChildItem $env:LOCALAPPDATA\Packages\SystemEraSoftworks*\SystemAppData\wgs\ -Recurse -Filter container.*).FullName | Where-Object { ((gc $_) -replace \"`0\",\"\") -match '\$(\d){4}'} | Split-Path)"
- Locate a file called container.* (the asterisk can be any number)
- Open the folder where you have made a copy of your original save files and edit the container.* file so the number matches the one seen in the Microsoft XBOX folder
- Delete all the content of the Microsoft XBOX save folder
- Copy all the save files and the updated contaire.* in the Microsoft XBOX save folder
-
I really don't understand "save files", "chunk"...*
Let us recap for you :
Save : Astroneer save file, XBOX or Steam.
Chunk : part of a XBOX Astroneer save if the total save exceeds 16MB. Each chunk size is max 16MB.
Container : file that tells the game which chunks constitute which save. Only for XBOX. -
The text is too small, I can't read anything !
We are not able to change the font size for you. Right click on the title bar and select Properties. Navigate to the Font tab and change the font size of your command prompt. -
Why can't I use more than 30 characters to rename my save ?
We found out that even though Astroneer allows more than 30 characters, it can cause errors when the save become bigger and is splitted in a second chunk : the chunk in the container file will now indicate the part number which adds extra characters. Creative games also have an extra character. -
Why can I only use alphanumeric characters in my save names ?
We didn't know which special characters were allowed in Astroneer and it would be too long to test every option. To avoid compatibility errors, we chose to restrict which characters can be used. You can however edit the save name directly in Astroneer -
I did something wrong, how do I rollback ?
You can read the rollback procedure right on top of this FAQ ! -
How can I know which feature(s) will be added in the tool ?
Please feel free to look at our TODO list !
Contributions are greatly appreciated. Do not hesitate to fork the project and open pull requests ! This software is distributed under the GNU GPLv3 license
We (Tignus and EmptyProfile) would like to thanks everyone who helped us in the process of developping our tool:
- Ricky Davis and his AstroLauncher which we used to start building our own AstroSaveConverter
- Gina and Cyber for their contribution to the "Importing and Converting files between Microsoft & Microsoft OR Microsoft & Steam" thread
- The Twitch chat and in particular WinXaito, AbsoluteVirtue, Zic0h, SyndGame, SamirJap, Elfou for their help and support during the long hours of (improductive) coding