Repository navigation
Releases
1.0.8 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Chlorine 1.0.8 for Minecraft 26.3
Requires Fabric Loader 0.19.5+, Fabric API, Cloth Config API, Sodium 0.9.2+ and Java 25+.
What's new
- Memory governor. A new client-side system with its own "Memory Governor" config category.
- Empties Chlorine's collision cache when heap usage passes a configurable percentage (default 85%).
- Requests one garbage collection on a background thread after you leave a world, at most once a minute. Ignored if the JVM runs with
-XX:+DisableExplicitGC. - Leak watch logs a warning if memory kept after garbage collections keeps growing. It only logs and never changes behavior.
- Java's garbage collector is chosen by your launcher's JVM flags, so a mod cannot replace it. G1 or Generational ZGC with 6 to 8 GB allocated usually helps most.
Notes
- Everything is toggleable in the in-game config.
- The memory governor has not been benchmarked, so no FPS gain is claimed.
1.0.7 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Chlorine 1.0.7 for Minecraft 26.3. Requires Fabric API, Cloth Config and Sodium 0.9.2 or newer.
New in 1.0.7 (each has a config toggle, under Sodium Workload Governors):
- Adaptive chunk upload budget: lowers Sodium's 10 ms minimum per-frame chunk upload time so uploads can't outlast a frame at high FPS. The full budget is kept for the first seconds after joining a world.
- Nearby rebuild scaling: while FPS is low, shrinks the radius in which block changes are rebuilt and shown immediately on the main thread (TNT, pistons, redstone).
- Async culling under pressure: while FPS is low, keeps Sodium's visibility culling on its background thread during fast camera movement.
These three patch Sodium's internals. If a future Sodium version changes that code, they switch themselves off instead of crashing the game.
Also includes everything from 1.0.6: light update smoothing, adaptive ambient effects, sign text, item drop and block entity LOD, and autosave smoothing.
1.0.6 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Chlorine 1.0.6 for Minecraft 26.3. Requires Fabric API, Cloth Config and Sodium 0.9.2 or newer.
New in 1.0.6 (every feature has a config toggle):
- Light update smoothing: spreads large client light-update bursts across frames.
- Adaptive ambient effects: scales ambient particles down when FPS is low.
- Sign text LOD: skips sign text beyond a configurable distance.
- Item drop LOD: draws distant item stacks as a single item.
- Block entity LOD: skips distant block entity rendering.
- Autosave smoothing: spreads the periodic autosave over several ticks to remove the stutter.
Chlorine 1.0.5 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Chlorine 1.0.5
Performance
- Reduced client-tick overhead with primitive FPS ring buffers and rolling averages.
- Removed recurring boxed FPS sampling and stream-based averaging from adaptive performance scaling.
- Replaced retained camera-vector state with primitive coordinate tracking in the Sodium workload governor.
- Avoided per-tick square-root work in the fast-travel chunk governor.
Compatibility
- Preserved Sodium's existing terrain renderer, culling, batching, and visual quality.
Requirements
- Minecraft 26.3
- Fabric Loader 0.19.5 or newer
- Fabric API
- Cloth Config API
- Sodium 0.9.2 or newer
- Java 25 or newer
Chlorine 1.0.4 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Chlorine 1.0.4 — Minecraft 26.3
Raw-performance update for Fabric/Minecraft 26.3, focused on reducing repeated math cost, collision-query work, tick bursts, and allocation pressure.
New performance features
- Fast math LUTs: added a client-only, power-of-two sine/cosine lookup table and wired it into verified particle animation paths, including note, water-current, falling, and firework particles.
- Stationary collision caching: caches block collision-shape results for eligible stationary entities and invalidates the cache whenever a block state changes.
- Fluid tick governor: adds a configurable per-level fluid callback budget and reschedules overflow one tick later to flatten pathological water/lava bursts.
- Allocation reduction: reuses spatial-index candidate buffers during item and XP-orb merge scans instead of creating new candidate lists for every query.
- Configuration and documentation: exposes the new collision and fluid controls through Cloth Config and documents the behavior and safety boundaries.
Requirements
- Minecraft 26.3
- Fabric Loader 0.19.5+
- Fabric API
- Cloth Config API
- Sodium 0.9.2+
- Java 25+
Asset: chlorine-1.0.4.jar
Chlorine 1.0.3 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
## Chlorine 1.0.3 for Minecraft 26.3
Highlights
- Added a Sodium-aware workload governor for Sodium 0.9.2+.
- Samples Sodium's existing chunk-builder queue and worker occupancy at
RenderSectionManager.finalizeRenderLists(...). - Defers immediate terrain updates only when sustained low FPS, real builder backlog, and a stable camera indicate frame-time pressure.
- Added hysteresis and recovery thresholds to prevent rapid workload toggling.
- Added configuration controls for builder queue pressure, hysteresis duration, and recovery FPS.
- Added the Sodium GPU profile for Sodium's exposed fog occlusion, block-face culling, and visible-texture animation settings.
- Added time-budgeted item and XP-orb merging to reduce dense-farm tick spikes.
- Added adaptive sound and particle budgets for burst-heavy scenes.
Requirements
- Minecraft 26.3
- Fabric Loader 0.19.5 or newer
- Fabric API
- Cloth Config API
- Sodium 0.9.2 or newer (required)
- Java 25 or newer
Compatibility notes
- Chlorine does not replace Sodium's culler, builder, worker pool, or OpenGL renderer.
- Entity culling remains outside this feature; no additional entity-culling implementation was added.
- Performance gains depend on hardware, world, render settings, and workload. No universal FPS guarantee is claimed.
Validation
- Clean Gradle build passed against Minecraft 26.3 and Sodium 0.9.2.
- Client launch validation passed with Sodium on OpenGL 3.3 and an AMD Radeon RX 6500 XT.
Chlorine 1.0.2 Hotfix 1 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Hotfix for the Minecraft 26.3 release. Adds recommendations for the additional mods included in the Simply Optimized 26.3 pack. All recommended mods remain optional; only Fabric API and Cloth Config are required.
Chlorine 1.0.2 - Minecraft 26.3
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Stable Minecraft 26.3 release. This release contains only the Minecraft 26.3 build; the Minecraft 26.2 project remains archived as 1.0.0-26.2. Sodium and FerriteCore are not required dependencies.
Chlorine 1.0.2-pre1 - Minecraft 26.3 Alpha
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
Experimental Minecraft 26.3 alpha pre-release. Chlorine is in active development while simulation-distance behavior and Sodium compatibility fixes are being tested. Expect bugs and breaking changes; this is not a stable release. Sodium and FerriteCore are not bundled or required.
Chlorine 1.0.1
License: Chlorine is All Rights Reserved (ARR) as of November 2, 2026. See LICENSE. Copies downloaded before that date came with the license that was included at the time.
The version has been updated to 26.3.