Skip to content
ShapeCraft

Resource Pack Generator

Java EditionNew

Start a resource pack the right way. Pick your Minecraft Java version and get a pack.mcmeta with the correct pack_format (or the new min_format / max_format from 1.21.9), a pack.png made from your colours and initials or your own image, and the JSON for every custom item and retextured block: models, blockstates, 1.21.4+ item model definitions and custom_model_data wiring that matches your version. Warnings catch the classic mistakes — uppercase letters, spaces, missing namespaces, trying to add a brand-new block — and the whole pack downloads as a ZIP you can drop straight into your resourcepacks folder.

Pack info

§ codes work: §6 gold, §a green, §b aqua, §c red, §7 grey, §l bold, §o italic.

Your own folder under assets/ for new models and textures (lowercase, no spaces).

Minecraft version

From 1.21.9 formats are major.minor: the pack declares min_format / max_format.

Items & blocks

  • item
    mypack:item/ruby
    /give @p paper[item_model="mypack:ruby"]
  • block
    minecraft:block/polished_diorite

Upload a PNG for each texture slot to include it in the ZIP (stays in your browser). Blocks need a minecraft: id — resource packs retexture existing blocks.

pack.png

Up to 3 characters; empty uses the pack name.

Overlays & languages

Overlays

Extra folders (same layout as the pack root) applied only on some versions — for packs that need different files per version. Read from 1.20.2.

Languages

Creates assets/mypack/lang/<code>.json with names for your entries. Codes the game doesn't know (e.g. a conlang) are also declared in pack.mcmeta.

Your pack

Format
97.1
26.3
Files
7
in the ZIP
Textures
0/2
uploaded
No problems found — paths are lowercase, namespaced and valid for this version.

Files

pack.mcmeta
{
  "pack": {
    "description": "§6My Resource Pack §7· §fmade with ShapeCraft",
    "min_format": [
      97,
      1
    ],
    "max_format": 97
  }
}

Folder structure

my-resource-pack.zip
├── assets/
│   ├── minecraft/
│   │   ├── blockstates/
│   │   │   └── polished_diorite.json
│   │   └── models/
│   │       └── block/
│   │           └── polished_diorite.json
│   └── mypack/
│       ├── items/
│       │   └── ruby.json
│       └── models/
│           └── item/
│               └── ruby.json
├── pack.mcmeta
├── pack.png
└── README.txt

Export

How it works

pack.mcmeta tells the game which version a pack is made for. Every release has a format number (1.21.4 = 46, 1.21.5 = 55, 1.21.7–1.21.8 = 64…). From 1.20.2 a pack can declare a range with supported_formats, and from 1.21.9 formats became major.minor (69.0) declared with min_format and max_format. When your range spans both eras the generator writes both sets of keys, because older games only read pack_format.

Each item entry gets a model in assets/<namespace>/models/item. If you give it a base item and a custom model data number, the tool wires it the way your version expects: an overrides list in the base item's model before 1.21.4, or a minecraft:range_dispatch item definition in assets/minecraft/items from 1.21.4. On 1.21.2+ you can also skip the number and use the item_model component — the matching /give commands are generated for you.

Block entries make a block model (cube_all, cube_column, cube_bottom_top or orientable) plus a blockstate with the right variants — axis for pillars, facing for furnace-like blocks. A resource pack can only retexture blocks that exist, so use a minecraft: id (e.g. minecraft:polished_diorite for a marble look); the tool warns you otherwise.

The ZIP contains pack.mcmeta and pack.png at the root, every JSON file, a README listing exactly which texture PNGs to add and where, overlay folders, and any textures you uploaded here. Uploaded images stay in your browser; share links only hold the settings.

Under the hood

pack_format
1.20.2=18 · 1.20.3–4=22 · 1.20.5–6=32 · 1.21–1.21.1=34 · 1.21.2–3=42 · 1.21.4=46 · 1.21.5=55 · 1.21.6=63 · 1.21.7–8=64 · 1.21.9–10=69.0 · 1.21.11=75.0 · 26.1=84.0 · 26.2=88.0 · 26.3=97.1
Texture path
"<ns>:item/ruby" → assets/<ns>/textures/item/ruby.png (pre-1.13: textures/items, textures/blocks)
1.21.4+ item
assets/<ns>/items/ruby.json → {"model":{"type":"minecraft:model","model":"<ns>:item/ruby"}}
Custom model data
1.14+ {CustomModelData:1} · 1.20.5+ [custom_model_data=1] · 1.21.4+ [custom_model_data={floats:[1]}]

FAQ

What pack_format should I use for my Minecraft version?

Pick your version and the generator fills it in. Recent values: 1.20.2 = 18, 1.20.3–1.20.4 = 22, 1.20.5–1.20.6 = 32, 1.21–1.21.1 = 34, 1.21.2–1.21.3 = 42, 1.21.4 = 46, 1.21.5 = 55, 1.21.6 = 63, 1.21.7–1.21.8 = 64. From 1.21.9 (69.0) packs use min_format and max_format instead. A wrong number only shows a 'made for an older/newer version' warning — the pack still loads.

Can a resource pack add a new block or item?

Not on its own. A resource pack changes how existing things look. You can retexture any vanilla block or item, and you can show a custom item model on a vanilla base item with custom model data (1.14+) or the item_model component (1.21.2+). Truly new blocks need a mod, a plugin or a data-driven trick on a server.

Why did custom model data stop working in 1.21.4?

1.21.4 removed 'overrides' from item models. Item appearance now comes from item model definitions in assets/<namespace>/items, and custom model data is matched with a minecraft:range_dispatch on minecraft:custom_model_data. The component syntax also changed to custom_model_data={floats:[1]}. Choose 1.21.4 or newer here and the new files are generated for you.

What size should pack.png be?

Any square PNG works; 64×64 or 128×128 is typical and stays sharp in the pack list. This tool makes either size from your colours and initials, or cover-crops an uploaded image to the exact size.

Why is my texture purple and black in game?

That's the missing-texture checkerboard. The PNG isn't where the model points: check the path is lowercase with no spaces, the namespace matches the folder (gems:item/ruby → assets/gems/textures/item/ruby.png), the file ends in .png and pack.mcmeta is at the root of the ZIP — not inside an extra folder.

All tools →