CatFrame

CatFrame

A shared frameworks bringing 1.8‑style models and flexible UI components to legacy modding.

by
105 Downloads
forgelibraryutility
Rent Server with this Mod

About this Mod

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

Available Versions

0.1.0release
MC 1.7.10forge
June 6, 2026
0.0.9release
MC 1.7.10forge
June 6, 2026
0.0.8release
MC 1.7.10forge
June 6, 2026
0.0.7release
MC 1.7.10forge
June 6, 2026
0.0.6release
MC 1.7.10forge
June 6, 2026

How to Install CatFrame on Your Server

1

Order Server

Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).

2

Set forge Loader

In the panel under "Egg", select the forge loader and matching Minecraft version (1.7.10).

3

Install Mod

Open the mod browser in the dashboard and search for "CatFrame". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.

Compatibility

Mod Loaders

forge

Minecraft Versions

1.7.10

Server-side

~ Optional

Recommended RAM

4 GB(min. 3 GB)

Frequently Asked Questions

CatFrame server crashes on startup – what to do?

Most common cause: wrong forge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.7.10). You can switch loaders with one click in the panel.

Is CatFrame compatible with forge?

CatFrame officially supports forge for Minecraft 1.7.10. The Mado dashboard automatically detects incompatible loader combinations.

Server lagging with CatFrame – how to optimize performance?

Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CatFrame consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.

Rent Modded Server

Install CatFrame with just one click on your server.

Recommended RAM
4 GBab €8/mo
Min. 3 GB | +1 GB pro 8 Spieler
Create Server Now
1-Click Mod Install
NVMe SSD Storage
DDoS Protection included

Details

License
MIT License
Server-side
Optional

Supported Versions

1.7.10