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.

Harium - Maintained by Hari - High Performance Minecraft