Pack & Add-on Doctor

Pack or add-on not working? Drop it in for plain answers — and a fix where one is safe.

Java packs: the Minecraft version it has to work on

Every check is made against this version's real file list, taken from Mojang's own assets — so "this texture does not exist any more" is a fact rather than a guess. Bedrock packs and add-ons are checked against the newest Bedrock release automatically.

Drop your pack or add-on here

Resource packs, .mcpack and .mcaddon files. Drop two add-ons together to see if they clash. Java packs are checked against Minecraft 26.1–26.1.2.

.mcaddon.mcpack.zip

What gets checked

Bedrock add-ons

Settings the add-on needs, like Beta APIs
The other half (Behavior or Resource Pack) missing
Too old or too new for your Minecraft
Two add-ons that clash
Broken manifest.json, repaired where it's safe

Textures

Missing textures and broken paths
Files renamed as .png that are really JPEG or WebP
Capitals, spaces and symbols that break on Linux and Android
Animation strips whose dimensions do not divide into frames
Invalid .mcmeta files and frames that point past the end

Models & blockstates

Invalid JSON, with the line it fails on
Parents and #variables that never resolve
Blockstates pointing at models the pack does not have
Element coordinates outside Minecraft's allowed range
Item overrides that stopped working in 1.21.4

Everything else

sounds.json entries with no matching .ogg
Font providers pointing at missing files
Particle definitions with missing textures
GUI sheets that 1.20.2 split into sprites
pack.mcmeta, pack_format and the supported-version range

How to fix a Minecraft add-on that isn't working

Drop your .mcaddon, .mcpack, .zip or resource pack onto the Doctor — or several add-ons at once.

Read the report: each problem is one plain sentence, with the details underneath.

Press Fix it where it's offered, and download the fixed file.

Import the fixed file into Minecraft. For a Beta APIs note: Play → pencil (Edit World) → Experiments → Beta APIs.

What it does

Finds missing textures, broken models, unreadable JSON and bad references in Java and Bedrock resource packs

Tells you when an add-on needs the Beta APIs experiment, and exactly where to turn it on

Finds the missing half of an add-on (Behavior or Resource Pack) and halves that aren't linked

Spots scripts made for an older or newer Minecraft, and parts that used removed experiments

Checks several add-ons at once for clashes — the same mob, block, item or pack ID

Repairs manifests, links the halves, gives clashing packs new IDs and repackages zips as .mcpack/.mcaddon

Runs in your browser — nothing is uploaded

Questions

Why does Minecraft say Missing Dependencies?

An add-on is usually two packs — a Behavior Pack and a Resource Pack — and one points at the other. If only one half was imported, or the halves point at different versions of each other, Minecraft reports missing dependencies. The Doctor names the missing half, and when both halves are in the file it can link them for you.

Where is Beta APIs?

Beta APIs is an experiment in each world's settings: Play → the pencil next to the world (Edit World) → Experiments → Beta APIs. Experiments can't be turned off again once the world is played, and they switch achievements off, so try it on a copy of your world.

Why did my add-on stop working after an update?

Add-ons with scripts are built for a specific version of Minecraft's scripting modules. When the game updates, test (beta) versions of those modules disappear, so an add-on made for an older beta stops loading. The Doctor tells you which Minecraft version the add-on was made for — the fix is a newer version of the add-on from its creator.

Is my add-on uploaded?

No. The Doctor reads the file in your own browser and never uploads it. Fixed files are built on your device too.

All tools

Pack & Add-on Doctor

Pack or add-on not working? Drop it in for plain answers — and a fix where one is safe.

Java packs: the Minecraft version it has to work on

Drop your pack or add-on here

Resource packs, .mcpack and .mcaddon files. Drop two add-ons together to see if they clash. Java packs are checked against Minecraft 26.1–26.1.2.

.mcaddon.mcpack.zip

What gets checked

Bedrock add-ons

Settings the add-on needs, like Beta APIs
The other half (Behavior or Resource Pack) missing
Too old or too new for your Minecraft
Two add-ons that clash
Broken manifest.json, repaired where it's safe

Textures

Missing textures and broken paths
Files renamed as .png that are really JPEG or WebP
Capitals, spaces and symbols that break on Linux and Android
Animation strips whose dimensions do not divide into frames
Invalid .mcmeta files and frames that point past the end

Models & blockstates

Invalid JSON, with the line it fails on
Parents and #variables that never resolve
Blockstates pointing at models the pack does not have
Element coordinates outside Minecraft's allowed range
Item overrides that stopped working in 1.21.4

Everything else

sounds.json entries with no matching .ogg
Font providers pointing at missing files
Particle definitions with missing textures
GUI sheets that 1.20.2 split into sprites
pack.mcmeta, pack_format and the supported-version range

How to fix a Minecraft add-on that isn't working

Drop your .mcaddon, .mcpack, .zip or resource pack onto the Doctor — or several add-ons at once.

Read the report: each problem is one plain sentence, with the details underneath.

Press Fix it where it's offered, and download the fixed file.

Import the fixed file into Minecraft. For a Beta APIs note: Play → pencil (Edit World) → Experiments → Beta APIs.

What it does

Finds missing textures, broken models, unreadable JSON and bad references in Java and Bedrock resource packs

Tells you when an add-on needs the Beta APIs experiment, and exactly where to turn it on

Finds the missing half of an add-on (Behavior or Resource Pack) and halves that aren't linked

Spots scripts made for an older or newer Minecraft, and parts that used removed experiments

Checks several add-ons at once for clashes — the same mob, block, item or pack ID

Repairs manifests, links the halves, gives clashing packs new IDs and repackages zips as .mcpack/.mcaddon

Runs in your browser — nothing is uploaded

Questions

Why does Minecraft say Missing Dependencies?

Where is Beta APIs?

Why did my add-on stop working after an update?

Is my add-on uploaded?

No. The Doctor reads the file in your own browser and never uploads it. Fixed files are built on your device too.

Pack & Add-on Doctor

How to fix a Minecraft add-on that isn't working

What it does

Questions

Why does Minecraft say Missing Dependencies?

Where is Beta APIs?

Why did my add-on stop working after an update?

Is my add-on uploaded?

More free Minecraft tools

Pack & Add-on Doctor

How to fix a Minecraft add-on that isn't working

What it does

Questions

Why does Minecraft say Missing Dependencies?

Where is Beta APIs?

Why did my add-on stop working after an update?

Is my add-on uploaded?

More free Minecraft tools