CatFrame
适用于 Minecraft Forge 1.7.10 的现代基础库。
CatFrame 是适用于 Minecraft Forge 1.7.10 的现代基础库,将新版 Minecraft 中引入的许多引擎、渲染、资源和 UI 系统移植到了旧版本。
其目标不仅仅是重现单个功能,而是为在经典的 1.7.10 平台上进行现代化的数据驱动模组开发提供所需的底层架构。
玩家须知
CatFrame 旨在作为共享的基础设施库,而非独立的内容模组。
它是我 Minecraft 1.7.10 项目的基础,旨在让在现代 Minecraft 中已经实现的现代化、可维护且数据驱动的模组开发成为可能,尽管是在经典的 Minecraft 版本上。
模组开发者须知
对于模组开发者,此模组包含:
模型与渲染
- 完整的 26.3+ JSON 模型管线
- 现代方块状态(Blockstate)系统
- 运行时模型烘焙
- 显示变换(Display transforms)
- 多层物品渲染
- 现代 物品模型定义
- 原版方块/物品 JSON 模型支持,需 Mixin
- 可扩展插件:支持在每个烘焙模型的四边形(quad)或每一帧中进行自定义模型渲染
资源
- 基于命名空间(Namespace)的资源加载
- 自动纹理拼接
- 内置资源包
- 数据驱动的纹理收集器
数据驱动系统
- 数据组件(Data Components)
- 原版风格标签系统(Tag System)
- 可扩展的模型映射
- 基于属性的状态解析
UI 框架
CatFrame 还提供了一套可复用的 GUI 工具包,用于在 Minecraft 1.7.10 上构建现代界面。
包含的组件有:
- 可扩展的 UI 组件
- 使用这些功能的屏幕,同时也具备容器类型屏幕。
许可证
- 源代码:MIT 许可证
- 资产:Copyright © dfdvdsf 2026, All rights reserved — 第三方角色资产(Bluey & Bingo)不包含在开源许可证内,未经各自版权所有者许可不得重新分发。
这些资产不与 Ludo Studio Production 关联。 - 二进制 Jars:重新分发许可证 v1.1
依赖项
Mixin 支持:推荐使用 UniMixins 以获得通用的 Mixin 支持。
Wiki
更多信息,请参阅 此处。
📱 想要最佳体验?
为了获得最流畅的安装和更新体验,请使用 Modrinth App。
通过 Modrinth App 下载也有助于支持本项目及其他项目的未来发展。
CatFrame
A modern foundation library for Minecraft Forge 1.7.10.
CatFrame is a modern foundation library for Minecraft Forge 1.7.10, backporting many of the engine, rendering, resource, and UI systems introduced in newer versions of Minecraft.
Its goal is not simply to recreate individual features, but to provide the underlying architecture needed for modern, data-driven mod development on the legacy 1.7.10 platform.
For Player
CatFrame is intended as a shared infrastructure library rather than a standalone content mod.
It serves as the foundation for my Minecraft 1.7.10 projects and is designed to make the modern, maintainable, and data-driven mod development possible on a legacy Minecraft version, which this type of development is already archieved in the modern minecraft.
For Mod Developers
For mod developers, this mod contains:
Model & Rendering
- Complete 26.3+ JSON Model pipeline
- Modern Blockstate system
- Runtime model baking
- Display transforms
- Multi-layer item rendering
- Modern Item Model definitions
- Vanilla Block / Item Json Model support, Mixin required
- Extensible plugin for your model rendering in per baked model quad / per frame
Resources
- Namespace-based resource loading
- Automatic texture stitching
- Built-in Resource Packs
- Data-driven Texture collector
Data-Driven Systems
- Data Components
- Vanilla-style Tag System
- Extensible model mapping
- Property-based state resolution
UI Framework
CatFrame also provides a reusable GUI toolkit for building modern interfaces on Minecraft 1.7.10.
Included components include:
- Extensible UI components
- A screen that use these features, also have container type screen.
License
- Source Code: MIT License
- Assets: Copyright © dfdvdsf 2026, All rights reserved — Third-party character assets (Bluey & Bingo) are excluded from the open-source license and may not be redistributed without permission from their respective rights holders.
These assets are not affiliated with a Ludo Studio Production. - Binary Jars: Redistribution License v1.1
Dependency
Mixin Support: Recommend UniMixins for universial Mixin support.
Wiki
More detailed infomations, see here.
📱 Want the best experience?
For the smoothest installation and updates, use the Modrinth App.
Downloads through the Modrinth App also help support the project and the other projects' future development.
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
下载 CatFrame
CatFrame - 0.10.12
变更内容
将版本号从上一版本更改为 0.10.12
➕新增:
- emptyMessageAgreesWithTheMultiLineWidget 和
- 新的 scrollingFallback 辅助函数,保持纯函数特性以便进行单元测试
-
- 测试:新增 3 个 StringWidget 用例(共 23 个)和 2 个 MultiLineTextWidget 用例
- 添加 ui/screens/ConfirmScreen,作为原版 GuiYesNo 的 CatFrame 对应实现。
-
- .gitignore:在与其他 Minecraft 运行产物(.minecraft/、eclipse、
- 添加 ui/components/MultiLineTextWidget,作为只读多行文本的原版对应实现。
- 向 ui/components/StringWidget 添加 S10 TextOverflow 功能,并复用此前提交中
- 添加的 StringSplitter。
-
- 新增 TextOverflow 枚举 {CLAMPED, TRUNCATED, WRAP};CLAMPED 保留引用
- 且不依赖 FontRenderer;添加 StringWidgetOverflowTest(9 个用例)
- 添加 StringSplitter 回溯移植(支持 1.7.10 遗留 § 代码感知),用于基于宽度的文本
-
- 新增 ui/StringSplitter:WidthProvider 绑定到 FontRenderer(每个字形前进量
- (reflowDisplayLines / countDisplayLines),保留尾部换行符规则
-
- 添加 StringSplitterTest(21 个用例),使用合成宽度提供程序
- 识别 Text 模板中的 flags/width/precision/tT 说明符,使 %5s 和 %.2f 能够正确调用 String.format 而非原样泄露。无法拆分的说明符现在通过 formatFlat 扁平化整个模板,而不是留下后续转换未渲染。提取 decomposeTemplate/formatFlat 作为包级私有纯辅助函数,并添加覆盖可拆分、带装饰、正文百分比、失败、索引混合、样式和边界用例的 TextTemplateTest。
- 为原版方块添加类型化的状态更新器,并将其绑定到定义中。
-
- 新 VanillaStateUpdaters:STAIRS / PANE / REDSTONE_WIRE / DOOR / DOUBLE_PLANT (+ DOUBLE_PLANT_PREDICATE) / SNOWY,移植到当前字符串域属性(标志值为 "true"/"false",枚举为其序列化名称),而非旧的枚举域草稿。
-
- 邻居元数据解码通过声明的 MetaBlockProperty 实例进行(STAIR_FACING_META / HALF_BOTTOM_TOP_B2 / DOUBLE_PLANT_VARIANT_META),且门交叉半解码器复用 DOOR_FACING / DOOR_HINGE / OPEN 的值列表,因此每个属性仅保留单一解码实现。
-
- ResidentStateModel:添加显式的更新器/谓词绑定(Builder.updater / Builder.renderWhen),这些绑定回退到定义自身的钩子,从而使基础片段的类型化逻辑无需重新声明即可到达注册阶段。
-
- BlockStateDefinition:添加可为空的 updater / renderPredicate 字段及 getUpdater() / getRenderPredicate() 方法;对于所有现有定义,两者均为 null,因此解码和渲染结果保持不变。
-
- Builder:添加 updater(StateUpdater) 和 renderWhen(RenderPredicate);create() 将两者回填至定义中。
- 为世界相关方块状态添加类型化的状态更新契约。
-
- 纯新增:未触及任何现有管道,无行为变更。
- 将拉伸 mcmeta 部分注册到原版 IMetadataSerializer(在 refreshResources 时通过 MixinMinecraftMetadataSection),添加 StretchingMetadataSectionSerializer 并使 TextureStretchingMetadata 实现 IMetadataSection;load() 现在优先使用 IResource#getMetadata,保留 bare-mcmeta 解析器作为后备,关闭所有资源流并在资源重新加载时使其缓存失效
- 添加
🔧修复:
- 修复在 StringWidget 和
-
- CLAMPED 永远不会绘制超出限制的后缀:当 maxWidth 最多等于
- 而不是追加会使它超出限制的后缀
- 将其宽度减去后缀长度,类似于 MultiLineLabel#create
- 携带断点处激活的代码前缀,因此不会有任何内容被视为
- 到达绘制的字符串和宽度,每行包装前缀,钳制后缀
- clipText 语义(在后缀旁边裁剪,然后追加它),TRUNCATED 是硬截断
-
- 后缀为 "..." 而非 U+2026,因为 1.7.10 默认字体是
-
- 遗留格式代码通过 Style.applyLegacyFormat 解析,以便它们
-
- Text.legacyCodes 设为包级私有,以便分割器生成带有
- 修复沙子问题 #13
- 修复 mixins
-
- 遗留的 .dynamic(...) 绑定有意保留:此处未创建的定义(没有类型化定义的模组 BlockPane/BlockStairs 子类)仍通过字符串路径解析,因此没有方块会丢失其世界相关属性。
- 修复
-
- Render 否决现在拥有类型化通道(RenderPredicate 获取已解析状态上下文),与遗留解析器钩子并存。
-
- resolve():最后一个非空片段获胜(子类优先级),获胜的对通过 Builder.updater / Builder.renderWhen 重新绑定到合并后的定义上,因此基础片段的类型化状态更新逻辑不再因合并而丢失。
-
- 现有的动态解析器通道未受影响;无解码或渲染输出变更。
-
- 完成了世界相关状态管道的声明侧:定义现在携带“如何解析世界相关值”和“是否绘制已解析状态”作为两个独立的关注点。
-
- StateUpdater:渲染时的第二阶段(元数据解码的基础状态 -> 世界解析的状态)使用 O(1) BlockState#setValue 跳转转换;返回 null 表示错误并回退到基础状态。
- 从 TextureStretchingMetadata 中移除 bare-mcmeta 后备读取器,使拉伸部分仅通过 IMetadataSerializer 注册解析(registerSection 运行之前 load() 返回 null);删除现在未使用的 JsonParser/InputStream 导入并刷新两者的 javadoc
- 修复并测试
❗❗❗弃用:
- 将空行列表视为不绘制任何内容,并移除了 getHeight 后备
- onClose 恢复父屏幕,而不是退回游戏
-
- setMaxRows(int) 丢弃额外行并对最后一行保留的行进行省略号处理,裁剪
- 移除
备注
完整更新日志:
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
模组
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧