CLab
No reviews yet
Bringing Hardware Occlusion Culling (HOC) to Minecraft entity rendering optimization.
Does not follow a specific thematic focus apart from vanilla Minecraft.
Used for mods with little to no gameplay elements.
Enhances game performance and optimizes resource usage.
Adds client-side tools and features to enhance the user experience.
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.
Quilt is a fork of the Fabric mod loader. Many Fabric mods are compatible with Quilt and vice versa.
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
Modrinth
Compatibility
Supported Environments
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
About
Description
Bringing Hardware Occlusion Culling (HOC) to Minecraft entity rendering optimization.
CLab is a client-side rendering optimization mod. It leverages GPU OpenGL occlusion queries to determine entity visibility directly, eliminating the approximation errors and side effects inherent to traditional CPU-side pathtracing.
Core Features
Hardware Occlusion Culling (HOC)
Uses GPU queries to test entity bounding boxes against the depth buffer, measuring real occlusion against actually rendered terrain rather than CPU-side approximations of the world model.Zero False-Positive Culling
Based on ground-truth depth buffer testing. An entity is never hidden if even a single pixel is visible. No whitelist needed, no per-mod patches required.Render-Layer Only, Zero Intrusion
Only decides whether to invoke the entity render method. Does not interfere with client-side ticks, animation states, position interpolation, or any logic. Trains, vehicles, and contraptions behave normally.Built-in Leaf Face Culling
Automatically culls leaf faces occluded by adjacent leaves, reducing terrain rendering overhead.Zero-Config, Works Out of the Box
No entity whitelist, no distance threshold, no tick-culling toggle. Install and play.
Technical Overview
CLab uses Hardware Occlusion Culling:
- During entity rendering, submit the entity bounding box to the GPU as an occlusion query (OpenGL Query).
- The GPU compares the bounding box against the already-rendered terrain depth buffer at the hardware level.
- Read the previous frame's query result: if no pixels passed the depth test, skip rendering this entity.
This creates a fundamental difference:
| Aspect | CPU Pathtracing | CLab HOC |
|---|---|---|
| Occlusion basis | Simplified assumptions about world model | Actual GPU-rendered depth buffer |
| False positives (hiding visible entities) | Common (near non-solid blocks) | Extremely unlikely |
| Entity tick/animation | Often frozen or skipped | Completely unaffected |
| CPU overhead | Continuous background traversal | Render thread submits AABB only; GPU handles the rest asynchronously |
| Configuration required | Whitelists, distance limits, thresholds as compensatory mechanisms | None required |
⚠️ Important Compatibility Notes
- Hardware Requirement: CLab requires a dedicated graphics card with OpenGL 3.3 or higher. Most modern GPUs meet this requirement, but certain older integrated graphics or outdated drivers may not.
- Do NOT use with other entity culling mods: CLab should not be installed alongside EntityCulling or any other mod that modifies entity/block entity visibility. While these mods use different techniques, they all ultimately override the same visibility decisions. Running more than one will not improve performance — instead, they may conflict and cancel out each other's optimizations, resulting in wasted resources and potential visual inconsistencies. For the best results, keep only CLab active.
Compatibility & Future Optimizations
The current approach was chosen to maintain compatibility with older devices and macOS. A more advanced technique is available, but it would introduce compatibility problems on those systems. Development and testing are currently done on a Mac, which limits how far I can improve things today. I plan to transition to a machine with OpenGL 4.6 support soon, after which I’ll introduce a system that automatically selects the optimal method during loading.
Bringing Hardware Occlusion Culling (HOC) to Minecraft entity rendering optimization.
CLab is a client-side rendering optimization mod. It leverages GPU OpenGL occlusion queries to determine entity visibility directly, eliminating the approximation errors and side effects inherent to traditional CPU-side pathtracing.
Core Features
-
Hardware Occlusion Culling (HOC)
Uses GPU queries to test entity bounding boxes against the depth buffer, measuring real occlusion against actually rendered terrain rather than CPU-side approximations of the world model. -
Zero False-Positive Culling
Based on ground-truth depth buffer testing. An entity is never hidden if even a single pixel is visible. No whitelist needed, no per-mod patches required. -
Render-Layer Only, Zero Intrusion
Only decides whether to invoke the entity render method. Does not interfere with client-side ticks, animation states, position interpolation, or any logic. Trains, vehicles, and contraptions behave normally. -
Built-in Leaf Face Culling
Automatically culls leaf faces occluded by adjacent leaves, reducing terrain rendering overhead. -
Zero-Config, Works Out of the Box
No entity whitelist, no distance threshold, no tick-culling toggle. Install and play.
Technical Overview
CLab uses Hardware Occlusion Culling:
- During entity rendering, submit the entity bounding box to the GPU as an occlusion query (OpenGL Query).
- The GPU compares the bounding box against the already-rendered terrain depth buffer at the hardware level.
- Read the previous frame's query result: if no pixels passed the depth test, skip rendering this entity.
This creates a fundamental difference:
| Aspect | CPU Pathtracing | CLab HOC |
|---|---|---|
| Occlusion basis | Simplified assumptions about world model | Actual GPU-rendered depth buffer |
| False positives (hiding visible entities) | Common (near non-solid blocks) | Extremely unlikely |
| Entity tick/animation | Often frozen or skipped | Completely unaffected |
| CPU overhead | Continuous background traversal | Render thread submits AABB only; GPU handles the rest asynchronously |
| Configuration required | Whitelists, distance limits, thresholds as compensatory mechanisms | None required |
⚠️ Important Compatibility Notes
- Hardware Requirement: CLab requires a dedicated graphics card with OpenGL 3.3 or higher. Most modern GPUs meet this requirement, but certain older integrated graphics or outdated drivers may not.
- Do NOT use with other entity culling mods: CLab should not be installed alongside EntityCulling or any other mod that modifies entity/block entity visibility. While these mods use different techniques, they all ultimately override the same visibility decisions. Running more than one will not improve performance — instead, they may conflict and cancel out each other's optimizations, resulting in wasted resources and potential visual inconsistencies. For the best results, keep only CLab active.
Compatibility & Future Optimizations
The current approach was chosen to maintain compatibility with older devices and macOS. A more advanced technique is available, but it would introduce compatibility problems on those systems. Development and testing are currently done on a Mac, which limits how far I can improve things today. I plan to transition to a machine with OpenGL 4.6 support soon, after which I’ll introduce a system that automatically selects the optimal method during loading.
Screenshots
Gallery
-
clab.png clab.png -
CLabD.png CLabD.png
-
EntityCulling vs CLab
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