疯狂包裹

疯狂包裹

Insanity Wrapper 是一个基于 NeoForge 构建的兼容层和模组加载器框架。它目前使 Fabric 和 Quilt 模组能够在 Minecraft 1.21.11 及更高版本的 NeoForge 上运行。

🤪 Insanity Wrapper

因为如果你想让它正常工作,就需要把它包装起来!

在 Minecraft 1.21.11+ 上于 NeoForge 上运行 Fabric 和 Quilt 模组!Insanity Wrapper 是一个强大的兼容层,将不同的模组框架桥接到统一的 NeoForge 环境中。


🎯 它有什么作用?

你是否曾想在 NeoForge 上使用你最喜欢的 Fabric 模组?Insanity Wrapper 让它成为可能。 只需将它和任何兼容的 Fabric/Quilt 模组一起放入你的模组文件夹,然后见证奇迹发生!

无需复杂的设置。无需手动转换。只需下载、安装,然后开始游戏。


🏗️ 核心组件

Insanity Wrapper 基于三个协同工作的强大系统构建:

Insanity Loader

一个构建于 NeoForge 之上的自定义模组加载器,将模组能力扩展到 NeoForge 开箱即用所能提供的范围之外。它实现了 Fabric Loader API 垫片,处理模组发现,并管理整个兼容性流程。

Fabric API 垫片

自定义构建的兼容层,将 Fabric API 调用路由到其 NeoForge 等效实现。这些并非实际的 Fabric API——它们是手工编写的实现,提供相同的接口。

Insanity Transformer

处理字节码转换、导入重映射和兼容性补丁,以确保模组生态系统之间的无缝集成。


✨ 主要特性

  • ✅ 完整 Mixin 支持 — NeoForge 的原生 Mixin 系统处理一切
  • ✅ Access Widener 转换 — 在运行时自动转换为 Access Transformer
  • ✅ 跨模组兼容性 — Fabric 模组可以通过事件总线与 NeoForge 模组交互
  • ✅ 网络数据包转换 — Fabric 和 NeoForge 之间的无缝数据包转换
  • ✅ 简单安装 — 只需将其放入你的模组文件夹!

🎮 已测试并支持的模组

模组 状态 备注
Zoomify ✅ 完全支持 需要 Kotlin for Forge
Mod Menu ✅ 可用 需要 Kotlin for Forge
Gamify ✅ 可用
Camera Utils ✅ 可用
Fabrishot ✅ 可用
Flashback 🔄 进行中 录制、编辑、保存、加载、删除、导入、导出可用 — 设置会导致游戏崩溃

即将支持

  • Axiom — 计划在未来更新中支持
  • C2ME — 计划支持并发区块管理引擎

有想要支持的模组?加入我们的 Discord 告诉我们!


🔧 已实现的 Fabric API 垫片

Fabric API 模块 NeoForge 实现
fabric-lifecycle-events-v1 NeoForge 事件总线
fabric-key-binding-api-v1 RegisterKeyMappingsEvent
fabric-command-api-v2 RegisterCommandsEvent
fabric-networking-api-v1 NeoForge Payload 系统
fabric-resource-loader-v0 NeoForge 资源事件
fabric-registry-sync-v0 NeoForge 注册表事件
fabric-rendering-v1 NeoForge 渲染事件
fabric-api-base 基础工具和接口

……以及更多正在定期添加的内容!


📦 安装

对于玩家

  1. 从 neoforged.net 安装适用于 Minecraft 1.21.11 的 NeoForge
  2. 从本页面下载 Insanity Wrapper
  3. 将 JAR 文件放入你的 mods 文件夹
  4. 添加 Fabric/Quilt 模组(兼容 1.21.11)到同一文件夹
  5. 启动 Minecraft 并享受游戏!

就这样!无需额外配置。


⚠️ 兼容性说明

  • Mixin: 通过 NeoForge 的原生 Mixin 实现完全支持
  • Access Widener: 自动转换为 Access Transformer
  • 模组交互: Fabric 模组可以通过事件总线与 NeoForge 模组交互
  • 网络: Fabric 网络无缝转换为 NeoForge 的 Payload 系统

已知限制

  • 某些高级 Fabric API 功能可能尚未完全实现
  • 依赖 Fabric 特定内部机制的模组可能需要补丁
  • 性能可能因模组复杂度而异

🔗 链接与支持

Discord

GitHub

  • 💬 Discord — 支持、讨论和模组请求
  • 🐛 GitHub Issues — 报告错误和请求功能
  • 📖 Wiki — 详细文档和指南

🤝 贡献

我们欢迎贡献!需要帮助的领域:

  • Fabric API 垫片 — 帮助实现缺失的垫片模块
  • 兼容性测试 — 测试模组并报告兼容性问题
  • 文档 — 改进指南和 API 文档
  • 错误修复 — 修复兼容性问题和边缘情况
  • 性能 — 优化转换和运行时性能

详情请参阅我们的贡献指南。


📜 许可证

本项目采用 CSL-V1.0(Clopen Source License) 许可。

重要提示: 本项目中的 Fabric API 垫片是从头创建的自定义实现。它们并非源自或包含官方 Fabric API 的代码——它们只是提供兼容的接口,将调用路由到 NeoForge 的等效实现。


🙏 致谢

  • 灵感来自 Sinytra Connector 和 Forgified Fabric API
  • Fabric 团队 创造了令人惊叹的模组生态系统
  • NeoForge 团队 延续了 Forge 的传承
  • Moulberry 提供了移植 Flashback 的动力
  • 社区贡献者 的测试和反馈

“为 NeoForge 包装 Fabric 模组?这简直是疯狂!” “正是。” 🤪

**Minecraft 1.21.11 | NeoForge 21.11.33-beta + **