Lithium Mod: Download and Install Guide (26.3)

Lithium: faster game logic for Minecraft 26.3, without changing vanilla

Lithium optimizes game physics, mob AI and block ticking without changing any vanilla mechanic. In my test it cut the time per tick by 45 percent in a pen with 768 mobs, and my full FPS benchmark shows why it won't give you more frames. What it does, how to set it up and fix conflicts, and how to install it on Minecraft 26.3.

October 5, 2026Updated Nov 196 min readby

Tested on Minecraft 26.3 (Fabric), Lithium 0.26.2, October 20, 2026, RTX 4070 Ti SUPER, test pen with 512 villagers and 256 cows. How I test

A fenced pen in Minecraft 26.3 packed with hundreds of villagers and cows in front of a hillside
Real in-game screenshot from my Lithium test on October 20, 2026: the pen with 512 villagers and 256 cows, Minecraft 26.3 with Lithium 0.26.2. The F3 line at the top was cropped off.

Sodium makes Minecraft draw faster, Lithium makes it think faster: it optimizes the systems the game runs every tick, without changing a single vanilla mechanic. In my test pen with 768 mobs, version 0.26.2 for Minecraft 26.3 cut the time per tick from 55.9 to 30.8 ms, while the frame rate stayed within the noise of my FPS test.

Lithium for Minecraft 26.3 title card 1:34

The short version

Lithium for Minecraft 26.3

Playing loads the video from YouTube (privacy-enhanced mode), which may set cookies and process your data. Details.

What Lithium does

Lithium is a general-purpose optimization mod by CaffeineMC, the team behind Sodium. It improves a number of systems such as game physics, mob AI and block ticking, with the strict goal of keeping exact vanilla behavior. That’s why it has even been officially allowed in Minecraft speedrunning.

  • Singleplayer: your game runs an internal server that ticks the world. Lithium optimizes that server, which frees up your processor and can mean a more responsive game.
  • Servers: the developers promise a sizeable improvement to tick times, so the same hardware can handle more loaded entities, chunks and players.
  • One side is enough: Lithium works on a server without players installing it, and on a client without the server having it.

My test results

I tested Lithium 0.26.2 on October 20, 2026 on Minecraft 26.3 with Fabric, in two ways.

Tick time. I fenced in 512 villagers and 256 cows in one pen (render distance 12, simulation distance 8) and read the vanilla command /tick query, which reports how long the game needs for one tick. Minecraft wants 20 ticks per second, so one tick may take 50 ms.

The setup, so you can rebuild it:

  • The pen: an oak fence of 37 by 25 blocks on a flat meadow in my world Valley of Mods.
  • The mobs: 512 villagers in a grid of 32 by 16, one block apart, and 256 cows next to them, all spawned with commands and kept from despawning. Their AI was on, so every one of them was thinking every tick.
  • The reading: /tick query in the chat, which averages the recent ticks and also gives the median (P50) and the slow ticks (P95).
  • Back to back: vanilla first, Lithium three minutes later, each in a fresh copy of the same world.
Average per tick P50 P95 Game status
Vanilla 55.9 ms 55.7 ms 72.9 ms can’t keep up with the target tick rate
Lithium 30.8 ms 31.3 ms 39.8 ms running normally

That’s 45 percent less time per tick. Vanilla fell behind 20 ticks per second, with Lithium the same pen ran with room to spare. The screenshots of both chat outputs are in the gallery below.

Frame rate. In my FPS mod test for 26.3 (RTX 4070 Ti SUPER, render distance 32) Lithium alone scored 200, 172, 185 and 274 FPS in the four scenes, against 207, 175, 194 and 275 in vanilla. All of that is inside the 5 percent noise of the test. Added on top of Sodium, it stayed close to Sodium alone.

Here is every run of that benchmark that involves Lithium, scene by scene. Each cell is the average FPS over the whole camera path, with the worst single second in brackets.

Scene Vanilla, run 1 Vanilla, run 2 Lithium Sodium Sodium + Lithium
Flight over the bay (20 s) 203 (159) 212 (170) 200 (154) 241 (167) 244 (173)
Meadow above a sealed vault with 1,024 villagers (15 s) 176 (158) 174 (153) 172 (148) 243 (200) 252 (216)
Red-leaf forest (15 s) 193 (149) 195 (150) 185 (125) 217 (131) 207 (35)
Empty sky (6 s) 278 (272) 271 (244) 274 (264) 346 (251) 368 (267)

How to read it:

  • The noise: the two vanilla runs, one at the start and one at the end of the session, differed by up to 5 percent in the same scene. Anything inside that range isn’t a real difference.
  • Lithium alone: between 0 and 5 percent below the vanilla average in every scene, so no gain and no loss I could measure.
  • Lithium on top of Sodium: +1, +4, -5 and +6 percent against Sodium alone: small, in both directions, and about the size of the noise. The 35 FPS worst second in the forest came from the game loading chunks at the end of the camera path in that one run, not from Lithium.
  • The conditions: October 20, 2026, Minecraft 26.3 on Fabric, Lithium 0.26.2, Sodium 0.9.2, render distance 32, simulation distance 8, no frame-rate limit, VSync off, the screen recorder running in every run.

So: Lithium is a mod for big farms, lots of mobs and servers, not for frames. It’s in A tier of my Minecraft 26.3 tier list.

Since my test: Lithium 0.26.3 (October 28) and 0.26.4 (November 19) came out for 26.3. Both changelogs say only that they fix several issues. All numbers on this page are from 0.26.2; I haven’t measured the newer versions yet.

Settings worth changing

None for normal play. The defaults are set up for the best performance the mod can offer, and an empty config file is perfectly normal.

The switches exist for fixing problems. They live in config/lithium.properties in your game folder (or on the server), in the Java properties format. Each line overrides one optimization by its name:

mixin.ai.pathing=false

That line turns off Lithium’s faster path-finding checks for mobs. Every option is listed with its default in the official configuration summary on GitHub. Two rules from the docs: back up your worlds before editing the file, and restart the game afterwards, because changes only take effect on start.

Compatibility

  • Loaders: Lithium for 26.3 (0.26.4 on November 19, 2026) is available for Fabric and Quilt (one file) and for NeoForge. No other mods are needed, not even Fabric API; the newer releases still list no dependencies on Modrinth.
  • Client, server or both: Modrinth lists it as optional on both sides.
  • Sodium: made by the same team for the other half of the job. They ran together in my FPS test.
  • Existing worlds: no new world needed.
  • Other mods: Lithium contains a large number of patches. The team writes that they rarely cause issues, mostly in combination with other mods, and every patch can be switched off on its own.
  • Older game versions: according to the support policy, 26.x is the current line on Fabric and NeoForge, with long-term support for 1.21.11, 1.21.1 and (Fabric only) 1.20.1.

Troubleshooting

  • A mod clashes with Lithium: find the matching option in the configuration summary, set it to false in config/lithium.properties, restart. The team asks you to narrow issues down this way and then report them on the issue tracker.
  • A farm or contraption behaves differently: a small group of options under mixin.minimal_nonvanilla technically deviates from vanilla but must not affect gameplay or contraptions. If one of them does, the team treats it as a bug and wants a report on the issue tracker.
  • The config file is empty: that’s normal. It only holds your overrides.
  • No more FPS after installing: expected, see my test above. For frames install Sodium, for hidden mobs Entity Culling.

Alternatives

There’s no second mod in my tests that does the same job on 26.3. Related mods do other things:

  • FerriteCore saves memory. In my memory test it made no measurable difference, neither in vanilla nor with 14 content mods.
  • C2ME, ModernFix and Noisium are popular on older versions. When I checked Modrinth on October 20, 2026, C2ME had only an alpha for 26.3, and ModernFix and Noisium had no 26.3 version at all.
  • Sodium is the partner mod for rendering, Entity Culling skips mobs you can’t see.

How to install Lithium

  1. Install your mod loader for Minecraft 26.3: Fabric, Quilt or NeoForge.
  2. Download Lithium for 26.3 from Modrinth, filtered by your loader. It needs no other mods.
  3. Put it into your mods folder, or into the server’s mods folder.

Step by step, with fixes for the common errors: How to install Fabric mods in Minecraft 26.3.

Verdict

Lithium is for servers, big farms, mob-heavy worlds and anyone who plays with a lot of entities.

  • Pro: cut the tick time by 45 percent in my 768-mob pen.
  • Pro: keeps vanilla behavior, even allowed in speedruns.
  • Pro: no dependencies, works on one side or both.
  • Con: no FPS gain in my benchmark. It doesn’t replace Sodium.
  • Con: fixing a conflict means editing a text file and restarting the game.

FAQ

Is Lithium available for Minecraft 26.3?

Yes. The newest release for Minecraft 26.3 is 0.26.4 (November 19, 2026), on Fabric and Quilt and on NeoForge. I tested 0.26.2 from September 28.

Does Lithium change how the game works?

No. Its strict goal is to keep exact vanilla behavior, which makes it suitable even for highly complex gameplay scenarios and creations. It has even been officially allowed in Minecraft speedrunning.

Does Lithium give me more FPS?

Not in my test. Lithium on its own stayed within 5 percent of vanilla in all four scenes of my FPS benchmark. It makes the game think faster, not draw faster. For frames, install Sodium.

How much does Lithium help with lots of mobs?

In my test pen with 512 villagers and 256 cows the average time per tick dropped from 55.9 ms in vanilla to 30.8 ms with Lithium, 45 percent less. Vanilla couldn’t hold 20 ticks per second there, with Lithium the game reported that it was running normally.

Do players need Lithium if the server has it?

No. Lithium can be installed on a server without clients having it, and the other way round.

Does Lithium need Fabric API?

No. The 26.3 versions have no dependencies, just your mod loader.

Do I need a new world for Lithium?

No. The developers say you don’t need to create new worlds to take advantage of it.

A mod conflicts with Lithium. What can I do?

Switch off the single optimization that clashes in config/lithium.properties instead of removing the whole mod, then restart the game. An empty config file is normal and means the defaults are active.

Sources

What changed

  • Added the full test setup of my tick test, every scene of my FPS benchmark with the worst second, Lithium against Sodium plus Lithium, and the releases since my test.
  • Added my tick-time and FPS results, real in-game screenshots, the config file, compatibility notes, troubleshooting and alternatives.
  • First published.