Start with the simple rule: Java Edition data packs are world specific. A pack placed in one save does not appear in every world, and it does not belong in the global resource pack folder. For an existing singleplayer world, the target folder is the world save folder, then datapacks. For a new world, use the Data Packs button during world creation and move the pack into the selected list before creating the world.
Confirm the pack is in the right world
Open Minecraft Java Edition, select the world, choose Edit, then use the open world folder option. Inside that folder, open datapacks. Put the data pack zip or data pack folder there. If you keep multiple game directories or server worlds, check that you opened the same world Minecraft is actually loading.
- Singleplayer worlds use .minecraft/saves/<world>/datapacks inside the active game directory.
- Server worlds use the datapacks folder inside the server world directory.
- Data packs do not go in mods, shaderpacks, resourcepacks, or the game root.
Check the zip before blaming the game
A valid data pack must contain pack.mcmeta at the top level of the pack. The common mistake is a double folder, where the zip opens to another folder and only then shows pack.mcmeta. Minecraft reads the outer folder or zip first, so that nested layout can make the pack invisible.
- 1.Open the data pack zip or folder.
- 2.Look for pack.mcmeta next to the data folder.
- 3.If both are buried inside a second folder, move that inner folder into datapacks or re-zip the inner contents.
- 4.Keep the pack as a zip or normal folder unless the creator gives different install notes.
Reload the world the right way
After placing or changing a pack while the world is open, run /reload or leave and reopen the world. Reloading can apply many data pack changes, including recipes, loot tables, advancements, predicates, functions, item modifiers, tags, and structure templates. Some deeper world or registry changes need a full world reopen or server restart.
- Use /datapack list to see whether Minecraft detected the pack.
- Use /datapack enable and /datapack disable only after the pack appears in the list.
- If the pack changes world generation, restart the world or server before testing.
- Create a backup before adding packs that change terrain, dimensions, loot, recipes, or progression in a world you care about.
Fix load order conflicts
When multiple data packs edit the same file, Minecraft uses load order to decide which one wins. Later packs can override files from earlier packs, while many tag files can merge unless the pack sets replace to true. If one pack works alone but fails with another pack enabled, test the pair in a copy of the world and adjust the order with the Data Packs screen or /datapack command.
When the world opens in Safe Mode
Safe Mode appears when Minecraft cannot load a world cleanly because a data pack is broken, malformed, or refers to entries the game cannot resolve. Return to the title screen, remove the most recent pack from the datapacks folder, and reopen the world. If the world opens after removing it, check whether the pack matches your Minecraft version before adding it back.
Quick checklist
- The pack is for Java Edition, not Bedrock Edition.
- The pack is inside the datapacks folder for the exact world you are opening.
- pack.mcmeta is at the top level of the zip or folder.
- The Minecraft version matches the pack notes.
- The world was reloaded, reopened, or the server was restarted after installing.
- No other enabled pack is overriding the same recipes, loot tables, tags, functions, or worldgen files.