A small tool to make your life easier when modding COSR (and maybe other Amulet engine games, but no promises)

So… what does this thing even do?
The Patch Manager lets you:

• Unpack the game’s files so you can poke around and change stuff
  
• Test your changes without messing up your original game
  
• Make small .patch files to share with friends or the community
  
• Apply other people’s patches in seconds

It was made for The Catacombs of Solaris Revisited, but it should work on other Amulet Game Engine games too. The only COSR-specific thing is the log folder shortcut.

Think of it as a safe sandbox: original game files are always backed up, so you can’t “break” anything.

Step 1: Open your game’s local files

• In Steam, right-click the game → Properties
  
• Go to Installed Files → Browse
  
• This should open something like:
  
  C:\Program Files (x86)\Steam\steamapps\common\The Catacombs of Solaris Revisited

You should be looking at something like this:


Step 2: Download the Patch Manager
Go to the patch manager's github[github.com]
From here, you can

Download it via zip

• Open the repo
  
• Click on the green code button
  
• Download as zip
  
• Extract the zip

Download the whole repo (if you want this, I think you don't need help)

You should see something like this:

Step 3 — Copy these files

• patch_manager.bat
  
• patch_manager.ps1
  
• The whole /patches/ folder

Into your game's root folder. It should look something like this:

Step 4 — First-time setup

• Double-click patch_manager.bat
  
• Pick [1] Clean setup
  
• Done! You’re ready to mod

This is a one time thing, from now on, opening the tool should look something like this:

The repo already comes with a QoL update that includes:

• Multiple image selection support
  
• Adds better controller support
  
• Improves the menu and explanations
  
• Toggle all mutators button

Heads up: You can only have one patch active at a time. Loading a new one replaces the old one.

To apply a patch, you should open up the patch manager:
And select option 1

This will now list all available patches inside the patches folder, and will also give you the option to reset to the original data file.

Just enter the number of the patch you want to apply, and that's it!

After applying your patch, you should be able to open up the game and see the changes applied! In this case, as of August 11th, the included patch should change your menu's layout to something like this:

When selecting the image mode, youll be promted to input one image at a time. Whenever you're done, press cancel on the explorer window. You should now see something like this:
You can now follow the screen's instructions and press enter in the main menu to begin the game with multiple images.

The patch is rather basic, it cycles through the available textures over time (or instantly when pressing N) and applies them to the next generated mesh. It also doesn't load over a folder and all your selections are lost if you input a wrong image type. There's still work to be done, but the basic feature and modding tools are already here, so here you go!

Heads up, again: You can only have one patch active at a time. Loading a new one replaces the old one.

The game's code will be automatically extracted on the initial setup. In your extracted_game folder you'll see all the game's code and assets.

However, on the patch_manager main menu you can always press 2 to unpack the current game code.
So if you applied a patch and want to take a look at it, you would

1.- Apply the patch using option 1
2.- Extracting the files using option 2

You can now freely edit the code to your heart's content and use option 3 to automatically build your code and run the game to test it. It will go back to whatever the game was before your test, so don't worry about accidentally breaking anything.


If the game ever crashes or shows an error, you can use option 6 to open the logs folder. In there, you will find a .log file containing the crash report of the game. But don't worry, every time you close the game on the "Build and test" option, it will restore to the version prior to the test!

After your mod is complete, you can select option 4 to create a patch. This will ask some basic info (patch name, patch description and patch author) so let's just fill it out

After filling out the info, it will create a .patch file for you. The log should look something like this:

Once this is done, you'll be able to see your new patch inside the patches folder

And to permanently apply the patches changes, you'll have todo option 1 to list and load the patch.

If you want to share a patch with the community, just share your .patch file around!

This was a small weekend project, but I'm open to suggestions on how the flow works, and if there are any issues with the multi image selction patch I'm open to see them fixed.

Any other feature suggestions are now technically possible given someone's willing to code it themselves, and having only 1 patch available at a time is not ideal either - but this can do for now.

I don't think I'll be updating the tool/mod, but feel free to make your own changes and send them to me. If a mod looks good enough, I can add it to the pre-loaded patch list for all users to enjoy. Or if you make changes on either the manager or my patch, feel free to reach out and request a change inside git.