a flexible, all-in-one configuration API for Fabric mods.

Lortseam 42faaa497f Catch crashes due to invalid config file 4 år sedan
gradle c0024109fa Initial commit 5 år sedan
src 42faaa497f Catch crashes due to invalid config file 4 år sedan
.gitignore 064b496a76 Update to Minecraft 1.16.2 4 år sedan
LICENSE 8251e1d119 Added license 5 år sedan
README.md decd3fef2b Update README 5 år sedan
build.gradle f54b8b0c22 Update TODO 4 år sedan
gradle.properties 42faaa497f Catch crashes due to invalid config file 4 år sedan
gradlew c0024109fa Initial commit 5 år sedan
gradlew.bat c0024109fa Initial commit 5 år sedan
settings.gradle add061087e Minor changes and fixes 5 år sedan

README.md

CompleteConfig

CompleteConfig is a flexible, all-in-one configuration API for Fabric mods.
It takes care of creating and observing config entries, displaying them as GUI, and saving and loading the config.

Goals

The main goal of this library is to provide a comprehensive configuration system solution.
This means:

  • Great flexibility in API usage
  • Full framework, no other libraries are required
  • Easy integration into existing code

Setup

To use the API, first add the JitPack repository to your build.gradle:

repositories {
    ...
    maven { url 'https://jitpack.io' }
}

Then add CompleteConfig as dependency:

dependencies {
    ...

    //This adds CompleteConfig and includes it in your mod's jar, so users don't have to install it
    //Replace Tag with the current version you can find above
    modApi 'com.gitlab.Lortseam:completeconfig:Tag'
    include 'com.gitlab.Lortseam:completeconfig:Tag'
    
    //This bundles Cloth Config in your mod's jar which is required for CompleteConfig
    //Replace Version with current version
    include 'me.shedaniel.cloth:config-2:Version'

    //Recommended: Adds Mod Menu to your game, so you can easily open and check your config GUI (see the Mod Menu documentation for more information)
    //Replace Version with current version
    modImplementation 'io.github.prospector:modmenu:Version'
}

Usage

See the wiki for usage instructions.
You can also take a look at the example mod which uses many features of this API.

License

This project is licensed under the Apache License 2.0 - see the LICENSE file for details.