Occulsion - Entity Culling

🎮 Press F8 In-Game to Toggle Entity Culling ON/OFF!

Instantly enable or disable Occlusion without restarting Minecraft.

Occlusion – Entity Culling

Render Less. Play Smoother.

Occlusion is a lightweight, client-side optimization mod designed to improve Minecraft's rendering efficiency by skipping entities that are hidden behind solid blocks.

Minecraft can spend resources rendering entities that players cannot actually see. Occlusion addresses this by checking visibility before rendering, reducing unnecessary work and potentially improving FPS in entity-heavy environments.

Whether you're exploring caves, building massive farms, or playing in crowded areas, Occlusion aims to make your experience smoother without changing the way Minecraft plays.

⚡ Features

Smart Entity Culling

Uses line-of-sight checks to determine whether entities are completely hidden behind solid blocks, allowing the game to skip unnecessary rendering.

Optimized Block Entity Rendering

Supports culling for ordinary block entities, including chests, when they are obstructed from view.

Lightweight Performance Optimization

Uses cached visibility results and limits the number of new checks performed within short intervals to help control processing overhead.

Conservative Visibility Detection

Treats glass, slabs, and other non-full blocks carefully to reduce the risk of accidentally hiding visible objects.

Instant Toggle

Press F8 in-game to enable or disable Occlusion without restarting Minecraft.

Fully Client-Side

No server installation required. Designed for both singleplayer and multiplayer.

Configurable Settings

Adjust visibility-check distances, refresh intervals, and block-entity culling preferences to suit your setup.

🔍 How Does Occlusion Work?

Imagine standing inside your base with dozens of mobs behind a solid wall.

Although you cannot see those mobs, the game may still perform rendering work for them.

Occlusion checks whether solid blocks completely obstruct an entity from your view.

If an entity is hidden, its rendering can be skipped until it becomes visible again.

The goal is simple:

Less unnecessary rendering. More resources available for gameplay.

🎮 Compatibility

Supported Version: Minecraft 1.20.1

Mod Loader: Fabric

Required Dependency: Fabric API

Environment: Client-side

Occlusion is designed to work alongside other Fabric mods, although compatibility with every rendering optimization, shader, or custom entity renderer cannot be guaranteed.

The mod does not modify mob spawning, entity AI, item drops, or server-side simulation.

⚙️ Configuration

Press F8 to toggle entity culling on or off.

Advanced settings are available in:

config/simpleocclusion.properties

Available settings include:

• Enable or disable entity culling

• Enable or disable block-entity culling

• Optional support for modded block entities

• Maximum visibility-check distance

• Visibility refresh interval

• Maximum checks per processing interval

📈 Performance