CatFrame

A Modern Rendering & UI Framework for Minecraft 1.7.10
CatFrame is a comprehensive rendering and UI framework for Minecraft 1.7.10, providing a full backport of the 1.8+ JSON model pipeline, an extensible blockstate system, an enhanced multi‑layer item renderer, and a modular UI component toolkit, for all of my works.
It serves as a foundational library for advanced mod development, enabling clean, data‑driven rendering and modern GUI design on a legacy version of Minecraft.

Rendering & Model System

CatFrame implements a complete 1.8‑style JSON model architecture:

• Model inheritance (parent) with full merging of textures, elements, and display
• Blockstate JSON with property‑based variants, rotations, UV lock, weighted randomness, and multipart logic
• Runtime state mapping via IBlockStateProvider, allowing metadata/world state → variant resolution
• Automatic model baking into BakedQuad with Mixin‑based integration into vanilla block/item rendering
• Namespace‑based resource loading (models/, blockstates/, model_mappings.json)
• Texture collection & stitching during TextureStitchEvent
• Full display transform support for GUI, ground, fixed, first‑person, third‑person, and custom contexts

This system eliminates the need for ISBRH/TESR renderers and enables fully data‑driven block and item visuals.

ItemModern

Enhanced Item Rendering, CatFrame extends the vanilla item renderer with:

• Unlimited texture layers (not limited to 1–2 like vanilla)
• Per‑layer color tinting
• 2D GUI rendering + 3D in‑hand transforms
• Full compatibility with JSON item models
• Automatic multi‑pass rendering via getRenderPasses() and getColorFromItemStack()

This allows complex item visuals (weapons, tools, overlays, dyeable layers) without custom rendering code.

UI Framework

CatFrame includes a modular UI toolkit used by CreateWorldUI and available for any mod:

GuiCyclableButton<T>

A type‑safe cycling button with scroll‑wheel support, customizable value‑to‑text formatting, and update callbacks.
Ideal for option selectors, difficulty toggles, mode switches, and world‑creation parameters.

ContentPanelRenderer

A shared renderer for modern panel layouts:

• Header/footer separators
• Tiled backgrounds
• Custom textures
• One‑call drawContentPanel() convenience method

Useful for structured option panels and grouped UI sections.

Tab System

A complete multi‑tab GUI framework:

• Tab interface for custom logic
• AbstractScreenTab for easy implementation
• TabManager for switching, input routing, and resize persistence
• TabBar for customizable tab bars (solid color, tiled textures, custom tab button textures)
• TabRegistry for registering tabs from external mods

Designed for complex screens, configuration menus, and multi‑section interfaces.

Credits

• 草莓龍醬 & AmarokIce for the json model support.

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.

Features

Rendering & Resources

• Complete 26.1+ JSON Model pipeline
• Modern Blockstate system
• Runtime model baking
• Namespace-based resource loading
• Automatic texture stitching
• Display transforms
• Multi-layer item rendering
• Modern Item Model definitions

Data-Driven Systems

• Data Components
• Vanilla-style Tag System
• Extensible model mapping
• Property-based state resolution
• Resource-driven configuration

UI Framework

CatFrame also provides a reusable GUI toolkit for building modern interfaces on Minecraft 1.7.10.

Included components include:

• Tab framework
• GuiCyclableButton
• ContentPanelRenderer
• Scrollable widgets
• Modern layout helpers
• Reusable GUI controls
• Extensible UI components

Designed for Mod Developers

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 modern, maintainable, and data-driven mod development possible on a legacy Minecraft version.