Troubleshooting

Troubleshooting

Nothing seems to be getting filled in

• Give it a few seconds after opening the Mods screen — lookups happen in the background and need a moment, especially the first time (results are cached afterward).
• Check config/modmenuwebaddon.json — make sure "enabled": true and the relevant fillMissing* flags are true.
• Some mods are skipped on purpose (see below) — that's expected, not a bug.
• If a mod was already looked up and cached (even with no result), it won't be retried until cacheTtlHours has passed. Delete config/modmenuwebaddon/cache.json to force a re-check.

A mod is missing info even though it's clearly not a library

The addon deliberately skips:

• minecraft, java, and the addon's own id.
• Anything with Fabric Loader type builtin.
• Fabric API's many sub-modules (they're already grouped under one "Fabric API" entry in Mod Menu, so there's nothing useful to fill in individually).
• Jar-in-jar nested mods (mods bundled inside another mod's jar) and known loader-internal pseudo-mods like mixinextras/fabricloader — these aren't independently published projects, and guessing at a match for them by name tends to attach wrong data (see below).

If a real, independently-published mod isn't getting filled in, it likely means neither Modrinth nor (if enabled) CurseForge could find a confident match for it — the addon intentionally does not attach a guess when it isn't reasonably sure, to avoid showing wrong information.

CurseForge results aren't showing up

• useCurseForge must be true and curseForgeApiKey must be a valid key from console.curseforge.com. See Configuration.
• CurseForge is only queried as a fallback for whatever Modrinth didn't already find.

Why is the icon still missing?

Only PNG icons that come back square are used (matching Mod Menu's own icon requirement). If a project's icon fails that check, or the download fails, no icon is set rather than showing a broken texture.