CurseForge · Minecraft mod
GeckoMesh
A premium, lightweight PolyMesh rendering library for GeckoLib. Bring Bedrock-style geometry to your entities — with zero runtime cost.
Quick answer
Which GeckoMesh release should I use?
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.
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.
Install GeckoLib first. We found matching files for this game-version and loader setup.
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.
- 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.
- 02
Bring the mods it needs
Install GeckoLib first. We found matching files for this game-version and loader setup.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 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
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:


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.
26.2
2 loader builds26.1.2
2 loader builds26.1.1
2 loader builds26.1
2 loader builds1.21.11
2 loader builds1.21.10
2 loader builds1.21.9
2 loader builds1.21.8
2 loader builds1.21.7
2 loader builds1.21.6
2 loader builds1.21.5
2 loader builds1.21.4
2 loader buildsShowing 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
geckomesh-neoforge-26.1-26.2-1.2.0.jar
geckomesh-neoforge-26.1-1.2.0.jar
14 Jul 2026
geckomesh-fabric-26.1-26.2-1.2.0.jar
geckomesh-fabric-26.1-1.2.0.jar
14 Jul 2026
geckomesh-fabric-1.20.1-1.21.11-1.1.jar
19 Jun 2026
geckomesh-forge-1.20.1-1.21.11-1.1.jar
19 Jun 2026
geckomesh-fabric-1.20.1-1.21.11-1.0.0.jar
17 Jun 2026
geckomesh-forge-1.20.1-1.21.11-1.0.0.jar
17 Jun 2026
Looking for an older file? The official CurseForge project page is in Resources.
