Mod
GeckoMesh
No reviews yet
A premium, lightweight PolyMesh rendering library for GeckoLib. Bring Bedrock-style geometry to your entities — with zero runtime cost.
Forge is a popular mod loader for versions 1.1+ of Minecraft.
Neoforge is a fork of the Minecraft Forge available for versions 1.20.1+ of Minecraft. Many Forge mods are compatible with Neoforge and vice versa.
Fabric is a mod loader for versions 1.14+ of Minecraft, particularly popular for client side and optimization mods.
Community voices
Reviews
Click once to include, again to exclude, again to clear
No reviews yet. Be the first to review this project!
Get it on
Available Platforms
CurseForge
About
Project Details
For authors
Embed Badge
If you're the author of this project, you can embed a live badge anywhere that supports HTML or Markdown. It updates automatically whenever ratings change.
Use HTML for any page that supports it, or Markdown for README files and Markdown-based descriptions.
Identifiers
Platform IDs
Resources
External Links
About
Description
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:
Screenshots
Gallery
Versions
Files
Relations
Project Relations
More like this
Similar Mods
Suggestions use data such as tags, dependencies, dependents, descriptions, titles, and more to rank how much they overlap with this mod.
On ModDex
Community snapshot
By the numbers
Statistics
Want to reach Minecraft players?
We're looking for a server hosting partner to feature here and other parts of the site. Interested? Send us a message!
Get in touchGet it on
Available Platforms
On ModDex
Community snapshot
By the numbers
Statistics
Resources