Skip to content
This repository was archived by the owner on Jun 19, 2025. It is now read-only.

Explanation

Relentless edited this page Jul 16, 2022 · 1 revision

Note

The tool was written for working with the CurseForge launcher. Other launchers have not been tested and are likely incompatible due to other data formats.

Use Case

If you ever wanted to work on a modpack as a team, you may realize that it's pretty easy to manage the pack with a version control system and host it on GitHub or similar sites.

However, due to the functionality of the launcher, it isn't easy to keep track of added/updated/removed mods if you didn't make these changes yourself.

We have seen many people pushing all the mod JARs of their modpack to their repositories which is against many mod licenses and incredibly hard to keep track of.

If you want to have an alternative to keep your modpack launcher profiles in sync with your team, this tool is for you!

How the launcher works

For each created modpack profile, the launcher creates and holds data of all installed mods in a file called minecraftinstance.json.

For some reason, CurseForge decided it's a good thing to store a lot of other data within the same file. This includes all instance data as well as the loader version, the last time you started the profile, the location of the profile, etc.

If you update a single mod or only start the pack, a lot of data in this file will change. So if you are hosting it on a repository, it will be constantly marked as changed.

InstanceSync vs AlmostPacked

Although this tool is inspired by InstanceSync from Vazkii, it has major differences to it.

Like InstanceSync, AlmostPacked also manages the minecraftinstance.json file automatically.

The core difference is that this happens through a separate file that you can host on your repository. That means you no longer have to upload the whole instance file and suffer from constant changes to it although no relevant data was changed that would be needed for your team members.

Other than this, AlmostPacked will use pretty printing and modId sorting for the package file so you will have a clean diff every time you made changes to your modpack profile.

Clone this wiki locally