Troubleshoot When Icons Aren't Updating

Common Causes of Icon Update Failures

If your custom icons aren't appearing when you join worlds or servers, check these common issues:

Filename Mismatch: The icon filename must match your world or server name exactly, including capitalization. Verify the precise name by checking your world list or server connection details.

Wrong File Format: Ensure all icon files are in PNG format. Other image formats won't be recognized by the mod.

Incorrect Folder Location: Confirm icons are placed in the mod's designated configuration folder. Check the mod's config file or documentation for the exact path on your system.

Verification Steps

1. Close Minecraft completely

2. Double-check icon filenames against your world/server names

3. Verify file format is PNG

4. Confirm folder location matches mod requirements

5. Restart Minecraft and rejoin the world

Reloading Configuration

Some mod configurations require a full game restart to recognize new icons. If you've recently added icons, completely close and relaunch Minecraft rather than just reloading worlds. The icon should update upon joining.