Structured Mod Loader [FORGE]
If you have ever opened your mods folder and felt a cold shiver at the sight of dozens of loose .jar files, Structured Mod Loader [FORGE] was made with you in mind. Known in short as SML, this Minecraft Forge mod transforms a chaotic pile of files into a neatly arranged directory tree. Instead of dumping every library, API, and content mod into one flat space, it lets you group them into subfolders while Forge still recognizes and loads everything correctly.
The concept is simple but powerful. Once the mod is placed in your main mods directory, it recursively searches all subfolders for .jar files and hands them over to the regular Forge mod loader, FML. That means you can keep your performance mods in one folder, your world generation mods in another, and your library dependencies tucked away somewhere sensible. For modpack creators, this is a genuine quality-of-life upgrade, because tracking which mods are content-adding and which are just support libraries becomes far easier.
Supported Versions and Loader
Structured Mod Loader [FORGE] targets Minecraft 1.18 and above, paired with Forge 39 or newer. It is a Forge-exclusive mod, so Fabric and NeoForge users will need to look elsewhere. The mod was built specifically around the FML loading process, which is why it integrates so cleanly with existing Forge installations.
It is worth noting that the project is currently marked as discontinued. An issue with a specific 1.18.2 Forge update slowed development, and the author eventually stepped away after realizing that modern modpack managers handle mod organization in ways that overlap with this approach. A community pull request exists on GitHub that would likely restore compatibility, but it was never officially tested or built. Even so, the mod remains a fascinating tool for anyone curious about alternative ways to structure a mods folder.
How to Install Structured Mod Loader [FORGE]
Learning how to install this mod is no different from installing any other Forge add-on. Follow these steps:
- Download Structured Mod Loader [FORGE] from its official release page.
- Locate your Minecraft Forge installation and open the mods folder.
- Drop the downloaded .jar file directly into the mods folder, not into a subfolder.
- Launch the game and let Forge handle the rest.
By default, the mod ignores any directory whose name contains keywords like ignore, unstable, or disable. It also stops searching once it goes deeper than three folders, which prevents runaway recursion in overly nested setups. If you prefer a smoother route, the foxygame.net launcher can handle the entire setup for Structured Mod Loader [FORGE] with a single click, pulling the correct build and dropping it into place automatically.
Configuration and Customization
On the first launch, Structured Mod Loader [FORGE] generates a config file at config/StructuredModLoader.toml. Inside, you can edit the list of excluded keywords and adjust the maximum recursion depth, which is capped at five. If the file is deleted or its TOML syntax becomes invalid, the mod resets the broken values to their defaults and recreates the file, so you never end up with a broken load order because of a typo.
The mod also logs everything it does to the regular game log, which makes troubleshooting straightforward. You can see exactly which folders were scanned, which jars were loaded, and which directories were skipped.
Known Incompatibilities
There are a few limitations to keep in mind. Optifine does not play nicely with the recursive loading approach, though the fix is easy: place Optifine in the regular mods folder alongside StructuredModLoader.jar. Any mod that implements transformers or acts as a coremod may also conflict, and support for those cases is still a work in progress.
Final Thoughts
Structured Mod Loader [FORGE] offers a clever answer to a problem most players simply tolerate. Even though development has paused, the mod still demonstrates how much cleaner a mods folder can be when libraries and content mods live in their own spaces. For modpack authors who value organization, it remains a worthwhile experiment, and for everyday players, it is a reminder that tidiness in Minecraft is always possible with the right tool.