Home›Java›Mods›GeckoMesh
GeckoMesh
ModsJava

GeckoMesh

Java mod listed for Minecraft 1.20–1.21. Downloads from the MC Java Mods app on Android.

by bay4lly · on CurseForge

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

Which build do you need?

This mod ships a separate file for every mod loader and every version of the game. Pick both, then download — the wrong build installs fine and then does nothing in the game.

Mod loader

Minecraft version

⬇ Download for 1.20.1–1.21.11 · Fabric⬇ Download for 1.20.1–1.21.11 · Forge
I don't know my version or loader
Open the Minecraft launcher and look at the profile you play on — it names both, like fabric-loader-1.21.4. The version also shows in the bottom-right corner of the game's main menu.
No loader in the profile name? Then it's plain Minecraft, and these mods won't run — you need Fabric or NeoForge installed first.
Open in MC Java ModsGet it on Google Play →

GeckoMesh Icon

GeckoMesh

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

CurseForge Discord MIT License Minecraft Versions

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.

GeckoMesh — Minecraft Java mod, screenshot 1

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

💬 Join the Discord  |  📦 CurseForge  |  🐱 GitHub

 

Blockbench Meshy Plugin's GeckoMesh fork:

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

 

TO INSTALL:

 

GeckoMesh — Minecraft Java mod, screenshot 2

GeckoMesh — Minecraft Java mod, screenshot 3

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

File checked by MCModsHub

These come from our own check of the pack file, not from the source page.

Explore more

All Mods for JavaAll Minecraft Java modsJava mods for 1.21Java mods for 1.20