Weave
Weave 是用于 Minecraft 1.20.1 Fabric 上 Kilt 的兼容性与性能层。
它解决了通过 Kilt 加载 Forge 模组时与原生 Fabric 模组共存可能出现的兼容性问题,同时尽可能在真正需要时保持 Kilt 原有的 Forge 行为不变。
这 MAY(可能)或 MAY NOT(不一定)改善你的整合包兼容性;测试是在我拥有约 1k 个模组的整合包中进行的,我认为我是在最坏的情况下加载 Forge 模组。我最初构建此项目是因为我甚至无法加载 Kilt,具体原因是某些多加载器模组将 Forge 和 Fabric 的兼容性代码打包在了同一个 .jar 文件中。
Weave 修复内容
更好地分离 Fabric 和 Forge 模组
Kilt 有时会因为存在 Forge 相关类或兼容代码,而将 Forge 特定行为应用于原生 Fabric 模组。
Weave 会在允许这些 Kilt 兼容路径运行之前,检查是否真的需要 Forge 行为。
这也防止了以下情况:
- Kilt 意外触发其自身的兼容系统。
- 原生 Fabric 模组被当作 Forge 模组处理。
- 多加载器模组仅仅因为包含可选的 Forge 代码就启用 Forge 行为。
- 将类捆绑在
net.minecraftforge.* 下的 Fabric 模组被自动视为真正的 Forge 模组。
- 仅因其他地方需要另一个 Forge 功能,导致无关的 Kilt 兼容 mixin 保持激活状态。
减少 Kilt mixin 冲突
某些 Kilt 兼容 mixin 仅在真正的 Forge 模组依赖它们时才需要存在。
Weave 会禁用不必要的 Kilt 兼容钩子,同时在需要时将相关的兼容部分保留在一起。
这减少了 Kilt 与原生 Fabric 模组之间的冲突,而没有移除实际 Forge 模组所依赖的 Forge 行为。
键位绑定兼容性修复
Fabric 的键位绑定可能会通过 Forge 特定的键位注册机制进行路由,从而导致崩溃,包括涉及修饰键(如 Alt)的问题。
Weave 将 Fabric 拥有的键位映射与 Forge 拥有的键位映射分离开来,使各自使用正确的注册路径。
修复 FREEZE_DATA 启动挂起问题
在 Minecraft 启动期间冻结和处理注册表时,Kilt 可能会几乎完全卡住。
Weave 修复了受影响的块注册表路径,以便启动可以正常继续。
更安全的客户端启动和网络通信
某些 Forge 模组可能会尝试在 Minecraft 尚未完全进入有效游戏状态之前发送网络数据包。
Weave 防止这些调用过早执行,并等待客户端真正准备好后再进行处理。
Architectury 兼容性改进
某些 Kilt 兼容功能依赖于多个钩子协同工作。
Weave 将这些相关部分作为一个整体启用或禁用,防止部分激活的兼容系统留下损坏的运行状态。
工具提示兼容性修复
Forge 的工具提示钩子可能在不需要它们的地方保持激活状态,并干扰原生的 Fabric 行为。
Weave 将这些钩子限制在实际需要它们的代码路径中。
Forge 粒子的 AsyncParticles 支持
Weave 添加了 对通过 Kilt 加载的 Forge 粒子的 AsyncParticles 支持。
当渲染器与此兼容时,Forge 粒子可以使用异步处理。需要 Kilt/Forge 正常渲染路径的渲染器会自动保持在更安全的同步路径上,而不是被迫通过不兼容的渲染器。
粒子逻辑更新和渲染是分开的,因此即使渲染器需要正常的 Forge 路径,粒子也不一定失去异步逻辑更新能力。
Forge 自定义模型兼容性
Kilt 的自定义模型系统依赖于多个部分的协同工作。
Weave 将这些部分保持在一起,以防止 Forge 自定义模型处于部分启用状态(即能反序列化但无法正常渲染,反之亦然)。
创造模式物品栏崩溃修复
Fabric 的创造模式物品栏可能会短暂进入一种状态,即其物品组显示上下文尚未创建。
Kilt 的兼容性代码可能会遇到该状态并导致崩溃。
Weave 安全地处理该特定的临时状态,同时不影响其他无关的错误。
修复菜单中的损坏文本和大三角形
Kilt 可能会全局替换 Minecraft 的正常文本 RenderTypes 为 Forge 版本。
在使用批处理 GUI 渲染时,某些文本装饰——特别是 带阴影的中划线文本——可能会破坏渲染缓冲区,并在菜单中产生巨大的对角线三角形或条纹。
Weave 让普通的 Fabric 和原版文本保持在 Minecraft 的正常渲染路径上,仅在 Forge 代码真正需要时才使用 Forge 文本路径。
更好的 Kilt + Sodium 区块重建并发性能
Kilt 在 Sodium 区块重建期间对某些 Forge ModelData 查找使用全局同步锁。
Weave 缩小了对使用 Forge 正常默认 getModelData 行为的模型的同步范围,允许无关的区块更独立地进行重建。
具有自定义 Forge ModelData 行为的模型仍保留在 Kilt 的原始安全路径上。
安全优化回退
Weave 的性能更改设计为安全失败。
如果 Weave 无法识别预期的确切 Kilt 代码,优化将不会激活,转而使用 Kilt 的原始行为。
特定模组兼容性修复
这些修复是通过单独的 Forge 模组发现的,但由 Weave 自动处理,并且不需要对这些模组进行修改。
Bosses Rise
修复了 Crossbow Pirate 因需要通过 Kilt 运行时访问 Minecraft 通常包私有的弩状态而失败的问题。
Weave 自动提供所需的访问权限。
Monster Expansion
修复了由于 Porting Lib 尝试在不可变的空模型元素列表上调用 clear() 而导致的模型加载崩溃。
安全地处理该空列表情况,同时避免掩盖不相关的模型错误。
Weave
Weave is a compatibility and performance layer for Kilt on Minecraft 1.20.1 Fabric.
It fixes compatibility problems that can happen when Forge mods are loaded through Kilt alongside native Fabric mods, while trying to keep Kilt's normal Forge behavior intact wherever it is actually needed.
This MAY or may not improve compatibility with your modpack, testing is done on my own pack with around 1k mods, so I think I'm loading Forge mods in the worst case scenario, I originally built this because I couldn't even LOAD Kilt, specifically because of multi-loader mods that had Forge and Fabric compatibility in one .jar
What Weave Fixes
Better separation between Fabric and Forge mods
Kilt can sometimes apply Forge-specific behavior to native Fabric mods simply because Forge-related classes or compatibility code are present.
Weave checks whether Forge behavior is actually needed before allowing those Kilt compatibility paths to run.
This also prevents:
- Kilt from accidentally triggering its own compatibility systems.
- Native Fabric mods from being treated as Forge mods.
- Multiloader mods from enabling Forge behavior just because they contain optional Forge code.
- Fabric mods that bundle classes under
net.minecraftforge.* from being automatically treated as real Forge mods.
- Unrelated Kilt compatibility mixins from remaining active just because another Forge feature is needed elsewhere.
Fewer Kilt mixin conflicts
Some Kilt compatibility mixins only need to exist when a real Forge mod depends on them.
Weave disables unnecessary Kilt compatibility hooks while keeping related compatibility pieces together when they are required.
This reduces conflicts between Kilt and native Fabric mods without removing the Forge behavior that actual Forge mods depend on.
Keybind compatibility fixes
Fabric keybinds could be routed through Forge-specific key registration and cause crashes, including problems involving modifier keys such as Alt.
Weave separates Fabric-owned and Forge-owned key mappings so each uses the correct registration path.
Fixes the FREEZE_DATA startup hang
Kilt could become almost completely stuck while Minecraft was freezing and baking registries during startup.
Weave repairs the affected block-registry path so startup can continue normally.
Safer client startup and networking
Some Forge mods can attempt to send networking packets before Minecraft has fully entered a valid play state.
Weave prevents those calls from running too early and waits until the client is actually ready.
Architectury compatibility improvements
Some Kilt compatibility features depend on multiple hooks working together.
Weave keeps those related pieces enabled or disabled as a group, preventing partially active compatibility systems from leaving broken runtime state behind.
Tooltip compatibility fixes
Forge tooltip hooks could remain active in places where they were not needed and interfere with native Fabric behavior.
Weave limits those hooks to the code paths that actually require them.
AsyncParticles support for Forge particles
Weave adds AsyncParticles support for Forge particles loaded through Kilt.
Forge particles can use asynchronous processing when their renderer is compatible with it. Renderers that require Kilt/Forge's normal rendering path automatically stay on a safer synchronous path instead of being forced through an incompatible renderer.
Particle ticking and rendering are handled separately, so a particle does not necessarily lose asynchronous ticking just because its renderer needs the normal Forge path.
Forge custom model compatibility
Kilt's custom-model system relies on several pieces working together.
Weave keeps those pieces together so Forge custom models are not left in a partially enabled state where they deserialize but fail to render correctly, or vice versa.
Creative Inventory crash fix
Fabric's Creative Inventory can briefly reach a state where its item-group display context has not been created yet.
Kilt compatibility could hit that state and crash.
Weave handles that specific temporary state safely while leaving unrelated errors untouched.
Fixes corrupted text and giant triangles in menus
Kilt can replace Minecraft's normal text RenderTypes with Forge versions globally.
With batched GUI rendering, certain text decorations — especially strikethrough text with shadows — could corrupt the render buffer and create huge diagonal triangles or streaks across menus.
Weave keeps normal Fabric and vanilla text on Minecraft's normal rendering path and only keeps the Forge text path when Forge code actually requires it.
Better Kilt + Sodium chunk rebuild concurrency
Kilt uses a global synchronization lock for certain Forge ModelData lookups during Sodium chunk rebuilding.
Weave narrows that synchronization for models using Forge's normal default getModelData behavior, allowing unrelated chunks to rebuild more independently.
Models with custom Forge ModelData behavior stay on Kilt's original safe path.
Safe optimization fallback
Weave's performance changes are designed to fail safely.
If Weave cannot recognize the exact Kilt code it expects, the optimization simply does not activate and Kilt's original behavior is used instead.
Mod-Specific Compatibility Fixes
These fixes were discovered through individual Forge mods, but they are handled automatically by Weave and do not require modified versions of those mods.
Bosses Rise
Fixes the Crossbow Pirate failing because it needs access to Minecraft's normally package-private crossbow state when running through Kilt.
Weave supplies the required access automatically.
Monster Expansion
Fixes a model-loading crash caused by Porting Lib attempting to call clear() on an immutable empty model-element list.
Weave handles that exact empty-list case safely without hiding unrelated model errors.
评论 0
登录后参与评分
还没有评论,来抢沙发吧