Minecraft Resource Pack Not Working? Fix It (26.3)

Written for Minecraft 26.3.

When a Minecraft resource pack is not working, the answer is almost always in .minecraft/logs/latest.log. Reload the pack, open the log, and read the errors that appear right after the reload.

Before you start

• Minecraft: Java Edition 26.3 (resource pack format 97.1).

• A text editor to read the log.

• A JSON validator. Any editor that highlights JSON errors works.

Read the log

1. In game, press F3 + T to reload your resource packs.

2. Open .minecraft/logs/latest.log in your editor. Use the Minecraft folder from your launcher.

3. Search for ERROR and WARN, starting from the end of the file.

4. Read the first error after the reload. Later ones are often caused by it.

Errors name the file or the model they could not load. The wording changes between versions, so search for the name of your file rather than for exact phrases.

Match the symptom to the fix

Purple and black checkerboard

This is the missing texture. It means a texture is referenced but not found under that name, a texture file is not a valid PNG, or an animated texture is broken. Check that the path in the model exactly matches a file in assets/<namespace>/textures/.

A model fails to load or an item looks like the missing model

The model file is not valid JSON, or points at a parent that does not exist. A model that does not resolve a texture reference also logs an error. Open the model and check the textures map and every "#name" reference.

Invalid JSON

Look for a missing or extra brace, quote, comma or colon. Trailing commas are not allowed. Paste the file into a validator.

Names with capital letters or spaces

Java Edition accepts only lowercase letters, digits, _, - and . in names, plus / in paths. Rename Ruby Wand.png to ruby_wand.png and update every reference.

Out of date or incompatible pack

The pack shows as incompatible when its format range does not include the game's. For 26.3, use "min_format": 97 and "max_format": 97 in pack.mcmeta. Details are in the pack basics guide.

The pack does not show up at all

pack.mcmeta must be in the root of the folder or zip. Windows hides extensions, so it may really be pack.mcmeta.txt.

Dump the textures

Press F3 + S to dump the game's dynamic textures and texture atlases into the screenshots folder. Open the atlas images to see whether your texture was stitched in.

Fix one error, then reload. A broken pack can be unloaded by the game, which makes everything look missing at once.

Check it worked

• After a reload, the log has no new errors that mention your pack files.

• The pack stays in the Selected list with no warning icon.

• The textures and models you edited show in game.

Common problems

• Your pack sits too low in the list, and another pack overrides it. Move it up.

• The file is named differently from the vanilla original, so it is never used.

• A broken sounds.json silences every sound in that file. See the sounds guide.