CatFrame: Compat

模组

· 作者 Seniye

CatFrame 的兼容层,用于模组支持和一些工具。

1 本站下载 0 关注 更新于 1 周前

需要前置:CatFrame、UniMixins、JarUtils

最新 0.0.12 · 1.7.10 · Forge

一键开服(送7天)

CatFrame 兼容层

这是 CatFrame 的模组兼容性层,同时也为模组开发提供了一些实用工具。

兼容性支持

1. IME 输入法兼容

  • IngameIME compat:针对所有文本输入框组件,使其能够输入中日韩(CJK)字符。
  • IMEBackport:功能与 IngameIME 相同。

2. MCPatcher 兼容

  • MCPatcherForge 系列(除 MCPatcherForge 外),例如 NotFine、Angelica、OptiFuture:支持 CTM 方法,使其能够在 JSON 模型化的方块上正常工作。
  • MCPatcherForge (OptiFuture <= 1.2.3):由于存在 8 个参数且其中一个无用参数无法移除,因此目前不支持此模组。
  • OptiFuture:支持自然纹理(Natural textures)。
  • Right Proper MCPatcher:支持 CTM 方法使其在 JSON 模型化方块上工作,并支持自然纹理。

3. Tag 标签兼容

  • PineappleTags:允许 CatFrame 注册和使用这些标签。
  • HogUtils (HogTags):开发中…

4. 物理模型支持

  • Item Physic:
    (官方版本)不可用,并可能导致我的物品变换出现短路错误;由于 ASM 短路是完全性的,意味着难以恢复,因此该版本会导致崩溃。
    (非官方版本)测试良好,旋转和自旋将通过 Mixin 完全应用。

5. 副手兼容

  • Backhand (GTNH edition 1.8.x):使 CatFrame 的手部渲染在副手/左手(对于右撇子而言,左撇子则为右手)中正确显示。

6. 提示框兼容

  • Chromatic Tooltips:允许 Chromatic 提示框在现代屏幕上渲染。
  • NotEnoughItems (非官方,GTNH 版本):保持 NEI 的单个提示框框架,同时 CatFrame 的结构化提示框组件(例如合成表网格)渲染在其中,而不是两个模组叠加两个框架。

已知限制

CTM 部分

玻璃板 CTM 角落连接:当在玻璃板上使用 CTM 时,角落连接可能会显示错误的变体。这是一个限制:CatFrame 的 VMM 渲染绕过了处理薄板连通性的专用面板渲染逻辑(PaneRenderHelper/GlassPaneRenderer)。CTM 引擎使用通用的邻居检测机制,未考虑面板的薄板几何结构。基本的面板 CTM 连接工作正常;仅角落/边缘变体可能不准确。
通过内置资源包修复。

Backhand

第三人称副手持握的物品方块:CatFrame 的 RenderJsonItemModel.resolveHeadSlotKind 基于 stack != entity.getHeldItem() 将头槽所有权标记给头部插槽,而 Backhand 的第三人称传递不进行槽位交换,因此副手中持握的 ItemBlock 被错误分类为头槽渲染(ITEM_HEAD 阶段 + 头部预变换),直到 CatFrame 核心学会区分副手之前,渲染位置会错位。

Better Foliage (Issue #6)

未计划支持。Better Foliage - Legacy Edition 将其渲染覆盖安装在其主体 RenderBlocks.renderBlockByRenderType 内部,而 CatFrame 在其托管的每个方块的入口处拦截该方法——因此对于这些方块(原版树叶、原木、草、沙子等),Better Foliage 的功能(Extra Leaves、Round Logs 等)永远不会执行。两个模组都想绘制相同的方块,而每个方块的外观只能来自一个管线——让 Better Foliage 渲染这些方块意味着将其完全交给它,代价是 CatFrame 在其上的渲染(CTM、自然纹理、渲染扩展)。这种权衡被拒绝,因此不计划此兼容性;Better Foliage 继续在 CatFrame 未托管的方块上工作(例如模组树叶)。

提示框部分

NotEnoughItems

  • 为什么需要桥接器。 NEI 使用 ASM MethodReplacer 重写 GuiContainer.drawScreen 内部的 renderToolTip 调用点,因此 CatFrame 自己的 renderToolTip 覆盖从未运行——尽管 CatFrame 的 extractTooltip 仍然排队其延迟的九宫格提示框。结果是出现两个包含相同文本的框架。
    文本行根本不需要任何处理:NEI 通过 ItemStack.getTooltip 解析它们,因此通过 ItemTooltipEvent 贡献的所有内容(包括本模组的标签提示框)都已经共享。受影响的主要是框架和结构化组件。
    桥接器的作用。 在 post-init 阶段,它在 NEI (GuiContainerManager.addTooltipHandler) 中提前注册了物品提示框挂钩。当悬停的物品堆栈具有 CatFrame 提示框组件(例如 ItemTooltipImages,如合成表网格)时,该组件被包装成 CodeChickenLib 行处理器(GuiDraw.TOOLTIP_HANDLER + GuiDraw.getTipLineId)并插入到索引 1,即物品名称下方——与 CatFrame 使用的槽位相同。然后框架被标记为 NEI 所有,并通过后期 Mixin 取消 CatFrame 对该框架的 extractTooltip,从而只绘制一个框架。桥接器不是屏幕范围的:组件也注入到其他模组的容器 GUI 中,其中 NEI 已经是提示框渲染器。取消操作才是屏幕范围的(只有 CatFrame 屏幕会绘制第二个框架)。

Chromatic Tooltips

  • 当安装 Chromatic Tooltips 时,它胜出:CT 全盘替换提示框并在 DrawScreenEvent.Post 上绘制,位于 NEI 框架之后,因此两者无法合并。桥接器随后在 CatFrame 屏幕上抑制 NEI 的容器提示框(IContainerObjectHandler.shouldShowTooltip),而不是将组件转换为它,由 CT 渲染所有内容。

CatFrame 的提示框样式和定位器未生效。 在此配置下,NEI 负责放置(mousex + 12, mousey - 12)和分页;CatFrame 的 TOOLTIP_STYLE 和 ClientTooltipPositioner 仅在无 NEI 时生效。

启用 showTooltipWithItemInHand() == true 的组件在持有物品时不显示提示。 NEI 的替换实现保留了原版 carried == null 的检查逻辑,因此在鼠标光标持有物品时,物品提示分支永远不会执行。目前 CatFrame 没有组件采用此行为,因此这是一个面向未来的限制。

组件高度参与分页。 CodeChickenLib 使用 handler.getSize().height 和提示框显示区域高度进行分页,因此高于 displaySize().height - 26 的组件会获得独立的一页,并可能溢出。组件应保持在几个物品行的高度范围内。

每个屏幕仅有一个渲染所有者。 当存在 NEI 时,NEI 的框架被扩展而非替换:CatFrame 无法重新添加其自己的背景/内边距。当存在 CT 时,NEI 的框架被抑制而非合并,因此在该配置下,NEI 特定的物品提示部分(其自身的处理器、数量详情)不会出现在 CatFrame 屏幕上。处理器是按帧的。 CodeChickenLib 在 drawMultilineTip 结束时清除其行处理器表,因此桥接代码每帧都会构建新的处理器并重新读取行 ID;标记无法跨帧缓存。

欢迎提交打破这些限制的 PR。

工具

配置

添加支持多种配置文件类型的配置功能。

模型

  • ModelBound:从 CatFrame JSON 方块模型派生方块边界。
  • BlockState Transformation:来自现代 NeoForge 的方块状态转换。

UI

  • 用于现代 UI 开发的主题系统。
  • 用于现代 UI 开发的动画。(仅包含少量功能,且存在诸多限制。)
  • 类似 HTML 浏览器的 UI 创建。(开发中…)

本地化

  • 该模块是一个扩展工具,允许加载任意包中的 JSON 语言文件。

依赖

CatFrame (0.9.0 以上版本), JarUtils (0.0.2 以上版本)。

许可

源代码: MIT License
二进制 JAR: Redistribution License

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源