GeckoMesh
- By
A premium, lightweight PolyMesh rendering library for GeckoLib. Bring Bedrock-style geometry to your entities — with zero runtime cost.
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
- Make sure GeckoLib is installed for your loader and Minecraft version.
- Download the GeckoMesh JAR for your platform from the Files tab:
geckomesh-fabric-1.20.1-1.21.11-1.0.0.jargeckomesh-forge-1.20.1-1.21.11-1.0.0.jargeckomesh-neoforge-1.20.4-1.21.11-1.0.0.jar
- Place the downloaded JAR into your
.minecraft/modsfolder. - 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:
The GeckoMesh Team
Owner
