Fzzy Config Mod
Config API with automatic GUIs, powerful validation options, server-client sync, and more! • Fabric / Forge / NeoForge / Quilt
📖 Mod Overview & Core Features
Fzzy Config is a powerful multi-loader configuration engine for MCPE Mods that meets you where you want to be. Quick and dirty or detailed and featureful, Fzzy Config will work with you. It provides a wide array of features above and beyond what you can find in other libraries.
📄 The Basics
- Automatic serialization – to TOML format.
- Minimal API – with lightweight integration requirements.
- Plain Java/Kotlin objects – or Minecraft GameOptions-like carefully crafted settings.
- Seamless multi-loader support – use the same API on Fabric and Forge.
🖥️ Automatic GUIs
- Automatic GUI generation – based on the layout and content of your config files.
- Fully keyboard-navigable – and narratable out of the box.
- Fully vetted and tested – by a visually impaired member of the modding community.
- No need for screen builders – or registration. ModMenu and Catalogue automatically integrated.
🔄 Synchronization
- Automatic server-client sync – keep settings consistent.
- Push live updates – to a server from a client.
- Forward client settings – to other users who want your setup.
✅ Validation & Updates
- Validation and Correction – built into everything, beyond just primitive types.
- Tight control – over what values a player can choose from.
- Automatic suggestions – for settings like tags and identifiers.
- Versioned updates – supported with one simple method implementation.
- Scrape previous configs – to easily update from another config library.
🛠️ Technical Summary
🧠 Architecture & Data
- TOML serialization – automatic reading/writing of config files.
- Multi-loader support – uses a lightweight networking API for cross-loader compatibility.
- Client & Server support – works on both sides with sync capabilities.
- Minimal dependencies – lightweight integration with existing mods.
📦 Loader & Dependencies
- Fabric – requires Fabric Loader + Fabric API.
- Forge – requires Forge for your MCPE version.
- NeoForge – requires NeoForge for 1.20.4+.
- Quilt – requires Quilt Loader + QSL.
- No additional dependencies – works standalone.
⚙️ Core Mechanics
- Automatic GUI generation – uses reflection and annotations to build screens.
- Server-client sync – uses a custom networking protocol.
- Validation pipeline – applies constraints and corrections to values.
- Version migration – updates configs from previous versions seamlessly.
🔧 Advanced Features
- Custom validators – implement your own validation logic.
- Dynamic suggestions – provide context-aware suggestions for settings.
- ModMenu & Catalogue integration – automatic config screen registration.
- Keyboard navigation – full accessibility support.
/* Technical highlights */
• Uses TOML for human-readable config files.
• Automatic GUI generation via reflection and annotations.
• Server-client sync uses a lightweight networking API.
• Validation pipeline applies constraints before saving.
• Version migration allows seamless updates from older configs.
• ModMenu and Catalogue are automatically detected and integrated.
• Fully accessible with keyboard navigation and screen narration.
• Uses TOML for human-readable config files.
• Automatic GUI generation via reflection and annotations.
• Server-client sync uses a lightweight networking API.
• Validation pipeline applies constraints before saving.
• Version migration allows seamless updates from older configs.
• ModMenu and Catalogue are automatically detected and integrated.
• Fully accessible with keyboard navigation and screen narration.
📥 Installation Guide
🧵 Fabric / Quilt Installation
RECOMMENDED Best performance & stability
1. Install the Fabric Loader or Quilt Loader (recommended version for your MCPE version).
2. Download Fabric API (or QSL for Quilt).
3. Download FzzyConfig-[loader]-[version].jar.
4. Place both JARs in .minecraft/mods/.
5. Launch using the Fabric/Quilt profile.
Example mods folder:
└── mods/
├── fabric-api-0.92.0+1.20.1.jar
└── FzzyConfig-Fabric-1.0.0+1.20.1.jar
└── mods/
├── fabric-api-0.92.0+1.20.1.jar
└── FzzyConfig-Fabric-1.0.0+1.20.1.jar
✅ Note: Fabric API / QSL is recommended.
⚙️ Forge / NeoForge Installation
ALTERNATIVE For modpacks relying on Forge ecosystem
1. Install the recommended Forge or NeoForge version.
2. Download FzzyConfig-Forge-[version].jar (or NeoForge version).
3. Place the JAR in mods/.
4. Launch the Forge/NeoForge profile.
Example mods folder (Forge):
└── mods/
└── FzzyConfig-Forge-1.0.0+1.20.1.jar
└── mods/
└── FzzyConfig-Forge-1.0.0+1.20.1.jar
⚠️ Note: No additional dependencies are required.
📌 Universal steps & recommendations
- Modpack: Available on Modrinth and CurseForge. Recommended launchers: Modrinth App, Prism Launcher, MultiMC.
- Client & Server – works on both sides; server-side sync features require installation on both.
- Performance tip: The mod is lightweight; automatic GUI generation is efficient.
- Mod compatibility: Works with most mods; integrates with ModMenu and Catalogue automatically.
- Data location: Config files are stored in
/config/.
⚡ Quick setup (dedicated server):
1. Download Fabric/Forge/NeoForge/Quilt server launcher.
2. Add Fzzy Config JAR to "mods" folder.
3. Start server (agree to EULA).
4. Config files are generated in /config/ on first launch.
1. Download Fabric/Forge/NeoForge/Quilt server launcher.
2. Add Fzzy Config JAR to "mods" folder.
3. Start server (agree to EULA).
4. Config files are generated in /config/ on first launch.
✅ Fabric/Quilt: Loader + API + FzzyConfig
✅ Forge/NeoForge: Forge + FzzyConfig
📦 Place JARs in /mods folder
🖥️ Client & Server supported
📋 Compatibility
🕹️ Supported versions
26.2
26.1.x
1.21.x
1.20.4–1.20.6
1.20.1
Platforms
Fabric
Forge
NeoForge
Quilt
Environments: Client and Server
🏷️ Tags
Game Mechanics
Library
Management
Utility
Creators
Owner: fzzyhmstrs
Fzzy Config Mod · by fzzyhmstrs · made for developers and modpack creators.