Chlorine is a Fabric performance and power-management mod for Minecraft 26.3. It targets CPU-side simulation work, bursty entity effects, and laptop power usage while leaving chunk rendering and renderer internals to specialized mods.
- Adaptive simulation distance: monitors a rolling FPS average and lowers simulation distance when performance falls below the configured threshold. It raises the value again after a longer recovery cooldown.
- Entity-distance scaling: can reduce the entity-distance multiplier after simulation distance reaches its configured floor.
- Particle fallback: can reduce the particle setting as a last resort.
- Simulation-distance cap: optionally prevents other tuning systems from raising simulation distance above a fixed ceiling.
- Fast-travel chunk governor: temporarily lowers simulation distance while moving quickly, such as with an Elytra or Riptide trident, then restores it after a cooldown.
Chlorine intentionally changes simulation distance, not render distance. Render-distance changes can rebuild the entire chunk render graph and cause a large hitch; simulation distance instead targets server ticking, entity updates, random ticks, and block updates.
- Distant classic-mob AI throttle: staggers goal-selector AI for mobs such as zombies and skeletons when no player is nearby. Physics and nearby mobs are not throttled.
- Distant Brain-mob throttle: applies the same idea directly to
Brain.tick()for villagers, piglins, hoglins, allays, frogs, and other Brain-driven mobs. - Font width caching: caches repeated plain-string width measurements used by HUDs and menus, reducing CPU work without changing OpenGL rendering.
- Item merging: periodically combines compatible nearby item entities around online players.
- XP orb merging: combines nearby experience orbs. The implementation verifies the internal value update before discarding an orb and disables itself for the session if that operation cannot be verified.
- Server tick diagnostics: optionally logs a warning when average server tick time exceeds the configured threshold. This is observability only; it does not alter server behavior.
- Unfocused-window power saver: caps FPS while the game window is unfocused or minimized and can hide clouds during that period.
- Sound budget: limits how many new sounds may start in one client tick, smoothing bursts from farms, combat, or other events.
- Sound pre-cull: drops very quiet distance-attenuated sounds before they reach the audio engine.
- Particle budget: limits particle creation per client tick to smooth fireworks, explosions, potion clouds, and similar bursts.
- Beacon and portal throttles: skips distant beacon beams and Nether portal ambient particles when enabled.
- Low-end auto-tune: once per launch, detects constrained memory or CPU availability and applies lighter vanilla visual defaults.
- Light update smoothing, adaptive ambient effects, sign text LOD, item drop LOD, block entity LOD and autosave smoothing (1.0.6): spread bursts of work over several frames or ticks and skip detail that is too far away to see.
- Adaptive chunk upload budget (1.0.7): lowers Sodium's 10 ms minimum per-frame chunk upload time so uploads cannot outlast a frame at high FPS. The full budget is kept for the first seconds after joining a world.
- Nearby rebuild scaling (1.0.7): while FPS is low, shrinks the radius in which block changes are rebuilt and shown immediately on the main thread.
- Async culling under pressure (1.0.7): while FPS is low, keeps Sodium's visibility culling on its background thread during fast camera movement.
The 1.0.7 patches change Sodium internals; if a future Sodium version changes that code, they switch themselves off instead of crashing the game.
Java's garbage collector is chosen by the launcher's JVM flags, so a mod cannot replace it. The memory governor works around it instead:
- Cache trimming: empties Chlorine's own collision cache when heap usage passes a configurable percentage (default 85%).
- GC after leaving a world: requests one collection on a background thread, at most once a minute. It is ignored under
-XX:+DisableExplicitGC. - Leak watch: logs a warning if memory kept after garbage collections keeps growing. It only logs and never changes behavior.
All features are independently configurable and can be disabled without removing the mod.
- Minecraft 26.3
- Fabric Loader 0.19.5 or newer
- Fabric API
- Java 25 or newer
- Cloth Config API (required)
- Sodium 0.9.2 or newer (required since 1.0.3)
Mod Menu is optional. When installed, it adds Chlorine's Config button to the mod list. Chlorine is designed to coexist with Lithium, FerriteCore, EntityCulling, ImmediatelyFast, and Iris; none of those mods is required.
Website
Official website hosted here