Harium | General Purpose Optimization

Smart Performance Through Intelligent Code Replacement

What Is Harium

Harium is a general-purpose optimization mod (based on Lithium) that rewrites inefficient vanilla code with faster, smarter implementations — without changing game behavior.

Same Game. Better Performance.

Harium targets the most CPU-intensive systems in Minecraft: entity processing, redstone, AI, hoppers, and physics — replacing slow algorithms with optimized alternatives that produce identical results.

Optimization Categories

Each category can be individually enabled or disabled.

• AI & Pathfinding: Faster block type lookups, optimized POI searches, removed useless behaviors
• Entity System: Section-based movement tracking, optimized collision detection, smarter item merging
• Block & Redstone: Optimized redstone wire power calculations, BlockEntity sleeping for inactive tiles
• Hopper & Inventory: Event-driven hopper logic with caching — hoppers only scan when inventories actually change
• Memory Allocations: Eliminates unnecessary object creation in hot code paths using FastUtil collections
• VoxelShapes: Specialized shape implementations for faster collision detection and ray tracing
• Collections: Replaces standard Java collections with optimized FastUtil alternatives throughout

Key Technical Approaches

• Event-Driven Architecture: Block sections notify listeners only when changes occur, instead of polling every tick
• Caching Layers: Multiple levels of caching for block states, entity positions, and inventory contents
• Smart Iteration: Chunk-ordered entity iteration for better CPU cache locality and early termination
• Reduced Locking: Array-based data tracker entries instead of synchronized maps

Fork Information

Harium is a fork of Lithium by jellysquid3.

Compatible: Designed to be fully compatible with vanilla behavior. No gameplay changes.

Credits & Support

Original Lithium created by jellysquid3 and maintained by the community.

Harium extends the optimization coverage with additional improvements.

Join the Community

Get help and updates on our Discord.

JOIN DISCORD

Harium - Maintained by Hari - High Performance Minecraft