⚡ LiteCPU — Client-Side Performance Mod

A client-side Fabric performance mod focused on reducing render load, particle spam, and unnecessary visual overhead. Works on any server — no server installation required.

---

✨ What does LiteCPU do?

🎆 Particle Optimization

LiteCPU aggressively reduces particle overload in two ways:

• Limits particle spawning once too many particles are already active
• Culls particles that are too far from the camera

This helps in situations like combat, mob grinders, explosions, and crowded servers where particle spam can tank FPS.

Particle settings are fixed at optimal values out of the box — no tuning needed.

🧠 Adaptive Performance

LiteCPU dynamically tightens visual budgets when your FPS drops, then relaxes them again when performance recovers.

It automatically adjusts:

• Particle limits
• Particle cull distance
• Entity render distance
• Block entity render distance
• Chunk update delay

Adaptive performance runs at aggressive settings out of the box — no configuration needed.

🧟 Entity Render Culling

LiteCPU skips rendering entities beyond a configurable distance from the camera.

You can:

• Set a manual entity render distance
• Use automatic fallback distance culling instead
• Enable enhanced frustum culling for aggressive off-screen entity skipping

📦 Block Entity Culling

LiteCPU reduces rendering of distant block entities like chests, signs, furnaces, and other tile entity renderers. Especially useful in bases, storage rooms, and heavily decorated areas.

🗺️ Chunk Update Throttling

LiteCPU delays distant chunk mesh rebuilds to reduce CPU spikes from chunk updates and render rebuild spam. Most useful when moving through large areas or during heavy chunk update bursts.

🧩 Compatibility Awareness

LiteCPU auto-detects VulkanMod and Particle Core and disables conflicting hooks to avoid issues. Optional overrides are available for advanced users.

---

🎛️ Configuration

Install Mod Menu + Cloth Config and click the config button next to LiteCPU to change settings in-game.

Configurable categories:

• Entity Rendering — render distance, frustum culling, auto-culling fallback
• Block Entities — cull distance for chests, signs, furnaces, etc.
• Chunk Rendering — throttle radius and update interval
• Compatibility — override hooks for VulkanMod and Particle Core
• Language — config screen language

Particle, adaptive performance, FPS limiting, and statistics settings are pre-configured at optimal values and not exposed in the UI.

---

📦 Installation

1. Install Fabric API
2. Drop lite-cpu.jar into your mods/ folder
3. (Optional) Install Mod Menu + Cloth Config for the in-game config screen

---

❓ FAQ

Does the server need this mod?
No — LiteCPU is fully client-side and works on any server.

Does it change gameplay?
No — LiteCPU only affects rendering and visual performance on the client.

Is it compatible with other performance mods?
Generally yes. LiteCPU is lightweight and client-only, with built-in safeguards for known rendering mods.

Why are some settings not configurable?
Particle, adaptive, and FPS settings are locked at best-performing values so every user gets maximum performance out of the box without needing to tune anything.

---

Made by synical — MIT License