pack.mcmeta
Missing, broken, or declared in a way the game rejects, including the 1.21.9 switch to min_format and max_format that broke many older packs.
Resource Pack Checker
Find out why a pack does not load, or shows purple and black squares. Drop it in and get a list of what is wrong and how to fix it.
Drop your resource pack .zip hereor click to choose one. It stays on your computer.
How it works
What the resource pack checker finds
The mistakes that quietly break a pack, found before players do.
Missing files
Models that point at textures or parents that are not there, item definitions naming missing models, and sounds with no .ogg file behind them.
Names the game refuses
Capital letters, spaces and other characters Minecraft does not allow in a resource path. The game skips those files, so they show up as missing.
Broken files
JSON that does not parse, JPEGs renamed to .png, MP3s where only Ogg plays, and animated textures that are not a whole number of frames.
Step by step
How to fix a resource pack that does not work
Minecraft rarely says why a pack fails. It just leaves it out, or shows purple and black squares.
- 1
Check the pack
Drop your resource pack's zip in at the top of this page. It is checked in your browser in a second or two, and nothing is uploaded, so unreleased work stays private.
- 2
Fix the errors first
Start with pack.mcmeta, since nothing in the pack loads without it, then the missing files and bad names. Every error names the file that is wrong and says why it fails.
- 3
Check it again
Fix those files, zip the pack again with pack.mcmeta at the very top, and drop it back in. Repeat until the report comes back clean, then load the pack in game to be sure.
Free tools
More for pack makers
Every one free, with no account, and nothing uploaded.
Resource Pack Optimizer
Shrink a whole pack: recompressed PNGs, minified JSON and junk files removed.
Open Texture Compressor
Compress PNG textures one at a time or in batches, lossless or like TinyPNG.
Open Resource Pack Merger
Merge packs into one, combining lang, sounds, fonts and custom model data.
Open pack.mcmeta Generator
Write a pack.mcmeta that every version you pick accepts, 1.21.9+ included.
Open Pack Format Versions
Every pack_format number from 1.6.1 to 26.3 and the versions each covers.
Open FAQ
Resource Pack Checker FAQ
Why does my resource pack say it is incompatible?
Its pack.mcmeta declares a pack format for another Minecraft version. The checker tells you which versions your pack declares; the pack.mcmeta generator makes one for the versions you want.
Why do I see purple and black squares?
That is Minecraft's missing texture or missing model. The checker lists every model that points at a texture or parent model that is not in the pack, and which file asked for it.
Why does it not report missing vanilla textures?
A reference into the minecraft namespace can name a texture that ships with the game rather than in your pack, and the checker cannot see the game's files. Everything in your own namespaces is checked.
Is my pack uploaded?
No. Everything happens in your browser: your files never leave your computer, and there is no account to make.
Why is my resource pack not showing up in Minecraft?
Usually pack.mcmeta is missing, broken, or not at the top of the zip, often because the folder was zipped instead of its contents. The checker finds all three.
Why are my custom textures not showing?
Most often a model points at a texture path that does not exist, or a file name has a capital letter or space, which makes Minecraft skip it. The checker lists both, with the file that asked for it.