How to Install Data Packs on a Minecraft Server
Data packs let you change parts of Minecraft without a plugin or a mod. They can add recipes, change loot tables, add advancements and even reshape world generation, and they run on a plain vanilla server. They're a Java Edition feature only.
The facts in this guide come from the community wiki's data pack page and Mojang's snapshot notes, checked on November 21, 2026. Pack version numbers change often, so the rule that matters is simple: use a pack built for the Minecraft version your server runs.
On this page
What a data pack can change
According to the wiki, data packs can change advancements, dimensions, functions, loot tables, predicates, item modifiers, recipes, structures, tags, damage types, world generation settings and biomes, with no code changes to the game. A pack is a folder or a .zip. Inside it there's a pack.mcmeta file that tells Minecraft what the pack is.
They aren't a replacement for plugins. A plugin runs its own code and can hook deeper into the server. A data pack works through the game's own data formats and commands. If you need the first kind, see the Paper plugin guide. If you want a vanilla-feeling tweak, like a custom recipe, a data pack is usually the lighter option.
Install a data pack
- Back up
Take a World and settings backup on the Backups tab. Packs that touch world generation are hard to undo.
- Find the world folder
Open the Files tab. The world folder is named by
level-nameinserver.properties, and the default isworld. Inside it you want a folder calleddatapacks. Create it if it isn't there. - Upload the pack
Upload the .zip, or the unzipped folder, into
datapacks. Check thatpack.mcmetasits at the top level of the pack, and not one folder deeper. That's the most common mistake. - Load it
Type
reloadon the Console tab, or restart the server. The wiki says a pack is enabled for the world when the world loads or reloads. - Confirm
Run
datapack list. Your pack should show up as enabled.
The /datapack commands
Use these on the Console tab (no slash) or in game with the slash:
datapack list
datapack enable "file/mypack.zip"
datapack disable "file/mypack.zip"
reloadPacks you added yourself show up as file/<name>. The built-in pack is called vanilla. Load order is stored in the world's level.dat, and the datapack command shows and changes it. If two packs change the same thing, the one that loads later usually wins, so order matters.
pack.mcmeta and pack_format
pack.mcmeta is a JSON file in the root of every pack. It has a pack section with a format number (pack_format) and a description, which shows when you hover the pack in datapack list. If the number doesn't match the number the game expects, Minecraft shows a warning and asks for confirmation before loading it.
Don't edit the format number just to silence the warning unless you know what changed. The wiki's format table runs from 4 (snapshot 17w48a) up through 18 for 1.20.2, and 48 for 1.21. Mojang's 25w35a notes list the data pack version as 85.0, a different style of number, so check the pack author's page for which Minecraft versions their release supports.
There's also an optional filter section, added in pack format 10, that lets a pack hide matching files from packs loaded beneath it.
When a pack won't load or breaks things
- It's not in the list. Check that
pack.mcmetais at the top of the pack and spelled right, then runreloadagain. - Version warning. The pack was built for a different Minecraft version. Find a release for your version, don't just change the number.
- Reload failed. The wiki notes that a failed reload keeps the previous data in use, so check the console for the error and fix it before trying again.
- The server won't start at all. The wiki describes a safe mode that loads only the vanilla pack, which servers can use with
--safeMode. Launch options are staff-only here, so ask support, or move the pack out of the folder and restart. The won't-start fixes has more. - Crash reports. They list the enabled data packs, which helps you spot the culprit.
Frequently asked questions
Where do data packs go on a Minecraft server?
In a <code>datapacks</code> folder inside the world folder. The world folder is named by <code>level-name</code> in server.properties, and the default is <code>world</code>.
Do I need to restart after adding a data pack?
Either restart or run <code>reload</code>. The wiki says a pack is enabled for the world when it loads or reloads.
What is pack_format in pack.mcmeta?
A number that tells Minecraft which game version the pack was written for. If it doesn't match, the game warns you and asks before loading the pack.
Do data packs work on Bedrock?
No. Data packs are Java Edition only.
Can data packs replace plugins?
Sometimes. They can change recipes, loot, advancements and world generation, but they can't run custom code the way a plugin can.