Insanity Wrapper
Insanity Wrapper is a compatibility layer and mod loader framework built on NeoForge. It currently enables Fabric and Quilt mods to run on NeoForge for Minecraft 1.21.11 and beyond.
📖About Insanity Wrapper
🤪 Insanity Wrapper
Because if you want it to work right, you need to wrap it up!
Run Fabric & Quilt mods on NeoForge for Minecraft 1.21.11+! Insanity Wrapper is a powerful compatibility layer that bridges different modding frameworks into a unified NeoForge environment.
🎯 What Does It Do?
Ever wanted to use your favorite Fabric mods alongside NeoForge? Insanity Wrapper makes it possible. Simply drop it in your mods folder along with any compatible Fabric/Quilt mods, and watch the magic happen!
No complicated setup. No manual conversions. Just download, install, and play.
🏗️ Core Components
Insanity Wrapper is built on three powerful systems working together:
Insanity Loader
A custom mod loader built on NeoForge that extends modding capabilities beyond what NeoForge provides out of the box. It implements Fabric Loader API shims, handles mod discovery, and manages the entire compatibility pipeline.
Fabric API Shims
Custom-built compatibility layers that route Fabric API calls to their NeoForge equivalents. These are not the actual Fabric API—they're manually crafted implementations that provide the same interface.
Insanity Transformer
Handles bytecode transformation, import remapping, and compatibility patching to ensure seamless integration between modding ecosystems.
✨ Key Features
- ✅ Full Mixin Support — NeoForge's native Mixin system handles everything
- ✅ Access Widener Conversion — Automatically converts to Access Transformers at runtime
- ✅ Cross-Mod Compatibility — Fabric mods can interact with NeoForge mods via the event bus
- ✅ Network Translation — Seamless packet conversion between Fabric and NeoForge
- ✅ Simple Installation — Just drop it in your mods folder!
🎮 Tested & Supported Mods
| Mod | Status | Notes |
|---|---|---|
| Zoomify | ✅ Full Support | Requires Kotlin for Forge |
| Mod Menu | ✅ Works | Requires Kotlin for Forge |
| Gamify | ✅ Works | |
| Camera Utils | ✅ Works | |
| Fabrishot | ✅ Works | |
| Flashback | 🔄 In Progress | Recording, Editing, Saving, Loading, Deleting, Importing, Exporting work — Settings crashes game |
Coming Soon
- Axiom — Planned for future updates
- C2ME — Concurrent Chunk Management Engine planned
Have a mod you'd like to see supported? Join our Discord and let us know!
🔧 Implemented Fabric API Shims
| Fabric API Module | NeoForge Implementation |
|---|---|
fabric-lifecycle-events-v1 |
NeoForge Event Bus |
fabric-key-binding-api-v1 |
RegisterKeyMappingsEvent |
fabric-command-api-v2 |
RegisterCommandsEvent |
fabric-networking-api-v1 |
NeoForge Payload System |
fabric-resource-loader-v0 |
NeoForge Resource Events |
fabric-registry-sync-v0 |
NeoForge Registry Events |
fabric-rendering-v1 |
NeoForge Rendering Events |
fabric-api-base |
Base utilities and interfaces |
...and many more being added regularly!
📦 Installation
For Players
- Install NeoForge for Minecraft 1.21.11 from neoforged.net
- Download Insanity Wrapper from this page
- Place the JAR in your
modsfolder - Add Fabric/Quilt mods (1.21.11 compatible) to the same folder
- Launch Minecraft and enjoy!
That's it! No additional configuration required.
⚠️ Compatibility Notes
- Mixins: Fully supported through NeoForge's native Mixin implementation
- Access Wideners: Automatically converted to Access Transformers
- Mod Interactions: Fabric mods can interact with NeoForge mods through the event bus
- Networking: Fabric networking is seamlessly translated to NeoForge's payload system
Known Limitations
- Some advanced Fabric API features may not be fully implemented yet
- Mods relying on Fabric-specific internals may require patches
- Performance may vary depending on mod complexity
🔗 Links & Support
- 💬 Discord — Support, discussion, and mod requests
- 🐛 GitHub Issues — Report bugs and request features
- 📖 Wiki — Detailed documentation and guides
🤝 Contributing
We welcome contributions! Areas where help is needed:
- Fabric API Shims — Help implement missing shim modules
- Compatibility Testing — Test mods and report compatibility issues
- Documentation — Improve guides and API documentation
- Bug Fixes — Fix compatibility issues and edge cases
- Performance — Optimize transformation and runtime performance
See our Contributing Guide for details.
📜 License
This project is licensed under CSL-V1.0 (Clopen Source License).
Important: The Fabric API shims in this project are custom implementations created from scratch. They are not derived from or contain code from the official Fabric API—they simply provide compatible interfaces that route to NeoForge equivalents.
🙏 Credits
- Inspired by Sinytra Connector and Forgified Fabric API
- The Fabric Team for creating an amazing modding ecosystem
- The NeoForge Team for continuing Forge's legacy
- Moulberry for the motivation to port Flashback
- Community Contributors for testing and feedback
"Wrapping Fabric mods for NeoForge? That's insanity!"
"Exactly." 🤪
**Minecraft 1.21.11 | NeoForge 21.11.33-beta + **