A template for a Minecraft datapack on GitHub! This is meant for new players to the datapack community, who don't know much about how datapacks work, or the dos and don'ts of datapacks. Check out the data folder to learn more!
It's worth noting that this is not the vanilla datapack of Minecraft (as publishing that would violate the Minecraft EULA), but rather a template for a custom one.
This also includes:
- A GitHub Actions CI workflow for Minecraft datapacks
- A .gitignore file (you may need to adapt this to your needs, this gitignore includes VSCode (my primary IDE), Git (yes, I know, it's not counter-intuitive), Windows, and Notepad++ (my secondary IDE))
Licensed under the CC0-1.0 license. Feel free to do anything you want, pretty much :D.
Thanks to @M3FF1N for the pack.png!
These are two files that determine, in part, your datapack's apperance in the Minecraft menu screen.
The pack.mcmeta file is what tells Minecraft what version of Minecraft your pack is made for, and users of what it is about. It is written in JSON, so be careful! This file is required, otherwise your datapack will not load. First, let's start with pack_format:
The pack_format key is what tells Minecraft what version of Minecraft your pack is made for. In most cases, datapacks will work in a version greater than the version it was made for, but not always the other way around. Here's a handy table:
| Minecraft version | pack_format |
|---|---|
| 1.13 - 1.14.4 | 4 |
| 1.15 - 1.16.1 | 5 |
| 1.16.2 - 1.16.5 | 6 |
| 1.17 - 1.17.1 | 7 |
| 1.18 - 1.18.1 | 8 |
| 1.18.2 | 9 |
| 1.19 - 1.19.3 | 10 |
| 1.19.4 | 12 |
| 1.20.0+ | 15 |
Sample pack.mcmeta (you can also see in the example datapack here):
{
"pack": {
"pack_format": 9,
"description": "§6§kM§r §6Made by §3osfanbuff63 §6§kK§r - v1.0.0"
}
}
The description key ideally describes your datapack, or its version, or something like that. The above example shows my username (since I created it) and v1.0.0 - showing this is version 1.0.0.
The pack.png file is the image that will appear when the menu for datapacks is opened, representing your datapack. It is not required. It can be any image file, but it must be of the .png file type, otherwise Minecraft will not recognize it. Many image editors, such as GIMP, include functionality to convert image files by saving them in a different format. If your ideal image is a .jpg or .jpeg file and you don't have a photo editor installed, you can use a tool like this one to convert them.