How to Fix Mods Not Loading in Minecraft

The Problem

Mod list shows 0 mods loaded
Items/blocks from the mod do not appear in-game
No error in logs, but the mod is not active

You placed a mod file in the mods folder, but it does not appear in the mod list or its content is missing from the game. This is almost always a placement, version, or mod loader issue. The mod itself is usually fine.

Quick Fix

Verify three things: (1) the mod .jar file is in .minecraft/mods/, not in a subfolder; (2) the mod version matches your Minecraft version exactly; (3) you are using the correct mod loader (Forge or Fabric) for the mod.

Step-by-Step Diagnosis

1. Check the mods folder location. The mod .jar file must be directly inside .minecraft/mods/. Not in a subfolder, not in .minecraft/mods/1.21/, not in a zip file. Just the raw .jar file in the mods folder.
2. Verify file extension. The file must end in .jar, not .jar.zip or .jar (1). Some browsers add extensions or modify filenames during download. Rename if necessary.
3. Match the Minecraft version. A mod built for 1.20.4 usually does not work on 1.21. Check the mod's download page for the version that matches your Minecraft version exactly.
4. Match the mod loader. Forge mods do not work on Fabric and vice versa. Check the mod's page to see which loader it supports. Some mods (like JEI/REI) have separate downloads for each loader.
5. Check for required dependencies. Many mods require library mods. For Fabric, most mods need Fabric API. For Forge, some mods need specific library mods like GeckoLib or Architectury. The mod's page lists its dependencies.
6. Read the log file. Open .minecraft/logs/latest.log and search for the mod's name. If the mod loader detected it but failed to load it, the reason will be logged (wrong version, missing dependency, etc.).
7. Check the mod list in-game. On Fabric, press the Mods button on the main menu (requires Mod Menu mod). On Forge, click "Mods" on the main menu. Search for your mod by name.

Common Causes

• Wrong mod loader. Forge mods have a mods.toml inside the jar. Fabric mods have a fabric.mod.json. They are not interchangeable.
• Version mismatch. Mods are compiled against a specific Minecraft version. Even minor version differences (1.21.1 vs 1.21.4) can prevent loading.
• Missing Fabric API. Fabric mods almost universally require the Fabric API mod. Download it separately from Modrinth or CurseForge and place it in the mods folder.
• File corruption. Interrupted downloads produce corrupt .jar files. Re-download the mod from the official source and verify the file size matches.
• Client-side vs server-side mod. Some mods are server-only and do not appear on the client. Others are client-only and will not load on a dedicated server. Check the mod's documentation for compatibility.

FAQ

How do I know if a mod is for Forge or Fabric?

The mod's download page always specifies the loader. On Modrinth, look for the "Loaders" field. On CurseForge, the filename usually includes "forge" or "fabric".

Can I use Forge and Fabric mods together?

Not directly. Projects like Sinytra Connector attempt to load Forge mods on Fabric, but compatibility is limited. Choose one loader and use mods made for it.

My mod loaded but items are missing. Why?

The mod might have loaded but encountered an error registering its content. Check the log for warnings or errors from the mod. Also verify that all dependencies are present and up to date.

Do I need to restart the game after adding a mod?

Yes. Mods are loaded during game startup. You cannot hot-load a mod while the game is running. Place the jar in the mods folder, then start (or restart) the game.

Server-Side vs Client-Side Mods

Mods fall into three categories for multiplayer:

• Client-only: Mods like Sodium, Iris, and minimaps run only on the client. They do not need to be on the server and will not load on a dedicated server. If you place a client-only mod in a server's mods folder, the mod loader either ignores it or logs a warning.
• Server-only: Mods like server-side performance optimizations run only on the server. Players do not need them installed.
• Both sides required: Mods that add blocks, items, or entities (like Create, Mekanism, etc.) must be installed on both the client and server with matching versions. If the client has the mod but the server does not (or vice versa), you either cannot connect or experience missing content.

Check the mod's documentation page for its "environment" or "side" requirement. Modrinth labels mods as "client", "server", or "both".

Need a server that handles all this? Astroworld Hosting, NVMe SSDs, Pterodactyl panel, DDoS protection on every plan.