Custom Paintings

Transform your Minecraft world with unique paintings! This mod allows you to add your own images without the limitations of standard sizes and textures. Create any paintings with custom parameters including dimensions, titles, and artist names.

Included is a set of four thematic paintings that are normally unavailable in the game: Air, Earth, Fire, and Water. These stylish artworks will immediately enhance your space.

Smart Painting Selection

Forget random selection! When placing a painting, a convenient menu opens with search and filtering capabilities, allowing you to precisely choose the desired image from available packs.

Important: The mod does not include ready-made paintings — you need to add your own images! Without additional packs, you'll still have access to hidden paintings and the new selection menu.

Installing Painting Packs

For Single Player

Place pack files in the custompaintings folder within your world save:

└── .minecraft/
    ├── saves/
    │   └── My World/
    │       ├── custompaintings/
    │       │   └── FamousPaintings-1.0.zip
    │       ├── advancements/
    │       ├── data/
    │       └── level.dat

Alternatively, open the mod's main menu, navigate to the pack management section, and drag files directly into the game window — similar to installing resource packs.

For Servers

Server administrator must copy the pack to the custompaintings folder within the server's world save:

└── <server root>/
    ├── world/
    │   ├── custompaintings/
    │   │   └── FamousPaintings-1.0.zip
    │   ├── advancements/
    │   ├── data/
    │   └── level.dat

Migration from Older Versions

If you used versions prior to 3.0.0 with the resource pack system, the mod will help automatically convert them to the new format. Simply install the new version and enter your world, then open the legacy pack conversion menu.

Creating Your Own Painting Pack

Pack Format

Create a folder for your pack and add:

• An images folder with PNG painting images
• A custompaintings.json file with descriptions

.
└── My Paintings/
    ├── images/
    │   ├── castle.png
    │   ├── beach.png
    │   └── map.png
    └── custompaintings.json

Content of the custompaintings.json file:

{
  "id": "mypaintings",
  "name": "My Paintings",
  "description": "My custom paintings",
  "paintings": [
    {
      "id": "castle",
      "name": "Castle in the Mountains",
      "artist": "Ivan Ivanov",
      "width": 2,
      "height": 3
    },
    {
      "id": "beach",
      "name": "Sunset at the Beach",
      "artist": "Claude Monet",
      "width": 2,
      "height": 2
    }
  ]
}

Pack Properties

• id: Unique identifier (letters, numbers, underscores, and hyphens only)
• name: Pack name (optional)
• description: Pack description (optional)
• paintings: List of painting definitions

Painting Properties

• id: Unique painting identifier (matches filename without .png)
• name: Painting title (optional)
• artist: Artist name (optional)
• width: Width in blocks
• height: Height in blocks

Mod Main Menu

Access settings and utilities through the main menu:

• Via Mod Menu (if installed)
• Via assigned key (default U)

Client Settings

File: .minecraft/config/custompaintings.toml

• Override render distance: Allows increasing painting visibility distance
• Render distance scale: Distance multiplier (1-64)
• Cache images: Save paintings locally for faster loading
• Cache retention time: Number of days to keep cached images (1-1000)
• Disable conversion notifications: Global disable of legacy pack conversion prompts

Server Settings

File: <server>/world/config/custompaintings.toml

• Throttle image transfers: Recommended for servers with 10+ players
• Max packets per second: Limit image transfer speed
• Max packets per client: Individual limit per player
• Max packet size: Image packet size in KB

Safe Removal

Starting with version 3.0.0, all painting data is stored separately in world save files. You can safely remove the mod without losing data — upon reinstallation, all paintings will be restored.