Modrinth · Fabric, NeoForge, Quilt

Lithium on your Minecraft server

Lithium runs on Minecraft servers with Fabric or NeoForge or Quilt. Order your server, set the loader in the panel and install the mod with one click in the mod browser.

No-compromises game logic optimization mod, useful for both single-player games and multi-player servers.

Downloads
145.6M
Author
jellysquid3
Loader
Fabric, NeoForge, Quilt
Minecraft
1.16.2 – 26.3
Updated
–

Setup

Install Lithium on your server

The server and players need the same loader and Minecraft version. Back up the world before adding or updating mods.

  1. 01

    Configure

    4 GB of RAM is preselected. You choose the term and add-ons and pay by credit card or PayPal.

  2. 02

    Set the loader

    In the panel, set the server software to Fabric or NeoForge or Quilt and choose the matching Minecraft version, for example 26.3.

  3. 03

    Install the mod

    Search the mod browser for “Lithium” and install the release for your loader. Alternatively, upload the .jar to the mods folder via SFTP. Required dependencies are listed on the project page.

  4. 04

    Connect

    Lithium is optional on the client. Players connect using the server address from the panel.

On the server
Optional
On the client
Optional
Loader
Fabric, NeoForge, Quilt
Minecraft
26.3, 26.2, 26.1.2 +35 more
License
GNU Lesser General Public License v3.0 only

Known issues

  • Lithium is Fabric/Quilt only – for Forge use "Radium" (unofficial port) instead.

The panel

Install mods, find errors.

Real screenshots from the Mado panel. Both come with every Minecraft server.

Mod browser

Modrinth and CurseForge, right in the panel.

The browser filters by your Minecraft version. Install mods with one click, without uploading .jar files.

Browser in the Mado panel with search, a CurseForge or Modrinth source switch and install buttons.

AI crash analysis

When a mod crashes, the analyzer reads the log.

Mods often fail on a wrong loader version, Java version or missing dependency. The analyzer names a likely cause and suggests a fix.

Optimization page in the Mado panel with the AI Log Analyzer enabled and a “Server Crashed” notice with an “Analyze Now” button.

Releases

Published releases

Pick the file that matches your server’s loader and Minecraft version. The server and players need the same release.

Lithium · Modrinth
Original description by the project author

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.

FAQ

Lithium questions

Question not listed? Ask our team.

Lithium + Starlight + FerriteCore together – does it work without conflicts?

Yes, Lithium, Starlight, and FerriteCore are specifically designed to work together. Lithium optimizes game logic (pathfinding, tick scheduling), Starlight the lighting system, FerriteCore the RAM usage. All three together can improve server performance by 30-50%. For Fabric servers on Mado Hosting, we recommend all three as a standard setup.

Lithium server crashes on startup – what to do?

Common causes: the loader or Minecraft version does not match the mod file, a dependency is missing, or RAM is too low. Check the log (latest.log) for “OutOfMemoryError”, “Mixin” or missing mods. At Mado, the AI crash analysis reads the log and suggests a cause. You can change the loader and version in the panel.

Ready for your server with Lithium?

4 GB of RAM from €8.00 per month. 35% off your first month with MADO35.

Order server