Allow anonymous analytics?

Our cookieless analytics show us which features get used and store nothing on your device. We never sell your data or use it for advertising.

Privacy choices

Choose what ModDex may collect. You can change this anytime from Privacy choices in the footer.

Read the full privacy policy

Strictly necessary Required for the site to work: login sessions, security tokens, and abuse prevention. Always on and cannot be disabled. Always on
Analytics Cookieless analytics through PostHog's EU servers, used only to see which features get used. Nothing is stored on your device, and the anonymous visitor ID resets every day. Needs your consent because usage data goes to a third party. Never used for advertising or profiling. Off by default in the EU and UK.

GeckoMesh

Quick rating

Community listing page, reviews may not be monitored by the author.

How listings work Are you the author?

GeckoMesh

By bay4lly

No reviews yet

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

Mod Loaders
Minecraft
26.2
Shockbyte server hosting: 35% off your first server with code MODDEX35 (opens in a new tab)

About

Description

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: