Need help with Configurate?
Click the “chat” button below for chat support from the developer who created it, or find similar developers for support.

About the developer

190 Stars 46 Forks Other 642 Commits 22 Opened issues


A simple configuration library for Java applications providing a node structure, a variety of formats, and tools for transformation

Services available


Need anything else?

Contributors list


GitHub Workflow Status (branch) MIT License Maven Central Sonatype Nexus (Snapshots)

Configurate is a simple configuration library for Java applications that provides a node-based representation of data, able to handle a wide variety of configuration formats.

Want to talk to us about Configurate? Join us in the

channel on our Discord or start a thread on our (new!) Discussions page.

The current supported formats are:

Project Structure

The project is split into different modules.

Configurate core

is the base of the library, containing the main APIs used to manipulate configurations. It is generic, and does not depend on any specific format of configuration.

Configurate loaders

Each distinct configuration format is implemented as a "configuration loader", in a separate module.

A number of loader implementations are provided as standard in this project, however it is possible to implement a custom loader for a new format separately.

The current supported loaders provided by the project are:

  • configurate-gson
    - Implementation for the JSON format, using the Gson library for parsing and generation
  • configurate-hocon
    - Implementation for the HOCON format, using the lightbend config library for parsing and generation
  • configurate-jackson
    - Implementation for the JSON format, using the Jackson library for parsing and generation
  • configurate-xml
    - Implementation for the XML format, using the JAXP library for parsing and generation
  • configurate-yaml
    - Implementation for the YAML format, using the SnakeYAML library for parsing and generation


Some features that don't need tight integration with Configurate itself are provided as separate modules. These are:

  • configurate-extra-dfu[2-4]
    - Integration between Mojang's DataFixerUpper and Configurate's systems.
  • configurate-extra-kotlin
    - Extensions to allow Configurate types to use Kotlin features, and support for Kotlin data classes in the object mapper.
  • configurate-extra-guice
    - Allows using a Guice
    to create new object instances in the object mapper.


  • To use Configurate, your project must be configured to use Java 8 or higher.
  • Releases are on Maven Central and snapshot artifacts are hosted on Sonatype OSS. Builds are also included on SpongePowered's Maven Repository , available at

If your project uses Maven or Gradle, just add the following to your build scripts.


repositories {

dependencies { // Modify this line to target the loader you wish to use. compile 'org.spongepowered:configurate-hocon:4.0.0' }



More detailed usage instructions can be found in the Configurate wiki.



The following steps will ensure your project is cloned properly.

  1. git clone
  2. cd Configurate


Note: If you do not have Gradle 6.8+ installed then use ./gradlew for Unix systems or Git Bash and gradlew.bat for Windows systems in place of any 'gradle' command.

In order to build Configurate you simply need to run the

gradle build
command. You can find the compiled JAR files in
(found in each subproject) labeled similarly to '-x.x.x-SNAPSHOT.jar'.

While the entire project can run on Java 8, the project requires Java 11 to build, and some tests require at least Java 15 to run. Our CI will run these for you if you don't have the latest JDK set up locally.

Pull Requests

We love PRs! However, when contributing, here are some things to keep in mind:

  • Take a look at open issues first before you get too far in -- someone might already be working on what you were planning on doing
  • In general, we follow the Sponge style guidelines for code style -- see the Contributing Guidelines for details.
  • Please, please, please test PRs. It makes the process a lot easier for everybody :)

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.