Skip to content

Fix "Mod file ... is missing mods.toml file"

Forge reads a mod’s details from META-INF/mods.toml inside its jar. When a jar in the mods folder has none, Forge logs:

Mod file examplemod-fabric-1.0.0.jar is missing mods.toml file

NeoForge reads META-INF/neoforge.mods.toml (since 1.20.5) and words it differently. It skips the jar with a warning and starts without it. With a Fabric jar in the mods folder, a NeoForge 1.21.1 server logs:

[main/WARN] [ne.ne.fm.lo.mo.ModDiscoverer/SCAN]: Skipping jar. File ...\mods\examplemod-fabric-1.0.0.jar is a Fabric mod and cannot be loaded

NeoForge’s loader has a few variants of that line. It says a file is for Minecraft Forge or an older version of NeoForge, is a Bukkit or Bukkit-implementor (Spigot, Paper, etc.) plugin, is not a jar file, or, when it can’t tell, is not a valid mod file.

Checked on 19 November 2026: the NeoForge line comes from a NeoForge 1.21.1 server with a Fabric mod’s jar in its mods folder, the variants from NeoForge’s loader 4.0.45, and the Forge line from Forge’s loader for 1.18.2 to 26.3.

  • A mod for another loader. Fabric and Quilt mods have fabric.mod.json or quilt.mod.json instead. Download the NeoForge or Forge build of that mod.
  • A library, not a mod. Some downloads are plain Java libraries meant to be inside another mod. Remove it unless the mod’s page says to install it.
  • Your own mod after a port to NeoForge 1.20.5 or newer. Since then, NeoForge reads META-INF/neoforge.mods.toml, and a mod that still ships META-INF/mods.toml isn’t found (NeoForge: mod files). Rename the file in src/main/resources/META-INF (or in src/main/templates/META-INF in the newer MDKs) and rebuild.
  • A damaged download. If the jar is the right one, delete it and download it again.

On NeoForge the game still starts without the skipped jar. Search the log for Skipping jar to find every jar it left out.

A jar is a zip file. Open it and look in META-INF: neoforge.mods.toml for NeoForge 1.20.5 and newer, mods.toml for Forge and older NeoForge. At the top level, fabric.mod.json means it’s a Fabric mod.

Crash Doctor in Linen reads the crash report and the log next to it, then names the mod, the line and what to change. It’s free. To make one mod for both loaders, see share code between Fabric and NeoForge.