Beginning

Namespace

The namespaces are what the resourcepack is made of, as an example path is this one

📦resource_pack.zip
  └── 📁assets
      └── 📁<namespace>

a more concrete example that we can find in minecraft itself is

📦resource_pack.zip
  └── 📁assets
       └── 📁minecraft
           ├── 📁textures
           │    └── 📁entities
           │    └── 📁block
           └── 📁models
                └── 📁item

these are used to define spaces, and must always be specified when choosing the path to a model, for example minecraft:item/diamond which will reference assets/minecraft/models/item/diamond.json

pack.mcmeta

What is this, this is to define the version and the description in which the resourcepack will work, which is located in the main path of the resourcepack

-1.21.9

{
    "pack": {
        "pack_format": 46,
        "supported_formats": [
            43,
            54
        ],
        "description": "Beautiful Masky Tweaks"
    }
}

+1.21.9

You can put colors on desc, click here!

where you can find all the mcmeta by versions is here in "List of resource pack formats", and this is located in

📦resource_pack.zip
  ├── 📁assets
  └── 📝pack.mcmeta

overlays

these are used to apply textures and anything else to a given version of minecraft, it is used to add compatibility to multiple versions without breaking

📦resource_pack.zip
  ├── 📁assets
  │    └── 📁<namespace>
  ├── 📁overlay_1_21_4 //overlay name
  │    └── 📁<namespace>
  └── 📝pack.mcmeta

And these need to be specified in the pack.mcmeta to work.

-1.21.9

{
    "pack": {
        "pack_format": 42,
        "supported_formats": {
            "min_inclusive": 34,
            "max_inclusive": 42
        },
        "description": "Beautiful Masky Tweaks"
    },
    "overlays": {
        "entries": [
            {
                "formats": {
                    "min_inclusive": 43,
                    "max_inclusive": 46
                },
                "directory": "overlay_1_21_4" // overlay folder name
            }
        ]
    }
}

+1.21.9

You can use both formats to support old and current versions, example:

{
    "pack": {
        "pack_format": 46,
        "supported_formats": {
            "min_inclusive": 46,
            "max_inclusive": 69
        },
        "min_format": 46,
        "max_format": 69,
        "description": "MaskyTweaks"
    }
}

pack.png

This is to define the image that will be seen when selecting the resourcepack, generally it is 64x64.

📦resource_pack.zip
  ├── 📁assets
  ├── 📝pack.mcmeta
  └── 🎨pack.png