README.md 1.6 KB

CompleteConfig

CompleteConfig is a flexible, all-in-one configuration API for Fabric mods. It aims to be full-featured and extensible.

Highlights

Beside the basic elements of a config library, CompleteConfig offers some unique features:

  • Multiple configs
  • Nested class support - easily create a POJO structure
  • Simple integration into existing code
  • Listeners - observe your config entries
  • User-friendly save format
  • Commentable files - comments are retained permanently
  • Configurable GUI generation
  • Extension system

Setup

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

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

Then add CompleteConfig to the dependencies:

dependencies {
    [...]

    // Adds CompleteConfig and bundles it within the mod's jar file
    // Replace Tag with the current version you can find above
    modImplementation ("com.gitlab.Lortseam:completeconfig:Tag")
    include("com.gitlab.Lortseam:completeconfig:Tag")
    
    // Bundles Cloth Config within the mod's jar file
    // Only required if you want to display a config GUI and don't provide your own screen builder
    // Replace Version with the current version
    include("me.shedaniel.cloth:config-2:Version")
}

Usage

Usage instructions can be found in the wiki.

License

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