Blockpaint – a resource pack maker for Minecraft

Edition:

🪨 Bedrock Edition: Texture replacement for items, blocks & entities — legacy Bedrock names (e.g. gold_sword, planks_oak) are mapped automatically from Java names. Item/block animations export as flipbooks. Random textures, CEM and CIT are Java-only. Exported as .mcpack with a stable UUID (re-generating updates the pack instead of duplicating it).

Pick the Minecraft version you play - the names, the pictures and the pack all follow it

Add textures: draw one, start from Minecraft's own, or drop PNGs named after the texture (e.g. pig.png)

Build the pack, then drop the .zip into .minecraft/resourcepacks/

📘 How It Works — Quick Guide

🗂 Naming Your Files

Just name each PNG after the texture you want to replace. The tool maps it automatically to the correct path.

Example Filenames

pig.png

→

entity/pig/pig_temperate.png

pig_cold.png

→

entity/pig/pig_cold.png

diamond_sword.png

→

item/diamond_sword.png

grass_block_top.png

→

block/grass_block_top.png

Pig_Warm.PNG

→

entity/pig/pig_warm.png (fuzzy)

🟢 Green dot = exact match | 🟡 Yellow = fuzzy matched | 🔴 Red = unknown, placed in textures/custom/

🚀 Installing Your Pack

Once downloaded, follow these steps to load your pack in-game:

Build your pack using the button below — a .zip file will download.
Open your Minecraft directory: press Win+R and type %appdata%\.minecraft
Drop the .zip file into the resourcepacks/ folder. Do not unzip it.
Launch Minecraft Java Edition and go to Options → Resource Packs
Move your pack from the left column to the right, then click Done.
Your custom textures are now active! 🎉

💡 Tip: For mob variants (e.g. cold biome pig), use names like pig_cold.png, cow_warm.png, wolf_ashen.png. Check the mapping table below for all 1,000+ supported names.

🗂 Filename Cheat Sheet — every format on one page ▼

You never configure anything by hand — the file name decides everything. Drop the PNG on the Drop Hub and the tool writes the models, JSON and properties for you. Full explanations for each row are in the guides further down the page.

Name your file…	…and you get
BASICS
`NAME.png` diamond_sword.png	Replaces that texture. Any vanilla name works — item, block, entity, GUI, particle. Both name orders are accepted (`netherite_sword` or `sword_netherite`).
`MOB_VARIANT.png` cow_warm.png · wolf_ashen.png	A mob variant — biome, colour or type.
`MOB_baby.png` wolf_baby.png · cow_temperate_baby.png	Baby mobs — 26.1 "Tiny Takeover" gave nearly every mob its own.
RANDOM MOB VARIANTS (OptiFine / ETF)
`MOB2.png, MOB3.png…` pig2.png · creeper3.png	Extra random skins for a mob. Upload the plain `pig.png` too as variant 1.
`MOB-NtoM.png` pig-1to20.png	This skin appears roughly 1 in 20 — the tool writes the weights.
`MOB-nametag-NAME.png` pig-nametag-Larry.png	Only on a mob named Larry with a name tag. `=` becomes a space.
`MOB-biomes-LIST.png` pig-biomes-desert-badlands.png	Only in those biomes.
`MOB-day.png · -night.png`	Only during day or night.
`MOB-health-N.png` zombie-health-10.png	Only below that health.
`MOB-lock.png`	Locks the skin to the mob so it never re-rolls.
`(any of the above, combined)` pig-nametag-Larry-night-lock.png	Modifiers stack in one file name.
GLOWING LAYER (ETF)
`NAME_e.png` creeper_e.png	Emissive — glows in the dark. Needs the Entity Texture Features mod.
SHADER MAPS (IRIS / OPTIFINE, LabPBR)
`NAME_n.png` stone_n.png	Normal map — bumps and depth. Read by shaderpacks, not by ETF.
`NAME_s.png` stone_s.png	Specular map — shine, metal and glowing pixels with shaders. No maps of your own? Tick ✨ Shader maps and the site makes both.
ITEMS THAT CHANGE APPEARANCE
`ITEM-anvilname-NAME.png` diamond_sword-anvilname-Excalibur.png	Rename the item in an anvil to NAME and it uses this texture. `=` becomes a space.
`ITEM-anvilname_NAME.png`	Same thing with an underscore — both spellings work.
`ITEM-ENCHANT_LEVEL.png` diamond_sword-sharpness_5.png	Texture for that exact enchantment level.
`ITEM_overlay-ENCHANT_LEVEL.png` leather_helmet_overlay-protection_1.png	Overlay layer for a dyeable item — pairs with the file above.
`ITEM-ENCHANT_LEVEL-worn.png` iron_helmet-protection_4-worn.png	Changes the armour on the body. Needs OptiFine or CIT Resewn.
`ITEM-durability_PERCENT.png` diamond_pickaxe-durability_25.png	Swaps in once the tool drops below that % durability.
`item-NAME.png` item-pizza.png	A brand-new item that only exists via `/give` (custom model data).
ITEM USE STATES
`bow-charge.png · _2 · _3`	Bow pulling stages.
`FOOD-eat.png · _2 · _3` apple-eat_2.png	Eating animation stages.
`shield-on.png`	Shield while blocking.
`fishing_rod-on.png`	Fishing rod while cast.
SUFFIXES YOU CAN ADD
`…-weaponed · -rod · -bow · -block` stick-anvilname-Wand-weaponed.png	How the item is held. Also `-crossbow`, `-shield`, `-trident`, `-flat`.
`…-facing · -random · -random_all` stone-anvilname-Ruby-facing.png	How the placed block is oriented — needs the Custom Block Textures mod (download further down).
ANIMATION
`NAME-animation-N.png` diamond_sword-animation-2.png	Frame N of an animated texture. The 🎞 +Frame button in the editor does the same thing.
OTHER FILE TYPES — SAME DROP HUB
`.ogg`	Custom sound; the event name is guessed from the file name.
`.jem / .jpm`	Entity model (CEM).
`.json`	Item model, block model, Bedrock geometry or particle definition — detected from the contents.
`.zip / .mcpack`	A resource pack to import, or a Fresh Animations pack.
`pack.png`	Becomes the pack icon.

💡 Spaces: file names can't contain them — write = and the tool turns it into a space.

🎮 Pick your Minecraft version at the top of the page before building. A pack built for a different version shows up as incompatible and the game then ignores item models.

⬆ Upload Textures

🖼

The Drop Hub — throw anything Minecraft in here

Textures · models (.jem / .json) · particles · sounds (.ogg) · Fresh Animations & resource packs (.zip) — everything gets sorted automatically

🔍 Preview

⚙ Resource Pack Settings

Minecraft Version

✦ Minecraft Java 1.21.11 Pack Format: 57 Fabric ✓

Pack Name

Pack Format (auto-set)

Description

🗜 Shrink PNG files - lossless, every pixel stays identical

Pack Icon (pack.png) — shown in Minecraft next to your pack's name

+ Click to upload
Recommended 128×128 or 64×64 px

PACK.PNG

No image selected

PRESETS:

🔊 Custom Sounds OPTIONAL ▼

✨ Custom Particles OPTIONAL ▼

🧊 Custom Entity Models (CEM) OptiFine / ETF ▼

🐾 Fresh Animations Patch FA + ETF/EMF ▼ ON

Load the Fresh Animations zip — browse all entity textures as templates. Click any entity to replace it with your own artwork. The exported pack includes all FA models + your textures.

📥 Drop the FreshAnimations_vX.X.X.zip on the Drop Hub at the top of the page — it is detected by name and loaded here automatically. Any pack imported via the Hub that contains CEM animations can also be loaded as an FA patch from the import window.

No Fresh Animations pack loaded yet

📋 Live .properties Preview

🎞 Animation .mcmeta Editor ▶

Add animation metadata for textures (creates <texture>.png.mcmeta files in the ZIP).

Frametime Interpolate

📚 Detailed Guides REFERENCE

Everything above is enough to build a pack. Open a guide below when you want the full rules for one of the advanced filename formats.

🎲 Smart Variant Filenames ETF / OptiFine ▼

Name your PNG file with special modifiers separated by - and the tool will automatically parse conditions like weight, nametag, biome, and time of day — then generate an optifine/random/entity/ .properties file in the pack.

TEXTURE_KEY-lock-NtoM-nametag-NAME-Biomesspawn-BIOME1-BIOME2-day|night.png

Full Example

sheep_wool-lock-20to1-nametag-Dolly-Biomesspawn-tyga-Iplains.png

🔒 lock ⚖ 1:20 chance 🏷 Dolly 🌍 taiga, snowy_plains

Token	Meaning	Example
TEXTURE_KEY	Base texture to add a variant to (e.g. sheep_fur, sheep_wool)	sheep_wool, pig, cow_warm
lock	Locks the variant assignment per entity (stable via UUID)	-lock
NtoM	Weight — shows 1 out of N times (N=denominator, M=numerator)	-20to1 (5% chance)
nametag-NAME	Only show when entity has this nametag. Use `=` for spaces (PNG filenames can't contain spaces)	-nametag-Dolly, -nametag-Charlie=Marco=the=second
Biomesspawn-BIOME	Only show in these biomes (chain multiple)	-Biomesspawn-tyga-plains
day / night	Time of day condition	-day, -night

Biome Alias	Maps to	Biome Alias	Maps to
tyga	taiga	Iplains	snowy_plains
forest	forest	darkforest	dark_forest
desert	desert	mesa / badlands	badlands
savana	savanna	swamp	swamp
mountains	windswept_hills	mangrove	mangrove_swamp
nether	nether_wastes	deepdark	deep_dark

Requires ETF or OptiFine: The generated .properties file needs the Entity Texture Features (ETF) Fabric mod or OptiFine installed in Minecraft to work. Conditions within one variant entry use AND logic — name a separate variant file for OR conditions.

🔤 CIT — Anvil Rename Textures v10 · OptiFine / CIT Resewn ▼

Token	Meaning	Example
ITEM_KEY	Minecraft item ID (without namespace)	diamond_sword, bow, shield
anvilname	Trigger keyword — texture shows only when item has this anvil name	-anvilname-
CUSTOM_NAME	The exact display name to match (case-insensitive). Use `=` for spaces	TNTsword, God=the=Great
HOLDTYPE (optional)	How the item is held in hand — see table below	weaponed, rod, flat…

⌨ Command-Only Item Textures v10 · CustomModelData ▼

Token	Meaning
`item-`	Marks this as a command-only custom item texture
ITEM_NAME	Name for the custom item — used as texture and model name
HOLDTYPE (optional)	How the item appears in-hand — see table below

Keyword	Model Parent	Best for
`weaponed` / `sword` / `tooled`	`minecraft:item/handheld`	Swords, axes, pickaxes, spears
`rod` / `fishing`	`minecraft:item/handheld_rod`	Fishing rods, wands
`flat` / `generated`	`minecraft:item/generated`	Default — books, food, flat items (no keyword needed)
`bow`	`minecraft:item/bow`	Bows
`crossbow`	`minecraft:item/crossbow`	Crossbows
`shield`	`minecraft:item/shield`	Shield-like items
`trident`	`minecraft:item/trident`	Tridents, javelins
`block`	`minecraft:block/cube_all`	Block-shaped items

⚡ Use-State Textures v18 · Vanilla 1.21.4+ ▼

✨ Enchantment Textures v19 · Vanilla 1.21.4+ ▼

🛡 Worn Armor Enchantment Textures OptiFine · CIT Resewn ▼

🎞 Item Animation Vanilla ✓ ▼

💔 Durability Textures v19 · Vanilla 1.21.4+ ▼

🧱 Custom Block Textures Mod OPTIONAL · FABRIC ▼

📖 Filename Mapping Reference ▼

★ Only

Filename (PNG)	Category	Path in Pack

ᚠ Language Files OPTIONAL ▶

Add custom names for items, blocks and entities. Exported as assets/minecraft/lang/en_us.json.

🎨 Batch Edit Textures OPTIONAL ▶

Select textures and apply filters to all at once.

0 selected

Brightness0

Hue Shift0°

Saturation0

Contrast0