Greedy Meshing Mod

A client-side Fabric optimization mod that merges identical adjacent block faces into larger quads, reducing the total vertex count for better GPU performance.

Features

• Automatic merging of opaque full-cube block faces
• Custom terrain shaders for correct texture tiling on merged faces
• Aggressive Greedy (Absolute) option. It merges across ambient-occlusion boundaries for even fewer quads, at the cost of slightly coarser lighting
• Greedy Water option (VERY experimental). Merges flat still-water surfaces (open oceans, lake interiors) into larger quads. Shorelines and flowing water are unaffected. Not supported on VulkanMod
• Merge Oriented Blocks option (experimental). Allows blocks with a facing/axis/rotation property (common on modded blocks) to merge once their baked model is verified to be a plain six-face cube with standard UVs, raising the merge rate on normal terrain instead of excluding those blocks outright
• Sodium compatible
• VulkanMod compatible (1.21-1.21.5, 1.21.9-1.21.11, 26.1-26.1.2; 1.21.6-1.21.8 not available, VulkanMod was never released for those)
• Distant Horizons compatible
• Sable compatible (sub-level geometry no longer double-darkens with greedy meshing on)
• Works with Minecraft 26.2's native experimental Vulkan rendering backend
• Debug wireframe and split-screen comparison mode
• In-game config screen (requires Cloth Config + Mod Menu)

Supported Versions

Minecraft	Loader
1.21 - 1.21.11	Fabric
26.1 - 26.2	Fabric

Performance

Performance gains vary depending on your hardware and world. If your GPU is already underutilized (high FPS), the improvement may be minimal. The mod benefits most on lower-end GPUs, higher render distances, and worlds with large flat surfaces of the same block type (e.g. superflat, underground caves, large builds).

Known Limitations

• Shader packs (Iris/OptiFine) are not fully supported. The mod falls back to face-culling-only mode.
• Blocks with random texture rotation (example: grass) will be rendered with a single texture orientation instead of vanilla's randomization. This is a side effect of caching block appearance for performance and is not planned to change, as fixing it would reduce merging efficiency on affected blocks.
• Lighting on large merged surfaces may look slightly different from vanilla.
• Greedy Water is experimental (some water surfaces may render with missing or black faces on Sodium). The root cause is not yet identified. Disable Greedy Water if you see this.
• Merge Oriented Blocks is experimental. If a merged block renders with a stretched or misaligned texture, disable this option and report the block.

Credits

Fork of Greedy Meshing by BuggiestStudios, with significant modifications including multi-version support (via Stonecutter), binary meshing.