Back to mods
Harium project artwork

Modrinth · Minecraft mod

Harium

A general-purpose optimization mod that rewrites inefficient vanilla code for AI, redstone, entities, hoppers, and physics without changing game behavior

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Harium release should I use?

Updated 3 months ago
Latest stable file 1.20.1
Game version 1.20.1
Loader Forge

Harium 1.20.1 targets 1.20.1 with Forge. Installation on the client is optional. Installation on the dedicated server is optional. No extra mods listed for this file.

Where it goes

Is Harium required on the client, server, or both?

Installation on the client is optional. Installation on the dedicated server is optional.

Client Optional
Dedicated server Optional
Loader for this release Forge
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source marks this as usable on both the client and server.

What else does Harium 1.20.1 need?

1.20.1. Change the file and its required mods may change too.

No extra mods listed for this file

This file does not list any required mods. Do not add a library just because a different file uses it.

This file does not list any required or optional mods.

Before you install it

Add Harium without breaking your instance.

Built for Harium 1.20.1. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use 1.20.1. It targets 1.20.1 with Forge; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    This file does not list any required mods. Do not add a library just because a different file uses it.

  3. 03

    Put it on the correct side

    Installation on the client is optional. Installation on the dedicated server is optional.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside 1.20.1. It opens that exact file at the source.

About this project

What does Harium add?

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

Project description from Modrinth.

Pick your setup

Harium by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

1 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Harium versions and loaders

1 of 1 releases match

Looking for an older file? The official Modrinth project page is in Resources.