🤪 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 mods folder
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 + **