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 fileNeoForge 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 loadedNeoForge’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.
Common causes
Section titled “Common causes”- A mod for another loader. Fabric and Quilt mods have
fabric.mod.jsonorquilt.mod.jsoninstead. 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 shipsMETA-INF/mods.tomlisn’t found (NeoForge: mod files). Rename the file insrc/main/resources/META-INF(or insrc/main/templates/META-INFin 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.
Check a jar
Section titled “Check a jar”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.
In Linen
Section titled “In Linen”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.