Guide
Learn how to create and install custom Minecraft paintings.
What this tool does
This tool lets you create custom Minecraft paintings from your own images.
It is designed for Minecraft 1.21 and later, which introduced a new datapack-based system for defining custom painting variants, and works on every version from 1.21 to 26.3. With this system, you can add new paintings with custom sizes, up to 16×16 blocks, without replacing any existing Minecraft paintings.
The tool handles:
- • Image upload
- • Animated paintings from GIF, animated WebP and APNG files
- • Cropping to valid painting dimensions
- • Generating a ready-to-use datapack
- • Generating the associated resource pack for textures
Why this requires Minecraft 1.21+
Before 1.21 (old system)
Before Minecraft 1.21, it was not possible to add new paintings.
To use custom images, players had to:
- • Create a resource pack
- • Replace textures of existing Minecraft paintings
- • Lose the original paintings in the process
- • Coordinate resource packs manually on servers
This worked, but it was a hack, not a real feature.
If you are playing Minecraft 1.20 or earlier, you should use a tool designed for that system, such as: mcpaintings.com
Since 1.21 (new system)
Minecraft 1.21 introduced painting variants via datapacks.
This means:
- • You can add new paintings instead of replacing old ones
- • Paintings can have custom dimensions (up to 16×16)
- • Paintings are defined in datapacks
- • Images are provided through a resource pack
This tool is built specifically around this new system.
Installing custom paintings in a singleplayer world
- 1
Use this tool to generate your datapack and resource pack.
- 2
Open your Minecraft world folder:
.minecraft/saves/<your_world>/ - 3
Copy the generated datapack into:
datapacks/ - 4
Copy the generated resource pack into:
.minecraft/resourcepacks/ - 5
Launch Minecraft and open your world.
- 6
In Options → Resource Packs, enable the generated resource pack.
- 7
Run
/reloador rejoin the world.
Your custom paintings will now be available in-game.
Installing custom paintings on a server
Step 1: Add the datapack
- 1. Stop your server.
- 2. Open your world folder on the server.
- 3. Copy the generated datapack into:
<world_name>/datapacks/ - 4. Start the server or run
/reload.
Step 2: Host the resource pack
Minecraft servers cannot directly store resource packs for clients. You must host the resource pack online.
Common options:
- • Dropbox
- • GitHub Releases
- • Any static file hosting
Important: The file must be publicly accessible and the download link must point directly to the ZIP file.
Step 3: Configure server.properties
In your server.properties file, add or update:
resource-pack=<direct_download_url> To force all players to use the resource pack (recommended), also add:
require-resource-pack=true Then restart the server.
When players join, Minecraft will automatically download the resource pack and custom paintings will render correctly for everyone.
Painting options explained
Title
The title is displayed on the painting item in your inventory. It helps you identify your paintings, especially when you have many.
In Creative mode, you can search for a painting by its title in the search bar, making it easy to find specific paintings.
If left empty, no title will be shown on the item.
Placeable in Survival
This option controls whether the painting can appear when placing paintings in Survival mode.
- • Enabled: The painting can randomly appear when placing a painting in Survival or Creative mode.
- • Disabled: The painting can only be placed using the specific painting item in Creative mode.
Disabling this is useful for special paintings you want to keep exclusive, or for very large paintings that shouldn't randomly appear.
Animated paintings
Upload an animated GIF, WebP or APNG and your painting will play its animation in-game. There is nothing to configure: crop it like any other image, and the tool extracts every frame and keeps its timing.
Animated paintings show an Animated badge with their number of frames on the Create page.
- • Minecraft shows at most 20 frames per second, so faster animations are simplified while keeping their original speed
- • Very long or very large animations keep fewer frames, so the texture stays a reasonable size
- • Reading the frames requires a recent browser (Chrome, Edge…). Otherwise, the painting is saved as a still image
Editing paintings you already exported
Your paintings aren't kept when you close or reload the page. To change them later or add new ones, click Import on the Create page and choose the .zip you exported (or its datapack and resource pack zips together). They come back with their titles, sizes, Survival setting and animations, ready to edit before you export again.
Every painting has a unique ID that never changes, even after an import. Exporting again keeps the same IDs, so the paintings already placed in your worlds stay where they are, and show your changes once you replace the old packs with the new ones.
- • Deleting a painting from the list removes it from your next export, so keep the ones your worlds use
- • If you change the size of a painting already placed, it may no longer fit its wall and drop as an item
- • The original image isn't in the zip: an imported painting can be resized or cropped tighter, but not zoomed back out
Notes & limitations
- • Works on Minecraft 1.21 – 26.3
- • Maximum painting size is 16×16 blocks (Minecraft limitation)
- • All players must use the resource pack to see the paintings correctly
- • Datapacks control what exists, resource packs control how it looks