What Is the Painted Biomes Mod for Minecraft?
If you have ever wished you could paint your Minecraft world's biomes like a canvas, the Painted Biomes mod turns that idea into a working reality. Instead of relying on vanilla world generation or complex data packs, this mod lets you use actual image templates to define exactly where each biome appears. Every pixel in your PNG file becomes a single block in the world, giving you pixel-perfect control over biome placement across entire dimensions. Whether you want to recreate a fantasy continent, map a real-world landscape, or simply place a desert right next to a frozen tundra, Painted Biomes opens up creative possibilities that go far beyond what standard biome providers can do.
How the Biome Replacement Works
Before version 0.4.0, the mod used a GenLayer override, which worked only in limited cases and mostly in the Overworld with specific world types. Now the main method relies on a custom BiomeProvider wrapper. This approach makes Painted Biomes compatible with any dimension — the Overworld, the Nether, the End, and even custom dimensions added by other mods. However, simply changing the biome does not automatically reshape the terrain. For that, you can optionally override the ChunkProvider with four vanilla-style options: VANILLA_DEFAULT, VANILLA_FLAT, VANILLA_NETHER, and VANILLA_END. If you already use a tweak mod like Dimensional Control, it is usually best to let that mod handle the chunk provider and keep Painted Biomes focused on biome mapping.
Two Template Image Modes
The mod offers two distinct ways to define your biome layout:
- Single template image — One large image that you position in the world using configurable coordinates and alignment settings. You can center it, place it by a corner, or offset it precisely. This mode also supports optional repeating in all four directions, with two repeat styles: repeating the entire template or repeating the edge-most pixel's biome.
- Per-region templates — Separate images for each Minecraft region (Anvil file format). You can theoretically map the entire world if you have the patience to create all the necessary images and enough disk space to store them. This mode follows the standard region grid, making it perfect for large-scale custom maps.
Getting the Colors Right
Biomes are mapped using color channels from the template image. By default, the mod reads the red channel to determine the biome, which works well for vanilla biomes. You can switch to the green or blue channel, or even use a combined color value if you need more than 255 unique biomes. The configuration file contains a list of ColorToBiome mappings that you can customize. When you first launch the mod, it auto-generates a set of default vanilla biome colors, so you can start painting immediately. If you ever want to reset them, simply delete the mappings and let the mod regenerate them.
Configuration Overrides for Every Situation
One of the most powerful features is the layered configuration system. The main config file lives at config/paintedbiomes/paintedbiomes.cfg. You can override it per-world by placing a file inside the world save directory. On top of that, you can override settings per dimension globally or per-world. For example, you could have a different template alignment for the Nether in one specific world without touching the global settings. Not all values can be overridden per dimension — things like the color definitions and the enabled dimensions list remain global — but the system gives you tremendous flexibility for fine-tuning your biome paintings.
Managing mods like this is much simpler when you use a dedicated launcher that handles installation and updates for you. The foxygame.net launcher provides a modern, streamlined way to install Painted Biomes directly from its menu, so you can skip the manual file juggling and jump straight into customizing your world's biomes.
Adding Variation and Randomness
Starting from version 0.5.0, you can inject more life into your painted worlds with three randomization options. You can enable random rotation and random flipping (mirroring along the x or z axis) for each template image. You can also set up alternate templates that the mod will pick from randomly. The results are deterministic — based on the world seed and the template's position — so they stay consistent every time you load the world. These features shine in single template mode with repeating enabled, especially when you design templates that have the same biome around the edges. For instance, you could create a set of island templates surrounded by ocean, and the mod will scatter them across the sea with varied orientations, making the world feel handcrafted yet unpredictable.
Unpainted Areas and Undefined Pixels
You have full control over what happens in regions not covered by any template. Two config options let you set the biome for unpainted areas (outside the template bounds) and for completely transparent pixels inside the template. Setting the value to -1 tells the mod to fall back to regular terrain generation. Otherwise, you can assign a specific biome ID. This way you can, for example, paint only a central continent and leave the rest of the world as a deep ocean, or fill transparent holes with a lush forest.
Quick Start Guide
To get Painted Biomes running in its simplest form:
- Launch the game once to generate the default configuration file. You can edit it before loading any world.
- Enable the mod in your desired dimension by adding its ID (0 for Overworld, -1 for Nether, 1 for End) to the
enabledInDimensionslist. - Create a PNG template image. Remember: one pixel equals one block. Place it as
biomes.pngin the correct templates folder (e.g.,config/paintedbiomes/templates/dim0/for the Overworld). - Set the unpainted and undefined area biome IDs to your liking.
- Load a world and watch your painted biomes come to life.
Tip: While testing, you do not need to delete the entire world. Just remove the region files from the save folder to force terrain regeneration, keeping your player data, gamerules, and spawn point intact.
Making the Most of Painted Biomes
This mod is a game-changer for map makers, server owners, and anyone who wants to break free from random world generation. You can craft precise adventure maps, recreate real-world geography, or design a completely custom biome progression for a modpack. The per-region template mode, combined with a small utility program available on the mod author's GitHub repository, lets you split a massive image into region-sized pieces automatically. While memory usage can increase with many alternate templates, pre-generating the world before actual gameplay keeps performance smooth. Painted Biomes turns the abstract concept of biome distribution into a visual, intuitive process — and once you see your custom landscape unfold, you will wonder how you ever played without it.