A resource pack is a folder (or .zip) that overrides or adds Minecraft's visual and\naudio assets: textures, models, sounds, language files, and fonts. No Java or mod\nloader is required for those vanilla assets.
Use when: the deliverable is visual/audio assets (textures, models, sounds, fonts) in resource-pack format.Do not use when: the task requires gameplay logic or runtime behavior changes (use minecraft-datapack, minecraft-plugin-dev, or minecraft-modding).Do not use when: the task is server infrastructure/runtime administration (minecraft-server-admin).| Minecraft Version | \nPreferred pack metadata | \n
|---|---|
| 1.21 / 1.21.1 | \npack_format: 34 | \n
| 1.21.2 / 1.21.3 | \npack_format: 42 | \n
| 1.21.4 | \npack_format: 46 | \n
| 1.21.5 | \npack_format: 55 | \n
| 1.21.6 | \npack_format: 63 | \n
| 1.21.7 / 1.21.8 | \npack_format: 64 | \n
| 1.21.9 / 1.21.10 | \nmin_format: [69, 0], max_format: [69, 0] | \n
| 1.21.11 | \nmin_format: [75, 0], max_format: [75, 0] | \n
| 26.1 | \nmin_format: [84, 0], max_format: [84, 0] | \n
| 26.2 | \nmin_format: [88, 0], max_format: [88, 0] | \n
Use legacy pack_format only for resource formats below 65 (through 1.21.8).\nResource format 65 and later require both min_format and max_format; use\n[major, minor] for exact patch targeting, including .0 such as [84, 0].\nAn integer or [major] min_format means [major, 0]; an integer or\n[major] max_format permits every minor version on that major line. Do not\nwrite decimal JSON numbers. A legacy-only pack can use its integer\npack_format alone. A range whose min_format includes a legacy format needs\ninteger pack_format and supported_formats; do not include\nsupported_formats for a modern-only range.
my-pack/\n├── pack.mcmeta\n├── pack.png ← 64×64 icon (optional)\n└── assets/\n └── minecraft/ ← override vanilla (or <namespace>/ for new packs)\n ├── models/\n │ ├── block/\n │ │ └── stone.json\n │ └── item/\n │ └── diamond_sword.json\n ├── items/ ← 1.21.4+ item model definitions\n │ └── diamond_sword.json\n ├── blockstates/\n │ └── stone.json\n ├── textures/\n │ ├── block/\n │ │ └── stone.png\n │ ├── item/\n │ │ └── diamond_sword.png\n │ ├── gui/\n │ │ └── sprites/\n │ │ └── my_sprite.png\n │ └── entity/\n │ └── zombie/\n │ └── zombie.png\n ├── sounds/\n │ └── custom/\n │ └── my_sound.ogg\n ├── sounds.json\n ├── font/\n │ └── default.json\n └── lang/\n └── en_us.json\nClient-mod-specific files such as OptiFine CIT and Iris shader packs use their\nown formats. Read conditional assets before\nadding them.
\npack.mcmeta{\n \"pack\": {\n \"pack_format\": 64,\n \"description\": \"My Custom Resource Pack v1.0\"\n }\n}\n{\n \"pack\": {\n \"min_format\": [69, 0],\n \"max_format\": [69, 0],\n \"description\": \"My Custom Resource Pack v1.0\"\n }\n}\n{\n \"pack\": {\n \"min_format\": [75, 0],\n \"max_format\": [75, 0],\n \"description\": \"My Custom Resource Pack v1.0\"\n }\n}\n{\n \"pack\": {\n \"min_format\": [88, 0],\n \"max_format\": [88, 0],\n \"description\": \"My Custom Resource Pack v1.0\"\n }\n}\nassets/minecraft/models/block/my_cube.jsonFull cube — all six faces use the same texture:
\n{\n \"parent\": \"minecraft:block/cube_all\",\n \"textures\": {\n \"all\": \"minecraft:block/stone\"\n }\n}\nColumn block (like logs):
\n{\n \"parent\": \"minecraft:block/cube_column\",\n \"textures\": {\n \"end\": \"mypack:block/my_pillar_top\",\n \"side\": \"mypack:block/my_pillar_side\"\n }\n}\nDifferent sides:
\n{\n \"parent\": \"minecraft:block/cube\",\n \"textures\": {\n \"up\": \"mypack:block/my_block_top\",\n \"down\": \"mypack:block/my_block_bottom\",\n \"north\": \"mypack:block/my_block_side\",\n \"south\": \"mypack:block/my_block_side\",\n \"east\": \"mypack:block/my_block_side\",\n \"west\": \"mypack:block/my_block_side\",\n \"particle\": \"mypack:block/my_block_side\"\n }\n}\nCross model (flowers, plants):
\n{\n \"parent\": \"minecraft:block/cross\",\n \"textures\": {\n \"cross\": \"mypack:block/my_flower\"\n }\n}\n{\n \"credit\": \"Custom model\",\n \"ambientocclusion\": true,\n \"textures\": {\n \"0\": \"mypack:block/panel\",\n \"particle\": \"mypack:block/panel\"\n },\n \"elements\": [\n {\n \"from\": [0, 0, 7],\n \"to\": [16, 16, 9],\n \"faces\": {\n \"north\": { \"texture\": \"#0\", \"uv\": [0, 0, 16, 16] },\n \"south\": { \"texture\": \"#0\", \"uv\": [0, 0, 16, 16] }\n }\n }\n ],\n \"display\": {\n \"thirdperson_righthand\": {\n \"rotation\": [75, 45, 0],\n \"translation\": [0, 2.5, 0],\n \"scale\": [0.375, 0.375, 0.375]\n }\n }\n}\n\n\n\n
fromandtoare in 1/16th block units (0–16).uvis[x1, y1, x2, y2]in 0–16 units.
For 1.21.4 and later, use item definitions in\nassets/<namespace>/items/. For 1.21.3 and earlier, use the legacy model\noverrides array. Read conditional assets\nfor the string-based current custom_model_data selector and the legacy numeric\npredicate; their values are not interchangeable.
{\n \"variants\": {\n \"\": { \"model\": \"mypack:block/my_block\" }\n }\n}\n{\n \"variants\": {\n \"facing=north\": { \"model\": \"mypack:block/my_block\" },\n \"facing=south\": { \"model\": \"mypack:block/my_block\", \"y\": 180 },\n \"facing=east\": { \"model\": \"mypack:block/my_block\", \"y\": 90 },\n \"facing=west\": { \"model\": \"mypack:block/my_block\", \"y\": 270 }\n }\n}\n{\n \"variants\": {\n \"\": [\n { \"model\": \"minecraft:block/grass_block\", \"weight\": 3 },\n { \"model\": \"minecraft:block/grass_block_2\" }\n ]\n }\n}\n{\n \"multipart\": [\n { \"apply\": { \"model\": \"mypack:block/my_slab_bottom\" }, \"when\": { \"type\": \"bottom\" } },\n { \"apply\": { \"model\": \"mypack:block/my_slab_top\" }, \"when\": { \"type\": \"top\" } },\n { \"apply\": { \"model\": \"mypack:block/my_block\" }, \"when\": { \"type\": \"double\" } }\n ]\n}\nassets/<namespace>/textures/block/assets/<namespace>/textures/item/.png extension in JSONassets/minecraft/textures/block/fire_0.png.mcmeta:
{\n \"animation\": {\n \"frametime\": 2,\n \"frames\": [0, 1, 2, 3, 4, 5, 6, 7]\n }\n}\nIf frames is omitted, all frames play sequentially. frametime is in game ticks (default 1).
Place sprites at assets/minecraft/textures/gui/sprites/<category>/<name>.png.\nReference them with <category>/<name> in code/JSON.
For 26.1, a block-model textures entry may remain a sprite string or use an\nobject. The object must have a string sprite; force_translucent, when set,\nmust be a boolean.
{\n \"textures\": {\n \"all\": {\n \"sprite\": \"mypack:block/frosted_panel\",\n \"force_translucent\": true\n }\n }\n}\nBoth forms identify a sprite without .png. Use force_translucent only when\nthe geometry must render in the translucent pass despite its sprite pixels.
An event's namespace comes from the namespace containing sounds.json; a\nsound entry's name identifies the sound-file namespace. Sound files are Vorbis\n.ogg under assets/<namespace>/sounds/. Read\nconditional assets for a correct event\nexample, aliases, sound-source selection, and replacement behavior.
assets/minecraft/lang/en_us.json:
{\n \"block.mypack.my_block\": \"My Custom Block\",\n \"item.mypack.my_item\": \"Magic Wand\",\n \"entity.mypack.my_mob\": \"Forest Guardian\",\n \"death.attack.mypack.laser\": \"%1$s was zapped by %2$s\"\n}\nfr_fr.json, de_de.json)en_us.json as the primary fallbackRead conditional assets for bitmap provider\nlayout and private-use icon guidance.
\nOptiFine CIT and Iris shader packs have client-mod-specific formats. Read\nconditional assets before adding either;\nthey are not portable vanilla resource-pack features.
\n# Singleplayer: place in\n~/.minecraft/resourcepacks/my-pack/\n# or\n~/.minecraft/resourcepacks/my-pack.zip\n\n# Server-side (forces on clients):\n# Set in server.properties:\nresource-pack=https://example.com/my-pack.zip\nresource-pack-sha1=<sha1 hash>\nresource-pack-prompt={\"text\":\"Required pack\",\"color\":\"gold\"}\n| Problem | \nCause | \nFix | \n
|---|---|---|
| Model not showing | \nWrong JSON path or syntax error | \nCheck assets/<namespace>/models/ path; validate JSON | \n
| Black/pink checkerboard | \nTexture path wrong or missing | \nCheck textures/ path, file extension not in JSON | \n
| Blockstate not applying | \nWrong state property name | \nUse F3 to inspect block state; use /data get block <x> <y> <z> for block-entity NBT | \n
| Animation not working | \nWrong MCMETA location | \nMust be same folder as texture, named texture.png.mcmeta | \n
| Custom sound not playing | \nNot in sounds.json | \nRegister sound event in sounds.json, match namespace | \n
| Pack not loading | \nWrong pack_format or min_format / max_format values | \nUpdate pack.mcmeta for the exact 1.21.x patch | \n
Use the bundled validator script before shipping a resource-pack update:
\nUnbundled references to another namespace's models, textures, sounds, or fonts\nare warnings requiring runtime verification with the dependency present. Missing\nfiles in the current namespace fail; strict mode also fails unresolved warnings.
\n# Run from the installed skill directory (for example `.claude/skills/minecraft-resource-pack`):\n./scripts/validate-resource-pack.sh --root /path/to/resource-pack\n\n# Strict mode treats warnings as failures:\n./scripts/validate-resource-pack.sh --root /path/to/resource-pack --strict\nWhat it checks:
\npack.mcmeta and assets/**/*.jsonpack.mcmeta field shape, including integer, [major], and [major, minor] versionscustom_model_data select cases use strings; 26.1 texture objects use a string sprite and optional boolean force_translucenttype: \"event\" sound aliases name an event in that sounds.json*.png.mcmeta has a matching *.pngThe validator cannot resolve a sound event owned by another namespace, or prove\nthat a command or mod code invokes an event with the intended sound source.\nThose cases warn and require an exact-client runtime check.
\n