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

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

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.