For developers

Below are the instructions for setting up and using Deimos. For more details about this library, be sure to check out its GitHub page.

Setup

You can either use my IntelliJ templates which generate a new MultiLoader project with Deimos preconfigured, or follow these instructions to set it up manually:

In build.gradle

repositories {
    maven {
        url = "https://api.modrinth.com/maven"
    }
}

Forge and Neoforge:

dependencies {
    implementation "maven.modrinth:deimos:${project.deimos_version}"
}

Fabric:

dependencies {
    modImplementation "maven.modrinth:deimos:${project.deimos_version}"
    //if you want to use modmenu
    modCompileOnly "com.terraformersmc:modmenu:${project.modmenu_version}"
}

if you want to use the mod menu functionality you need to add a new repository:

repositories {
    maven {
        name = "Terraformers"
        url = "https://maven.terraformersmc.com/"
    }
}

You can find the specific Deimos version you need on Modrinth

How to use it

Creating configs

You can add configs in a class that extends DeimosConfig:

public class TestConfig extends DeimosConfig {
    @Entry public static int test_int = 6;
    @Entry public static List<String> test_string_list = Lists.newArrayList(
            "minecraft:acacia_planks", "minecraft:andesite");
}

And then in your initialize method you need to call DeimosConfig.init like this:

DeimosConfig.init(MOD_ID, TestConfig.class);

Adding new recipes

To add new recipes you call methods from DeimosRecipeGenerator in your initialize method. You can add shapeless crafting, shaped crafting, smelting, smoking, blasting, campfire and stone cutting recipes. Here are some examples:

DeimosRecipeGenerator.createSmeltingJson(TestConfig.test_string_list.get(0), TestConfig.test_string_list.get(1), TestConfig.test_int, 0.5F);

DeimosRecipeGenerator.createShapedRecipeJson(
        Lists.newArrayList('#'),
        Lists.newArrayList(ResourceLocation.parse("sand")),
        Lists.newArrayList("item"),
        Lists.newArrayList(
                "# ",
                " #"
        ),
        ResourceLocation.parse("stone"), 1);

Notice that you can use values from your config file. If the player changes them and restarts the game, the recipes will also change. This even works with modded items.