Introduction

Custom Matter Datapack: The Basics

As with everything in modern Minecraft versions, this mod uses a datapack for customization.

Examples will be provided as this tutorial goes on, but for now you should know the basics of a datapack: It's a zip file, requires Open Loader (or something similar) to automatically add it to new worlds, and has specific formatting that must be followed (like file structure).

Be sure to read thoroughly, as this wiki will go into detail at times and include examples (whether they be text or images).

And in case you don't already know, File Explorer is the program you use to navigate through files & folders on Windows. We will refer to it every so often in this guide.

Matter

Matter is used to make everything in the mod, and there are are eight types:

• Earth
• Organic
• Living
• Metallic
• Precious
• Nether
• Ender
• Quantum

When adding values, you don't have to put them in that order (or the order the mod uses) - but it's good to do so since it speeds up the editing process.

Important Note: The mod will auto-calculate matter values with vanilla recipe handlers (crafting, smelting, etc.), so you only need to add values to basic components that don't have it

All items will render their matter value in their tooltips when shift is held:

It's also worth noting that most values are rather arbitrary, but they should be divisble by 9 if you're adding them to an ingot or something similar (that way the auto-calculator can assign proper values to each item). 36 is the standard value for ingots/gems that Replicatoin itself uses, so you may wish to do the same.

File Structure

Before adding matter, you must assemble a basic datapack with the following structure:

It's also good practice to keep these main files in their own folder (especially if you've got multiple datapacks for various mods).

Note: All folders & file names will be lowercase, and never use capitalization.

• The data folder is where everything will be stored.
• pack.mcmeta is required as it tells Minecraft what version to load this for (and lets you add a description). For 1.20.1, the pack format is 18.

{
    "pack": {
        "pack_format": 18,
        "description": "You can add a description if you want!"
    }
}

• pack.png is optional, and lets you add an image that will appear in the datapack list of a world.

After doing so, make the following folders inside of the main data folder:

replication\aequivaleo\locked\general

If you navigate to general, your address bar should look like this:

The "general" folder is where we'll store custom matter values. I recommend making a shortcut to this folder in the folder with your modpack development materials (or on your desktop or whatever - it just makes things easier since you won't have to click as much).

After this, you can begin to make json files containing one file for each item/tag you want to add matter too.

Conclusion & Navigation

This concludes the intro. You should know the basics by now, but if not feel free to re-read the page and/or ask in the Discord Server.

You may navigate to Part 2 to find out how to add custom matter values to items & tags:

Part 2: Adding Matter

If you would like to know how to view item tags and registry names, go to one of these pages:

How to view item tags
How to get registry names