ZConfig
Players and server owners who want a config library for Fabric and Quilt mods can use ZConfig, a mixin config plugin that reads TOML files.
What it does
ZConfig reads TOML config files and exposes boolean and integer entries to other mods. Mod authors can generate a config from a short declaration, so less boilerplate is needed in each mod. The library also lets other mods override a config entry through mod metadata, which lets a pack author adjust a value without editing the original file.
A mod can be marked as incompatible with specific config entries, so the game warns when a conflicting setting is turned on. The library is published for Fabric and Quilt, with files for 26.3 covering game versions 1.21 – 26.3. It works on either side, and neither needs it. The code is released under the Mozilla Public License 2.0, and the project is open source with public source code and an issue tracker. Snapshot builds are published as well.
Key features
TOML config files
Configuration is stored in TOML files, a plain text format that can be read and edited by hand.
Boolean and integer entries
Config entries can be booleans or integers, covering switches and numeric limits in other mods.
Metadata overrides
Other mods can override config entries through their mod metadata, without changing the original config file.
Incompatibility markers
A mod can be marked as incompatible with certain config entries, so conflicting options are flagged.
Generated config sugar
Helper syntax generates config classes with less code, reducing the setup work for each new mod.
Gallery
Compatibility
Latest build for each game version and loader.
26.x5 of 5 versions with builds
1.21.x12 of 12 versions with builds
This mod also publishes snapshot builds. Snapshots are not shown in the matrix.
Required by 3 mods
Use cases
Config for library mods
Mod authors who build several Fabric or Quilt mods can use one shared way to declare and read their settings.
Pack-level tuning
Modpack authors can override entries from another mod's metadata, adjusting behavior without patching its files.
Who it’s for: Mod developers building Fabric or Quilt mods who want generated TOML configs, and modpack authors who tune several mods from one place.
How it compares
OmniMixin runs on Fabric only, for 1.21 – 1.21.1, and is not open source, so it is not a config library and does not match ZConfig's range. Tag Exclusion is server-side only, open source under the MIT License and covers 1.21 – 26.1.2, so players can join without installing it. Interference API is open source under the MIT License, works on client and server and covers 1.17 – 1.21 on Fabric.
| Mod | Loaders | Game versions | Environment | Updated |
|---|---|---|---|---|
| ZConfig | Fabric and Quilt | 1.21 – 26.3 | Client or server, optional | 2026-08-03 |
| OmniMixin | Fabric | 1.21 – 1.21.1 | Client and server | 2026-07-24 |
| Tag Exclusion | Fabric | 1.21 – 26.1.2 | Server-side only | 2026-03-25 |
| Interference API | Fabric | 1.17 – 1.21 | Client and server | 2024-06-26 |
Questions
Does ZConfig need to be installed on the server?
Which loaders does ZConfig support?
Which mods depend on ZConfig?
In the catalog
ZConfig is one of 3,514 Library mods on ModsFinder, and one of 2,348 Library mods for Fabric. 8,071 mods support Minecraft 26.3.
More from Reverie Projects
Similar mods
Official listing
- Modrinth page
- modrinth.com/mod/zconfig
- Owner
- Reverie Projects
- Published
- 2026-07-31
- Updated on Modrinth
- 2026-08-03
- Facts verified
- 2026-10-15
