Back to mods
GeckoMesh project artwork

CurseForge · Minecraft mod

GeckoMesh

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which GeckoMesh release should I use?

Updated last month
Latest stable file geckomesh-neoforge-26.1-26.2-1.2.0.jar
Game version 26.1, 26.1.1, 26.1.2
Loader NeoForge

geckomesh-neoforge-26.1-26.2-1.2.0.jar targets 26.1, 26.1.1, 26.1.2 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 1 required mods have matching files.

Where it goes

Is GeckoMesh required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release NeoForge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does geckomesh-neoforge-26.1-26.2-1.2.0.jar need?

geckomesh-neoforge-26.1-26.2-1.2.0.jar. Change the file and its required mods may change too.

All 1 required mods have matching files

Install GeckoLib first. We found matching files for this game-version and loader setup.

GeckoLib Needed by geckomesh-neoforge-26.1-26.2-1.2.0.jar
required
Matching file found Matched file: NeoForge 5.5.6

We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add GeckoMesh without breaking your instance.

Built for geckomesh-neoforge-26.1-26.2-1.2.0.jar. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use geckomesh-neoforge-26.1-26.2-1.2.0.jar. It targets 26.1, 26.1.1, 26.1.2 with NeoForge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install GeckoLib first. We found matching files for this game-version and loader setup.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside geckomesh-neoforge-26.1-26.2-1.2.0.jar. It opens that exact file at the source.

About this project

What does GeckoMesh add?

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.

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:

Project description from CurseForge.

Pick your setup

GeckoMesh by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

44 available setups

Showing the newest 12 of 22 game versions. Older files are in the list below.

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

GeckoMesh versions and loaders

6 of 6 releases match

Looking for an older file? The official CurseForge project page is in Resources.