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

Lortseam 17a175089f [WIP] Float and Double bounds 5 years ago
gradle c0024109fa Initial commit 5 years ago
src 17a175089f [WIP] Float and Double bounds 5 years ago
.gitignore c0024109fa Initial commit 5 years ago
LICENSE 8251e1d119 Added license 5 years ago
README.md 740c7afc5f Add wiki link to README 5 years ago
build.gradle 3e41ae2c63 Fix Cloth Config dependency 5 years ago
gradle.properties 17a175089f [WIP] Float and Double bounds 5 years ago
gradlew c0024109fa Initial commit 5 years ago
gradlew.bat c0024109fa Initial commit 5 years ago
settings.gradle add061087e Minor changes and fixes 5 years ago

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 in 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 includes 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 ModMenu to your game, so you can easily open your config GUI
    //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.