
拼凑式修复
修复热门模组中的卡顿、内存泄漏和崩溃问题,无需修改其文件。每个修复仅在经过测试的精确版本上运行。
查看大图发现 bug 或有建议? 请发布到 GitHub Issues,而不是评论区。所有报告都会在那里被阅读和跟踪。

Patchwork 无需编辑或重新上传其他模组的文件,即可修复 Minecraft 1.21.1(NeoForge)上一些热门模组的卡顿、内存泄漏和崩溃问题。
工作原理
- 每个模组对应一个模块。 每项修复都是独立的小模块,默认开启。
- 版本锁定。 模块仅在其目标模组以编写和测试时的确切版本安装时才会运行。如果该模组更新,模块会自动关闭并提示一次: *“<Mod> 已更新,因此其修复暂时关闭。游戏正常运行。”
- 无需安装任何目标模组。 所有目标模组都不是必需的。如果某个模组未安装,其模块会保持关闭。
- 由你决定。 每个模块都可以在 模组 → Patchwork → 配置(或
config/patchwork.toml)中关闭。

修复内容
| 模组 | 版本 | 修复 |
|---|---|---|
| Biolith(Quark 内) | 3.0.14 | 世界生成期间的生物群系查找不再产生一次性对象(垃圾从 ~163 MB/s 降至 ~7 MB/s) |
| TerraBlender | 4.1.0.8 | 每个表面方块不再产生一次性 lambda 和二次查找(垃圾减少 ~166 MB/s) |
| Terrain Slabs | 3.1.2 | 台阶扫描对每个方块只读取一次(垃圾减少 ~200 MB/s) |
| Voiceless Survival | 2.0.1 | 修复了导致每个生物在整个会话期间都留在内存中的内存泄漏 |
| Essential | 任意 | 跳过装饰渲染层(减少 ~61 MB/s 渲染线程垃圾) |
| Eating Animation | 替换该模组 | 一个 Java 移植版(MIT),因此不再需要 Groovy ModLoader(节省 ~107 MB 内存) |
| Subtle Effects | 1.15.0 | 每 tick 的生物群系检查只执行一次,而不是最多五次 |
| Accelerated Rendering | 1.0.14-alpha | 修复使用光影包时头部透视问题 |
| What Are They Up To | 1.21.0-1.2.7 | 更清晰的实时 GUI 预览、更小的网络帧、崩溃安全的解码(每位玩家都需要 Patchwork) |
| Supplementaries | 1.21.1-3.9.9 | 修复对没有物品的方块(与 Quark 一起)使用扳手时的崩溃 |
| Campfire Resting | 1.6.0 | 修复客户端看不到的玩家引发的网络错误洪流 |
| Nomadic Tents | 21.1.0 | 用木槌敲击帐篷门会将其收起,而不是把你传送进去;修复损坏的配方解锁 |
| Streams Reflowing | 2.14.4 | 阻止区块卡顿线程转储不断堆积 |
| MidnightLib | 1.9.3 | 修复两个模组同时加载设置时的随机启动崩溃 |
| Iris | 1.8.14-beta.1 | 光影图像以空白状态启动,而不是带着残留的显存;名称标签不再投射漂浮阴影;重写的着色器会缓存到磁盘,因此首次加载着色器更快 |
| Load My Chunks | 1.2.5.1 | 修复实体 tick 时的无限循环(世界冻结、退出卡死) |
| NeoForge jar-in-jar | 21.1.252 | 模组内置的 jar 从磁盘缓存读取,而不是保存在内存中(~65-117 MB) |
| Villager API | 1.26.9.6 | 每次世界启动只查找一次村民包(世界加载快 ~1 秒) |
| 3D Skin Layers | 1.11.3 | 使用光影时,3D 皮肤层在阴影阶段被平面绘制(FPS 提高 ~10%) |
| Minecraft:声音引擎 | 1.21.1 | 崩溃或卡住的声音线程会被重启,而不是让游戏冻结 |
| Minecraft:告示牌 | 1.21.1 | 距离太远而无法阅读的告示牌文字(24 格,可调整)不再绘制(大量告示牌周围 FPS 提高 +30%) |
| Minecraft:渲染类型 | 1.21.1 | 渲染类型名称只构建一次(使用光影时靠近旗帜的 FPS 提高 ~7.5%) |
| Seamless Loading Screen | 2.2.1+1.21 | 修复离开由另一个模组打开的世界时的崩溃 |
性能模块不会改变结果。每个模块都有校验模式(-Dpatchbox.verify.<key>=true),会并行运行原始代码并记录任何差异。所有模块均在约 290 个模组的整合包上验证,零差异。
致谢
第三方部分保留其自己的声明,列于 NOTICE.md:来自 Biolith 和 TerraBlender 的少量 LGPL 派生代码,以及 Terrain Slabs 和 Eating Animation 的 MIT 许可部分。Patchwork 不包含也不重新分发它所修补的任何模组。
源代码位于 GitHub,采用 LGPL-3.0-only 许可。
为 Foundation 整合包制作,在 Claude(一个 AI)的帮助下完成。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。