Back to 9Minecraft
Wiki 9Minecraft Wiki 9Minecraft

Lithium Mod FAQ

20 questions players actually ask, answered.

How do I know if Lithium is actually working?
Check your game's log or mod list to confirm it loaded, then compare your FPS and CPU usage before and after enabling it. Lithium doesn't add a visible HUD or menu, so the difference shows up as smoother performance rather than a new screen.
Does Lithium change anything about my world or gameplay?
No, Lithium only changes how the game calculates things under the hood, so blocks, mobs, and mechanics behave the same. It's designed to be a drop-in optimization that doesn't alter vanilla behavior.
Where is the Lithium config file and what can I change in it?
The config file is generated in your Minecraft config folder after the mod runs once. It lets you toggle individual optimizations on or off, which is useful when a specific tweak breaks compatibility with another mod.
Which optimizations should I turn off if another mod breaks?
Disable categories one at a time, starting with the area the broken mod touches, such as physics, mob AI, or redstone. Restarting between changes helps you pinpoint exactly which optimization is causing the conflict.
Will Lithium conflict with other performance mods like Sodium or Phosphor?
Lithium is generally designed to work alongside other optimization mods because it targets different systems, like server-side logic rather than rendering. If you hit issues, check the config toggles and make sure you're not running two mods that optimize the exact same thing.
Can I use Lithium on a server, and do clients need it too?
Yes, Lithium works on servers and can improve TPS and reduce lag independently of clients. Clients don't need it installed to join, but having it on both sides gives the best overall performance.
Why did my mob farm or redstone contraption stop working after installing Lithium?
Lithium optimizes mob AI and redstone calculations, which can occasionally change timing-sensitive behavior. Try disabling the mob AI or redstone optimization in the config to see if that restores your farm's expected output.
Does Lithium improve chunk loading and reduce stuttering?
Yes, chunk loading is one of the areas Lithium optimizes, which can reduce stutter when moving through the world. The effect is most noticeable on servers or in areas with lots of entities and blocks loading at once.
My game crashes on startup after adding Lithium — what should I do?
Check the crash log to see which mod or optimization is involved, then try disabling specific Lithium optimizations in the config. Conflicts usually come from another mod touching the same systems, so updating or removing that mod often fixes it.
Do I need to configure Lithium to get better FPS, or does it work automatically?
Lithium applies its optimizations automatically once installed, so no setup is required for a basic performance boost. You only need to open the config if you want to fine-tune compatibility or disable specific optimizations.
What does Lithium Mod do?
Lithium is a general-purpose optimization mod that rewrites parts of Minecraft's game logic — physics, mob AI, chunk loading, mob farms, and redstone — to run faster without changing vanilla behavior. It works on both the client and the server, so you can install it on either side or both.
How do I use Lithium Mod after installing it?
You don't need to do anything — once the mod is loaded, its optimizations apply automatically with no in-game commands or setup. Just launch the game and play as normal.
How do I know if Lithium Mod is actually working?
Compare your frame rate and tick times with and without the mod under the same conditions, since Lithium doesn't add any visible UI or on-screen indicator. If your world loads faster and mob-heavy or redstone-heavy areas stutter less, it's doing its job.
Does Lithium Mod work on Minecraft Bedrock or pocket edition?
No. Lithium is built for Minecraft Java Edition only and cannot be used on Bedrock, Pocket Edition, or console versions. Bedrock has its own separate optimization options and doesn't support Java mods.
Can I use Lithium Mod on a server?
Yes, Lithium is designed to run server-side and improves tick performance for everyone connected. You can install it on both the server and the client for the best results, but the server-side install alone benefits all players.
Do other players need Lithium Mod installed to join my server?
No. Lithium is not required on the client for players to connect, and vanilla clients can join a Lithium server without issues. Client-side installation only helps that individual player's own performance.
Will Lithium Mod break my other mods?
It's generally compatible with most mods, but conflicts can happen with mods that heavily rewrite the same systems Lithium optimizes, like some redstone or mob AI mods. If you notice odd behavior, disable the specific optimization in Lithium's config file rather than removing the mod entirely.
How do I disable a specific lithium optimization?
Open Lithium's configuration file and turn off the individual optimization category that's causing trouble, such as physics or mob AI. This lets you keep most of the performance gains while restoring compatibility with the conflicting mod.
Does Lithium Mod change vanilla behavior or gameplay?
No, Lithium is designed to preserve vanilla mechanics exactly — it only changes how the game calculates things internally, not the outcomes. Redstone circuits, mob behavior, and physics should behave the same as in unmodded Minecraft.
Why am I not seeing a performance boost from Lithium Mod?
Lithium helps most in CPU-bound situations like large mob farms, heavy redstone, or many loaded chunks, so a small or idle world may show little difference. If your bottleneck is your GPU or render distance rather than CPU load, Lithium won't help much there.