Getting started | OneConfig V1

This is NOT a guide on how to start with modding or set up a modding template. There is documentation for every version of Minecraft that we support on how to set up a mod on their loader.

For Forge 1.8.9 and 1.12.2: https://moddev.nea.moe/ide-setup/

For Forge (modern): https://docs.minecraftforge.net/en/latest/gettingstarted/

For Fabric: https://fabricmc.net/wiki/tutorial:start#creating_your_first_mod

For NeoForge: https://docs.neoforged.net/docs/gettingstarted/

From there, instead of using the default templates of those loaders, you would use the OneConfigExampleMod.

Latest versions

OneConfig Example Mod

If you're just starting out or need more advanced features like multiple versions, we highly recommend looking at our example mod. When cloning the example mod, please choose from one of the following branches:

Including OneConfig yourself

If you don't want to use our mod template, or wish to include OneConfig in one of your new or existing mods, add this to your build.gradle(.kts).

While you’re here, we recommend using Deftu's Gradle Toolkit, which automatically configures everything in your project for you, including OneConfig. DGT is included in our example mod template.

The toolkit works for all Minecraft versions from 1.8.9 - latest, and supports Forge, Fabric and NeoForge. Setting it up is as simple as applying the appropriate plugins for your needs and configuring the required configuration options. DGT also supports complicated setups such as multi-version projects.

It also provides several smaller utilities for things such as authenticating your Minecraft/Microsoft account in the developer environment via DevAuth or setting up your own Forge coremod.

Available modules

OneConfig's functionality is split into several modules for ease of use and to improve the developer experience. When making a mod using OneConfig, you will need to individually select modules you will be utilizing within your mod in order to gain access to their functionality, and the platform / Minecraft version-specific implementation of OneConfig.

Module

Purpose

commands

The tree based command system used in OneConfig.

config

The tree based configuration system used in OneConfig.

config-impl

The default implementation of the configuration system used in OneConfig.

events

The event system used in OneConfig.

hud

The HUD system used in OneConfig.

internal

OneConfig's UI implementation.

ui

The UI system used in OneConfig.

utils

Various utilities used in OneConfig.

Setting up your build files

toolkitLoomHelper {
    useOneConfig {
        version = "1.0.0-alpha.XXX" // Put whatever the latest is here
        loaderVersion = "1.1.0-alpha.XX" // Put whatever the latest is here

        usePolyMixin = true // If you want to use Mixin on Legacy Forge, you need PolyMixin
        polyMixinVersion = "0.8.4+build.2" // If you want to use Mixin on Legacy Forge, you need PolyMixin

        applyLoaderTweaker = true // Set this to false if you want to use a custom tweaker.

        for (module in arrayOf("commands", "config-impl", "events", "hud", "internal", "ui", "utils")) {
            +module
        }
    }
}

loom {
    launchConfigs.named("client") {
        if (platform.isLegacyForge) { // If Forge and MC is 1.12.2 or below
            // Loads OneConfig in dev env. Replace other tweak classes with this, but keep any other attributes!
            arg("--tweakClass", "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker")
        }
    }
}

repositories {
    maven("https://repo.polyfrost.org/releases")
    maven("https://repo.polyfrost.org/snapshots") // Remove when OneConfig is out of beta
}

dependencies {
    // `include` should be replaced with a configuration that includes your dependencies in the JAR
    
    // Basic OneConfig dependencies for legacy versions. See OneConfig example mod for more info
    val oneConfigMcVersion = "1.8.9"
    val oneConfigModLoader = "forge"
    val oneConfigModules = arrayOf("commands", "config-impl", "events", "hud", "internal", "ui", "utils") // Refer to possible modules above
    val oneconfigVersion = "1.0.0-alpha.XXX" // Put whatever the latest is here
    for (module in oneConfigModules) {
        if (platform.isLegacyForge) {
            compileOnly("org.polyfrost.oneconfig:$module:$oneConfigVersion") // Should NOT be included in JAR
        } else {
            implementation("org.polyfrost.oneconfig:$module:$oneConfigVersion") // Should NOT be included in JAR
        }
    }
    
    if (platform.isLegacyForge) {
        val loaderModule = "launchwrapper"
        val loaderVersion = "1.1.0-alpha.XX" // Put whatever the latest is here
        include("org.polyfrost.oneconfig:stage0:$loaderModule:$loaderVersion") // Should be included in JAR
        
        modCompileOnly("org.polyfrost.oneconfig:$oneConfigMcVersion-$oneConfigModLoader:$oneConfigVersion")
    } else {
        modImplementation("org.polyfrost.oneconfig:$oneConfigMcVersion-$oneConfigModLoader:$oneConfigVersion")
    }
}

tasks {
    jar { // loads OneConfig at launch. Add these launch attributes but keep your old attributes!
        if (platform.isLegacyForge) {
            manifest.attributes += mapOf(
                "ModSide" to "CLIENT",
                "TweakOrder" to 0,
                "ForceLoadAsMod" to true,
                "TweakClass" to "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker"
            )
        }
    }
}

toolkitLoomHelper {
    useOneConfig {
        version = "1.0.0-alpha.XXX" // Put whatever the latest is here
        loaderVersion = "1.1.0-alpha.XX" // Put whatever the latest is here

        usePolyMixin = true // If you want to use Mixin on Legacy Forge, you need PolyMixin
        polyMixinVersion = "0.8.4+build.2" // If you want to use Mixin on Legacy Forge, you need PolyMixin

        applyLoaderTweaker = true // Set this to false if you want to use a custom tweaker.

        for (String module : ["commands", "config-impl", "events", "hud", "internal", "ui", "utils"]) {
            addModule(module)
        }
    }
}

loom {
    launchConfigs {
        client {
            if (platform.isLegacyForge) { // If Forge and MC is 1.12.2 or below
                // Loads OneConfig in dev env. Replace other tweak classes with this, but keep any other attributes!
                arg("--tweakClass", "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker")
            }
        }
    }
}

repositories {
    maven { url 'https://repo.polyfrost.org/releases' }
    maven { url 'https://repo.polyfrost.org/snapshots' } // Remove when OneConfig is out of beta
}

dependencies {
    // `include` should be replaced with a configuration that includes your dependencies in the JAR

    // Basic OneConfig dependencies for legacy versions. See OneConfig example mod for more info
    def oneConfigMcVersion = "1.8.9"
    def oneConfigModLoader = "forge"
    def oneConfigModules = ["commands", "config-impl", "events", "hud", "internal", "ui", "utils"] // Refer to possible modules above
    def oneconfigVersion = "1.0.0-alpha.XXX" // Put whatever the latest is here
    for (String module : oneConfigModules) {
        if (platform.isLegacyForge) {
            compileOnly('org.polyfrost.oneconfig:${module}:${oneConfigVersion}') // Should NOT be included in JAR
        } else {
            implementation('org.polyfrost.oneconfig:${module}:${oneConfigVersion}') // Should NOT be included in JAR
        }
    }
    
    if (platform.isLegacyForge) {
        def loaderModule = "launchwrapper"
        def loaderVersion = "1.1.0-alpha.XX" // Put whatever the latest is here
        include('org.polyfrost.oneconfig:stage0:$loaderModule:$loaderVersion') // Should be included in JAR
        
        modCompileOnly('org.polyfrost.oneconfig:${oneConfigMcVersion}-${oneConfigModLoader}:${oneConfigVersion}')
    } else {
        modImplementation('org.polyfrost.oneconfig:${oneConfigMcVersion}-${oneConfigModLoader}:${oneConfigVersion}')
    }
}

jar { // loads OneConfig at launch. Add these launch attributes but keep your old attributes!
    if (platform.isLegacyForge) {
        manifest.attributes(
                "ModSide": "CLIENT",
                "TweakOrder": "0",
                "ForceLoadAsMod": true,
                "TweakClass": "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker",
        )
    }
}

loom { launchConfigs.named("client") { if (platform.isLegacyForge) { // If Forge and MC is 1.12.2 or below // Loads OneConfig in dev env. Replace other tweak classes with this, but keep any other attributes! arg("--tweakClass", "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker") } } } repositories { maven("https://repo.polyfrost.org/releases") maven("https://repo.polyfrost.org/snapshots") // Remove when OneConfig is out of beta } dependencies { // `include` should be replaced with a configuration that includes your dependencies in the JAR // Basic OneConfig dependencies for legacy versions. See OneConfig example mod for more info val oneConfigMcVersion = "1.8.9" val oneConfigModLoader = "forge" val oneConfigModules = arrayOf("commands", "config-impl", "events", "hud", "internal", "ui", "utils") // Refer to possible modules above val oneconfigVersion = "1.0.0-alpha.XXX" // Put whatever the latest is here for (module in oneConfigModules) { if (platform.isLegacyForge) { compileOnly("org.polyfrost.oneconfig:$module:$oneConfigVersion") // Should NOT be included in JAR } else { implementation("org.polyfrost.oneconfig:$module:$oneConfigVersion") // Should NOT be included in JAR } } if (platform.isLegacyForge) { val loaderModule = "launchwrapper" val loaderVersion = "1.1.0-alpha.XX" // Put whatever the latest is here include("org.polyfrost.oneconfig:stage0:$loaderModule:$loaderVersion") // Should be included in JAR modCompileOnly("org.polyfrost.oneconfig:$oneConfigMcVersion-$oneConfigModLoader:$oneConfigVersion") } else { modImplementation("org.polyfrost.oneconfig:$oneConfigMcVersion-$oneConfigModLoader:$oneConfigVersion") } } tasks { jar { // loads OneConfig at launch. Add these launch attributes but keep your old attributes! if (platform.isLegacyForge) { manifest.attributes += mapOf( "ModSide" to "CLIENT", "TweakOrder" to 0, "ForceLoadAsMod" to true, "TweakClass" to "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker" ) } } }

loom { launchConfigs { client { if (platform.isLegacyForge) { // If Forge and MC is 1.12.2 or below // Loads OneConfig in dev env. Replace other tweak classes with this, but keep any other attributes! arg("--tweakClass", "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker") } } } } repositories { maven { url 'https://repo.polyfrost.org/releases' } maven { url 'https://repo.polyfrost.org/snapshots' } // Remove when OneConfig is out of beta } dependencies { // `include` should be replaced with a configuration that includes your dependencies in the JAR // Basic OneConfig dependencies for legacy versions. See OneConfig example mod for more info def oneConfigMcVersion = "1.8.9" def oneConfigModLoader = "forge" def oneConfigModules = ["commands", "config-impl", "events", "hud", "internal", "ui", "utils"] // Refer to possible modules above def oneconfigVersion = "1.0.0-alpha.XXX" // Put whatever the latest is here for (String module : oneConfigModules) { if (platform.isLegacyForge) { compileOnly('org.polyfrost.oneconfig:${module}:${oneConfigVersion}') // Should NOT be included in JAR } else { implementation('org.polyfrost.oneconfig:${module}:${oneConfigVersion}') // Should NOT be included in JAR } } if (platform.isLegacyForge) { def loaderModule = "launchwrapper" def loaderVersion = "1.1.0-alpha.XX" // Put whatever the latest is here include('org.polyfrost.oneconfig:stage0:$loaderModule:$loaderVersion') // Should be included in JAR modCompileOnly('org.polyfrost.oneconfig:${oneConfigMcVersion}-${oneConfigModLoader}:${oneConfigVersion}') } else { modImplementation('org.polyfrost.oneconfig:${oneConfigMcVersion}-${oneConfigModLoader}:${oneConfigVersion}') } } jar { // loads OneConfig at launch. Add these launch attributes but keep your old attributes! if (platform.isLegacyForge) { manifest.attributes( "ModSide": "CLIENT", "TweakOrder": "0", "ForceLoadAsMod": true, "TweakClass": "org.polyfrost.oneconfig.loader.stage0.LaunchWrapperTweaker", ) } }

hashtagLatest versions

hashtagOneConfig Example Mod

hashtagIncluding OneConfig yourself

hashtagAvailable modules

hashtagSetting up your build files

Latest versions

OneConfig Example Mod

Including OneConfig yourself

Available modules

Setting up your build files