GeckoMesh

A premium, lightweight PolyMesh rendering library for GeckoLib.
Bring Bedrock-style geometry to your entities — with zero runtime cost.

What is GeckoMesh?

GeckoMesh is a developer-focused compatibility library that unlocks Bedrock-style PolyMesh geometry for GeckoLib-powered mods. It hooks directly into the model baking pipeline and appends baked PolyMesh faces straight to GeckoLib's native GeoBone structure — so your custom low-poly meshes just work, no overhauls needed.

Whether you're building a new entity mod or extending an existing one, GeckoMesh slots in silently and efficiently, supporting Fabric, Forge, and NeoForge from a single library JAR.

Features

Feature Details ⚡ Zero Runtime Overhead All PolyMesh processing happens during model baking. No per-frame cost. 🦎 GeckoLib Native Integration Baked PolyMesh geometry is appended directly to GeckoLib's GeoBone list. 🔀 Cross-Platform A single codebase targeting Fabric, Forge, and NeoForge simultaneously. 📐 Smart UV & Normal Calculation Automatically normalizes UV coordinates and computes flat-shaded face normals. 🧩 Drop-in Library No config files, no registrations. Add the JAR and it works. 📦 Lightweight Minimal JAR size. No bloat, no unnecessary dependencies beyond GeckoLib.

How It Works

GeckoMesh uses a custom Mixin that intercepts GeckoLib's bone construction phase. When a PolyMesh block is detected inside a model JSON, the library's deserializer kicks in, flattens the mesh geometry into a set of GeoCube entries, and injects them into the bone before the pipeline continues. The result is fully baked geometry that GeckoLib renders natively — no custom render layer, no shader trickery.

Compatibility

Platform Loader Version Minecraft Versions 🧵 Fabric Fabric Loader >= 0.14 1.20.1 → 1.21.11 ⚒️ Forge Forge 47.x 1.20.1 → 1.21.11 🔷 NeoForge NeoForge 20.4.x 1.20.4 → 1.21.11

Required dependency: GeckoLib  |  Java: 17 or newer

Installation

1. Make sure GeckoLib is installed for your loader and Minecraft version.
2. Download the GeckoMesh JAR for your platform from the Files tab:
   
   • geckomesh-fabric-1.20.1-1.21.11-1.0.0.jar
   • geckomesh-forge-1.20.1-1.21.11-1.0.0.jar
   • geckomesh-neoforge-1.20.4-1.21.11-1.0.0.jar
3. Place the downloaded JAR into your .minecraft/mods folder.
4. Launch the game — GeckoMesh registers automatically. No configuration needed.

For Developers

GeckoMesh is primarily a library mod. If you're building a mod that uses GeckoLib and want to ship PolyMesh-based geometry, simply declare GeckoMesh as a dependency in your mod metadata. All PolyMesh blocks in your model JSONs will be picked up automatically.

The library exposes a clean Mixin plugin API and a JSON utility class (MixinJsonUtil) for advanced usage. Source code and examples are available in the repository linked below.

Credits

• Author: Bay4lly
• License: MIT
• Inspired by: GeckoLib by Bernie-G & the GeckoLib team

💬 Join the Discord  |  📦 CurseForge  |  🐱 GitHub

 

Blockbench Meshy Plugin's GeckoMesh fork:

https://raw.githubusercontent.com/Bay4lly/geckomeshy/main/geckomeshy.js

 

TO INSTALL: