🤪 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

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

...and many more being added regularly!

📦 Installation

For Players

1. Install NeoForge for Minecraft 1.21.11 from neoforged.net
2. Download Insanity Wrapper from this page
3. Place the JAR in your mods folder
4. Add Fabric/Quilt mods (1.21.11 compatible) to the same folder
5. 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