Lithium Mod: Install, Loaders, and Safe Performance Testing

Minecraft Java performance mod

Lithium optimizes Minecraft game logic; it is not a shader, texture pack, or graphics driver. Install the build that matches both your Minecraft version and mod loader, then test a copied world under the same conditions. A higher FPS counter alone does not prove Lithium is working because its main target is simulation work such as entity, block, and world logic.

Choose a Lithium version on Modrinth

Download Lithium 0.25.3 for Minecraft 26.2

MineBrush attached the unmodified creator-published release files downloaded from Modrinth. Choose only the loader used by your profile. The LGPL license is included beside the files; the creator versions page remains the authority for newer or older builds.

Choose the right Lithium file

Install Lithium without mixing profiles

1. Close Minecraft and your launcher.
2. Open the instance that contains the matching Fabric or NeoForge loader. Do not use the global game folder if your launcher keeps separate instances.
3. Place the single Lithium .jar in that instance's mods folder. Do not unzip it.
4. Start the same loader profile and confirm Lithium appears in the latest log or your loader's mod list.
5. Open a copy of a known world before touching the only save you care about.

For a dedicated server, stop the server before changing the mods folder and keep the previous jar outside that folder. The official Lithium repository says clients are not required to install Lithium simply because the server uses it, but every wider modpack still needs its own compatibility test.

What Lithium can improve — and what it does not promise

Lithium is built to reduce the cost of game-logic work while preserving vanilla behavior. That can matter when a world is busy with entities, block updates, chunk activity, redstone, farms, or server ticks. It does not replace Sodium, a GPU driver, more RAM, a faster network connection, or a fix for a broken mod.

• Good measurement: the same world copy, route, entity count, render settings, view distance, Java build, JVM flags, and warm-up time.
• Useful server signal: tick time or MSPT during a repeatable workload, not only the player FPS counter.
• Useful client signal: frame-time consistency while the same simulation is running, alongside the game log.
• Weak evidence: one screenshot taken in different locations or immediately after startup.

A 10-minute stability test

1. Back up the profile and world.
2. Run the baseline without Lithium and record startup, memory, frame-time or tick-time observations.
3. Add only Lithium and repeat the same route.
4. Exercise redstone clocks, mob farms, portals, chunk borders, scheduled block ticks, saving, quitting, and reopening.
5. Check the log for mixin, loader, or compatibility warnings before adding another optimization mod.

If Minecraft crashes after adding Lithium

• Confirm the jar matches the loader and Minecraft version shown in the launcher profile.
• Remove duplicate Lithium jars and old versions from the same mods folder.
• Test Lithium alone with the loader, then restore other mods in small groups.
• Read the first meaningful error in latest.log or the crash report; the last mod name on screen is not always the cause.
• Reproduce the issue without Lithium in the same world copy before reporting a compatibility bug.

Update or remove Lithium safely

Stop the game or server, back up the world and configuration, remove the old Lithium jar, and add one matching replacement. If you roll back, restore the known-good jar and repeat the save/restart test. Never keep two Lithium versions active at the same time.

Bottom line

Use Lithium when game-logic performance is the problem and you can test it with a repeatable workload. Match Minecraft and loader first, change one component at a time, and keep the previous profile ready. MineBrush verified the creator-controlled release information but did not run every modpack, server, world, or hardware combination.

Sources checked

• Lithium versions on Modrinth
• CaffeineMC Lithium repository and installation notes
• Lithium support policy