
Lithium
jellysquid3
144,791,675 downloads · 24,389 followers
Minecraft: Minecraft 1.16.2 – 26.3
Runs on: Client & server
Category: optimization
Compatibility by loader
- fabric1.16 – 1.21, 26.1 – 26.3· Latest mc26.3-0.26.4-fabric (Nov 19, 2026)
- quilt1.20 – 1.21, 26.1 – 26.3· Latest mc26.3-0.26.4-fabric (Nov 19, 2026)
- neoforge1.21 – 1.21.11, 26.1 – 26.3· Latest mc26.3-0.26.4-neoforge (Nov 19, 2026)
Overview
Lithium is a modern, general-purpose optimization mod for Minecraft which works to improve a number of systems (game physics, mob AI, block ticking, etc) with the goal of not changing any vanilla mechanics.
The mod works on both the client and server, and can be installed on servers without requiring clients to also have the mod (and vice versa.)
For multiplayer servers, administrators can expect a sizeable improvement to tick times, allowing their hardware to support more loaded entities, chunks, and players. Even in single-player, Lithium helps to improve performance by optimizing the internal game server, which is used for "ticking" the world. This can free up your computer's processor to focus on other tasks, resulting in improved frame rates and increased responsiveness.
The strict goal of maintaining exact behavior with vanilla makes Lithium suitable for almost any Minecraft server running Fabric, even for highly complex gameplay scenarios and creations. In fact, our continued insistence towards not changing vanilla gameplay has even led to the mod being officially allowed in Minecraft speedrunning.
Installation
Make sure you have the latest version of Fabric Loader present and then simply drop the mod into your mods folder. No other mods or additional setup (not even Fabric API!) is required. You do not need to create new worlds in order to take advantage of the mod.
While you're at it, you may want to check out Sodium, which improves rendering performance.
Configuration
Lithium makes use of an semi-unusual configuration system which allows you to enable or completely disable patches the mod applies. This system allows fine-grained control over what code in Minecraft is modified by Lithium, and as such, can be used to completely eliminate bugs or mod incompatibilities introduced by the mod.
For more information, please read the wiki entry on modifying your configuration file.
Please note: An empty configuration file is perfectly normal and just means you want to use the default options, which are already set up out of the box for the best performance the mod can offer.
Reporting Issues
Please use the issue tracker linked at the top of the page to report bugs, crashes, and other issues.
AI-summarized from the mod's own pages · reviewed by our team
Reviewed for mc26.3-0.26.3-neoforge
Source: Modrinth project pageGuide
Summary
Lithium improves the performance of Minecraft’s game logic while aiming to preserve vanilla behavior. It can help in single-player worlds and on multiplayer servers, without requiring everyone on a server to install it.
Getting started
- Install on Fabric — Install the latest Fabric Loader, then place Lithium in the mods folder. The Fabric installation described by the project needs no additional mods, including Fabric API.
- Back up and play — Back up your world before using the mod. You can continue playing an existing world; there is no need to start a new one.
- Choose where to install it — Lithium can run on a client, a server, or both. A server can use it without requiring players to install it, and players can use it without the server having it.
Key features
World logic optimization
Lithium optimizes systems such as physics, mob AI, and block ticking. Its goal is to improve performance without changing vanilla mechanics.
Single-player performance
Single-player worlds use an internal server to tick the world. Optimizing that work can free processor time and improve frame rates or responsiveness.
Server tick performance
Server administrators may see improved tick times, giving their hardware more capacity for loaded chunks, entities, and players. The sources do not provide a guaranteed performance gain.
Adjustable patches
Lithium has a configuration system for enabling or disabling individual patches. An empty configuration file is normal and uses the default options.
Compatibility
Fabric, NeoForge · The supplied changelog lists Fabric and NeoForge releases for Minecraft 26.3.x. A complete version-to-loader compatibility list is not provided.
Tips
- If you encounter a bug or mod conflict, Lithium’s configuration system can disable the relevant optimization, though the supplied sources do not give specific settings.
- Report crashes, bugs, and compatibility problems through the project’s issue tracker.
- The NeoForge 0.26.2 changelog reports a fix for a compatibility issue with Streams Reflowing; it does not establish compatibility for every release.
FAQ
- Will Lithium change how my world works?
- Its stated goal is to retain vanilla behavior exactly, including in complex creations. Bugs are still possible, so keep a backup and report unexpected behavior.
- Do other players need Lithium?
- No. A server can use Lithium without requiring clients to install it, and a client can use it when the server does not.
Modrinth modrinth
indexable