
Modrinth · Minecraft mod
ZConfig
A mixin config plugin for zfastnoise
Quick answer
Which ZConfig release matches 26.2-pre-6?
ZConfig 1.0.0+26.x targets 26.1, 26.1.1-rc-1, 26.1.1 with Fabric, Quilt. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is ZConfig required on the client, server, or both?
Installation on the client is optional. Installation on the dedicated server is optional.
The source marks this as usable on both the client and server.
What else does ZConfig 1.0.0+26.x need?
1.0.0+26.x on 26.2-pre-6. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add ZConfig without breaking your instance.
Built for ZConfig 1.0.0+26.x on 26.2-pre-6. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 1.0.0+26.x. It targets 26.1, 26.1.1-rc-1, 26.1.1 with Fabric, Quilt; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
Installation on the client is optional. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 1.0.0+26.x. It opens that exact file at the source.
About this project
What does ZConfig add?
Why does this project exist?
This is a general purpose config mod slightly based on c2me's internal config system.
This also lets me reduce zfastnoise's size to a few dozen kilobytes and users only have to download the config mod once.
Features
- Toml based config files
- boolean and int based config entries
- allow other mods to override config entries using mod metadata
- mark mods as incompatible with certain config entries
For example, fabric.mod.json
{
...
"custom": {
"zfastnoise:overrides" : "mixin.perf.surface"
}
}
The above disables mixin.perf.surface config option
Future plans
- add support for modmenu/forge config api
- add neoforge builds
- add more sugar to easily generate config
Example config
package org.codeberg.zenxarch.zconfig.test;
import org.codeberg.zenxarch.zconfig.entry.BooleanConfigEntry;
import org.codeberg.zenxarch.zconfig.entry.ConfigEntries;
import org.codeberg.zenxarch.zconfig.entry.IntConfigEntry;
import org.codeberg.zenxarch.zconfig.loader.Config;
import org.codeberg.zenxarch.zconfig.loader.ConfigLoader;
import org.codeberg.zenxarch.zconfig.loader.OverrideCollector;
import org.junit.jupiter.api.Test;
public class ExampleConfig extends ConfigEntries {
public static final ExampleConfig INSTANCE = new ExampleConfig();
public static final BooleanConfigEntry MAIN =
INSTANCE.createEntry(
"main",
builder -> builder.addComment("Main entry").defaultValue(false).addIncompat("sodium"));
public static final IntConfigEntry OTHER =
INSTANCE.createIntEntry(
"other", builder -> builder.addComment("Other entry").defaultValue(0).constraints(-1, 1));
public static final Config CONFIG =
new Config(
new ConfigLoader("example_mod_id", INSTANCE), new OverrideCollector("example_mod_id"));
@Test
public void loadConfig() {
IO.println(CONFIG.get(MAIN));
IO.println(CONFIG.get(OTHER));
IO.println(CONFIG.loadMixinEntries());
}
}
Project description from Modrinth.
Pick your setup
ZConfig by Minecraft version and loader
Choose the version and loader you play, then open the matching release.
26.3-snapshot-9
2 loader builds26.3-snapshot-8
2 loader builds26.3-snapshot-7
2 loader builds26.3-snapshot-6
2 loader builds26.3-snapshot-5
2 loader builds26.3-snapshot-4
2 loader builds26.3-snapshot-3
2 loader builds26.3-snapshot-2
2 loader builds26.3-snapshot-1
2 loader builds26.2-snapshot-8
2 loader builds26.2-snapshot-7
2 loader buildsShowing the newest 12 of 129 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
ZConfig versions and loaders
1.0.0+26.x
zconfig-1.0.0+26.x.jar
3 Aug 2026
Looking for an older file? The official Modrinth project page is in Resources.