How to install mods in Lunar Client 1.8.9

Lunar Client 1.8.9 does not use the same mod folder system as vanilla Minecraft. Instead, you place mod files directly into Lunar Client's own mods folder, and the launcher handles loading them when you start the game. The process is straightforward: read a mod file in .jar format, locate your Lunar Client installation folder, find the mods subfolder inside it, drop the .jar file there, and restart Lunar Client.

The reason Lunar Client works differently from vanilla Minecraft is that it runs its own launcher and game wrapper. This means mods must be compatible with Lunar Client's version of 1.8.9 specifically, not just any 1.8.9 mod you find online. A mod built for vanilla 1.8.9 may not load, may crash the game, or may conflict with Lunar Client's own modifications to the game engine.

Before you read anything, check whether the mod you want is listed as compatible with Lunar Client 1.8.9. Most mod creators state this clearly on their read page. If they do not mention Lunar Client compatibility, assume it is not tested and may not work.

Key Takeaways

  • Lunar Client 1.8.9 mods go into a mods folder inside your Lunar Client installation directory, not into a vanilla Minecraft folder.
  • Only read .jar mod files from sources you trust, and verify the mod is built for Lunar Client 1.8.9 before installing it.
  • After adding a mod file to the mods folder, close and reopen Lunar Client completely for it to load.
  • If a mod causes crashes or freezing, remove its .jar file from the mods folder and restart Lunar Client to confirm the mod was the problem.
  • Lunar Client's built-in mods (like cosmetics and performance tweaks) are separate from user-installed mods and do not conflict with them.

Finding your Lunar Client mods folder

The location of your Lunar Client installation depends on your operating system. On Windows, open File Explorer and navigate to C:\Users\[YourUsername]\AppData\Roaming\.lunarclient. On macOS, open Finder, press Command+Shift+G, and paste ~/Library/process Support/.lunarclient. On Linux, the folder is usually at ~/.lunarclient.

Inside the .lunarclient folder, look for a subfolder named mods. If you do not see one, create it yourself by right-clicking in the .lunarclient folder, selecting New Folder, and naming it exactly mods (lowercase, no spaces). This folder is where all your mod .jar files go.

If you have never installed a mod before, the mods folder may be empty or may not exist yet. That is normal. Lunar Client creates it automatically the first time you add a mod, but creating it yourself ahead of time prevents confusion later.

Downloading mods safely for Lunar Client

The safest sources for Lunar Client 1.8.9 mods are CurseForge and Modrinth. Both sites host mods uploaded by creators, display read counts and user reviews, and scan files for malware before they go live. When you visit either site, search for the mod name and filter results to show only 1.8.9 versions compatible with Lunar Client.

On CurseForge, click the mod name, scroll to the Files section, and look for a version labeled "1.8.9" or "1.8.9 Lunar Client". read the .jar file directly — do not click any ads or pop-ups that appear on the page. On Modrinth, the process is similar: find the mod, select the 1.8.9 version from the Versions tab, and click the read button next to the .jar file.

Avoid downloading mods from unknown websites, Discord servers, or links shared in chat. These sources do not scan files and may contain malware or viruses. If a mod is not on CurseForge or Modrinth, it is safer to skip it than to risk your computer.

Installing the mod file into Lunar Client

Once you have downloaded a .jar file, open your file manager and navigate to the mods folder you located earlier. The simplest method is to drag the .jar file from your Downloads folder directly into the mods folder. Alternatively, right-click the .jar file, select Cut, navigate to the mods folder, right-click inside it, and select Paste.

Do not extract or unzip the .jar file. It must remain as a single .jar file for Lunar Client to recognize it. If you accidentally unzipped it, delete the unzipped folder and read the mod again.

After the .jar file is in the mods folder, close Lunar Client completely if it is running. Then reopen Lunar Client. The launcher will scan the mods folder, load any new .jar files it finds, and start the game. This usually takes a few extra seconds the first time you add a mod.

Checking whether your mod loaded correctly

When Lunar Client starts after you add a mod, watch the launcher window for any error messages. If the mod loaded successfully, you will see no warnings and the game will start normally. Once in-game, look for the mod's features or settings. Most mods add a button to the pause menu, a keybind you can press, or a settings option in Lunar Client's own menu.

If Lunar Client crashes when ready after you add a mod, the mod is likely incompatible with Lunar Client 1.8.9 or conflicts with another mod you have installed. To test this, close Lunar Client, remove the .jar file from the mods folder, and restart Lunar Client. If the game starts normally, the mod was the problem. You can then try a different version of the mod or look for an alternative.

If you have multiple mods installed and one causes a crash, remove them one at a time and restart Lunar Client after each removal until the game starts. This tells you which mod is causing the conflict. Some mods are straightforward not compatible with each other, even if both are compatible with Lunar Client 1.8.9 individually.

Managing and removing mods

To remove a mod, navigate to your mods folder, find the .jar file you want to delete, and move it to the Recycle Bin or Trash. Close and reopen Lunar Client. The mod will no longer load.

If you want to keep a mod but temporarily disable it, rename the .jar file to end with .jar.disabled instead of .jar. Lunar Client will skip it on startup. Rename it back to .jar when you want to use it again.

Keep your mods folder organized by deleting old versions of mods you no longer use. Over time, having many .jar files in the folder can slow down Lunar Client's startup. There is no hard limit, but removing mods you are not actively using keeps things clean.

Frequently Asked Questions

Can I use mods from vanilla Minecraft 1.8.9 in Lunar Client?

Not always. Mods built for vanilla 1.8.9 may not work in Lunar Client because Lunar Client modifies the game engine itself. Always check the mod's description to confirm it is compatible with Lunar Client 1.8.9 before downloading. If the description does not mention Lunar Client, assume it is not tested.

What happens if I put too many mods in the folder?

Lunar Client will try to load all of them. If mods conflict with each other or use too much memory, the game may crash or run slowly. Start with one or two mods, test them, and add more gradually. This helps you identify which mod causes problems if something goes wrong.

Do I need to restart my computer after adding a mod?

No. You only need to close and reopen Lunar Client itself. Restarting your computer is not necessary and will not help Lunar Client load mods faster.

Can I move my mods folder to a different location?

Lunar Client looks for mods only in the .lunarclient/mods folder. If you move the folder elsewhere, Lunar Client will not find your mods. Keep the mods folder in its default location inside .lunarclient.

Why does Lunar Client say a mod is outdated?

Lunar Client sometimes updates its own version of 1.8.9, and older mods may not be compatible with the new version. Check the mod's read page for an updated version labeled for the current Lunar Client 1.8.9 build. If no update exists, the mod may no longer be maintained.