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.
介绍
🤪 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 + **
常见问题
Insanity Wrapper 支持哪些 Minecraft 版本？
Insanity Wrapper 支持 Minecraft Java 版 1.21.11，可用的加载器：NeoForge。下载时注意选择和你游戏版本一致的文件。
Insanity Wrapper 怎么安装？
先用 PCL2 或 HMCL 启动器安装对应版本的 NeoForge，再把下载的 .jar 文件放进游戏目录的 mods 文件夹，重新启动游戏即可。开启了版本隔离的，mods 文件夹在 versions/版本名 下面。运行环境：客户端 / 服务端。
评论
登录后评论和评分