Oro-Config

A simple mod config with ModMenu and command integration

Goal

My goal in creating this library was to make an light-weight config library that feels like the json that you save your code to. Along the way I addded support for commands and ModMenu/ClothConfig screens.

How to include

Include my library in your mod by adding it to your build.gradle file.

Make sure my bintray repo is included in your repositiories section:

repositories {
  maven {
    url = "https://dl.bintray.com/oroarmor/oroarmor"
  }
}

Then in your dependencies section add my library to the classpath and jar-in-jar it so that users dont have to download an extra file:

The current version is:

dependencies {	
  modImplementation 'com.oroarmor:oro-config:${version}'
  include 'com.oroarmor:oro-config:${version}'
}

How to use

The best way to use my config is to extend com.oroarmor.config.Config with your own class. Inside this class, you should include other classes that extend com.oroarmor.config.ConfigItemGroup for your config groups. See the example for a way to use the library.

Config Item

ConfigItems are the main storage of the different values that make up your config. Currently the only supported types are String, Double, Integer, Boolean, and all enums (Technically ConfigItemGroups, but those are extremely different). There are two constructors for ConfigItem:

ConfigItem(String name, T defaultValue, String details)

and

ConfigItem(String name, T defaultValue, String details, Consumer<ConfigItem<T>> onChange)

T is the type of data that you are storing in this ConfigItem, being on of the supported types.

The name is for the name of this ConfigItem, which is used in the json to identify what the values are used for. The default value is the value that is normal for the config to use, but is overriden when the config file is read. The details are a string representing a language key that can be used in your lang file as it is used in both commands and in the Cloth Config support.

The second constructor has an onChange parameter, which is a Consumer that is run every time this config is changed, which can be used to send data to clients on servers or trigger other events.

Config Item Groups

ConfigItemGroups are a way to store multiple ConfigItems into one group. ConfigItemGroups can be nested in each other for sub groups. There is one constructor:

ConfigItemGroup(List<ConfigItem<?>> configs, String name)

Configs is for a list of ConfigItems, not needing any type. Name is for the name of the ConfigItemGroup, and is used in the same way as name for ConfigItem.

Config

Config is the root for your mod config and can read and save to files with just one method. Currently Configs only store a list of ConfigItemGroups and a single ConfigItem cannot be be stored. Because the file for a config can be defined, there can be configs for the entire mod, per world, and even per dimension (Commands and ClothConfig have only been tested with entire mod examples). Configs will auto-initialize themselves and should always be read and then written to (If the config file does not exist when trying to read, it will not crash and will create the file in the write method). This ensures that any user data is read and not overwritten. There is one constructor:

Config(List<ConfigItemGroup> configs, File configFile, String id)

Configs is for the list of ConfigItemGroups File is for the file to save the config into. Id is for the ID of the config which is used in commands and modmenu.

Command

ConfigCommand is a simple class that ust requires a Config in its constructor. It does not handle its own registering, and must be registered through Fabric API

Cloth Config

ModMenuConfigScreen is an abstract class that requires you to extend it, passing in your config into a super constructor. Because this is used as an entry point, your constructor must have no parameters.

Example:

These are pulled from the testmod, and are part of this repositiory. Test Mod

Config Class:

public class TestConfig extends Config {
    public static final ConfigItemGroup mainGroup = new ConfigGroupLevel1();

    public static final List<ConfigItemGroup> configs = of(mainGroup);

    public TestConfig() {
        super(configs, new File(FabricLoader.getInstance().getConfigDir().toFile(), "oroarmor_config_testmod.json"), "oroarmor_config_testmod");
    }

    public static class ConfigGroupLevel1 extends ConfigItemGroup {
        public static final ConfigItem<EnumTest> testEnum = new ConfigItem<>("test_enum", EnumTest.A, "test_enum");
        public static final ConfigItem<Boolean> testItem = new ConfigItem<Boolean>("test_boolean", true, "test_boolean");

        public ConfigGroupLevel1() {
            super(of(new NestedGroup(), testItem, testEnum), "group");
        }

        public static class NestedGroup extends ConfigItemGroup {
            public static final ConfigItem<Integer> nestedItem = new ConfigItem<Integer>("test_int", 0, "test_integer");

            public NestedGroup() {
                super(of(nestedItem, new TripleNested()), "nested");
            }

            public static class TripleNested extends ConfigItemGroup {
                public static final ConfigItem<String> testString = new ConfigItem<String>("test_string", "Default", "test_string");

                public TripleNested() {
                    super(of(testString), "triple");
                }
            }
        }
    }
}

This then creates a config file called oroarmor_config_testmod.json in the /config/ directory wherever Minecraft is run:

{
  "group": {
    "nested": {
      "test_int": 0,
      "triple": {
        "test_string": "Default"
      }
    },
    "test_boolean": true,
    "test_enum": "A"
  }
}

Command Registration:

CommandRegistrationCallback.EVENT.register(new ConfigCommand(YOUR_CONFIG)::register);

Mod Menu Integration:

public class ModMenuIntegration extends ModMenuConfigScreen {
	public ModMenuIntegration() {
		super(OroConfigTestMod.CONFIG);
	}
}

Entry point:

"entrypoints": {
  "main": ["com.oroarmor.config.testmod.OroConfigTestMod"],
  "modmenu": ["com.oroarmor.config.testmod.ModMenuIntegration"]
}