📦 Smootheez Config Lib (SCL)
A utility mod designed to simplify configuration handling for Minecraft modding.
Primarily developed for my own mods, but freely available for public use.
❓ What is SCL?
Smootheez Config Lib (SCL) provides an easier and cleaner way to manage configurations for Minecraft mods.
It removes boilerplate and offers a simple interface for:
- ✅ Config file management
- 🛠️ Automatic config screen generation
- ⚙️ Automatic config file generation
🖼️ In-Game Previews
🔧 Standard Config Screen
📝 Config Screen with Descriptions
🗂️ Edit Value in OptionList
➕ Add Value to OptionList
❗ Confirmation Screen
🚀 Getting Started
🏗️ Step 1 – Add Repository
In your build.gradle:
repositories {
maven {
url "https://jitpack.io"
}
}
📦 Step 2 – Add Dependency
Using version from gradle.properties:
dependencies {
modImplementation "com.github.smootheez:scl:${project.scl_version}"
}
Or use the version directly:
dependencies {
modImplementation "com.github.smootheez:scl:[version]"
}
💡 Example Usage
🧱 Step 1 – Create a Config Class
@Config(name = "example_config", gui = true)
public class ExampleConfig {
public static final ConfigOption<Integer> INT_TEXT = ConfigOption.create("intText", 0, -5, 100);
public static final ConfigOption<Double> DOUBLE_TEXT = ConfigOption.create("doubleText", 0.0, 0.0, 2.0);
public static final ConfigOption<Integer> INT_SLIDER = ConfigOption.create("intSlider", 0, -5, 100).asSlider();
public static final ConfigOption<Double> DOUBLE_SLIDER = ConfigOption.create("doubleSlider", 0.0, 0.0, 2.0).asSlider();
public static final ConfigOption<Double> DOUBLE_SLIDER_PERCENTAGE = ConfigOption.create("doubleSliderPercentage", 0.0, 0.0, 2.0).asSliderPercentage();
public static final ConfigOption<Boolean> BOOLEAN = ConfigOption.create("boolean", false);
public static final ConfigOption<OptionList> LIST = ConfigOption.create("list", "example_value_1", "example_value_2", "example_value_3");
public static final ConfigOption<ExampleEnum> ENUM = ConfigOption.create("enum", ExampleEnum.EXAMPLE_VALUE_1);
}
🧩 Step 2 – Register the Config
In your fabric.mod.json:
"entrypoints": {
// ...existing entrypoints
"scl": [
"dev.smootheez.scl.example.ExampleConfig"
]
}
✅ That's it! SCL will automatically generate:
- The config file
- The config screen (requires
ModMenu)
📌 Note: The config screen will only be generated if:
gui = trueis set- The config
namematches your mod ID
📥 Download
🐞 Issue Tracker
Found a bug or have a feature suggestion?
Submit an issue here: GitHub Issues
⚠️ Important Notes
- ✅ Compatible with Minecraft 1.20.1+
- 📜 Licensed under the MIT License
☕ Support Me
If you find this project helpful and want to support my work, consider donating:
No gallery available for this project.
| Version | Minecraft | Loader | Download |
|---|---|---|---|
|
Smootheez Config Lib 0.2.2-1.20.2 0.2.2-1.20.2 |
1.20.2
|
fabric
|
Download |
|
Smootheez Config Lib 0.2.1-1.21.6 0.2.1-1.21.6 |
1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Smootheez Config Lib 0.2.0-1.21.6 0.2.0-1.21.6 |
1.21.6, 1.21.7, 1.21.8
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.9-1.20.5 0.1.9-1.20.5 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.8-1.20.3 0.1.8-1.20.3 |
1.20.3, 1.20.4
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.7-1.20.2 0.1.7-1.20.2 |
1.20.2
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.6-1.20.1 0.1.6-1.20.1 |
1.20.1
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.5-1.20.5 0.1.5-1.20.5 |
1.20.5, 1.20.6, 1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4, 1.21.5
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.4-1.20.3 0.1.4-1.20.3 |
1.20.3, 1.20.4
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.3-1.20.2 0.1.3-1.20.2 |
1.20.2
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.2-1.20.2 0.1.2-1.20.2 |
1.20.2
|
fabric
|
Download |
|
Smootheez Config Lib 0.1.1-1.20.1 0.1.1-1.20.1 |
1.20.1, 1.20.2
|
fabric
|
Download |
|
Smootheez Config Lib 0.0.9 0.0.9 |
1.21, 1.21.1, 1.21.2, 1.21.3, 1.21.4
|
fabric
|
Download |
|
Smootheez Config Lib-0.0.8 0.0.8 |
1.20.5, 1.20.6
|
fabric
|
Download |
|
Smootheez Config Lib-0.0.7 0.0.7 |
1.20.4
|
fabric
|
Download |