Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

WorldPainter

worldpainter.net

  • Free plan
  • Windows
  • macOS
  • Linux
7.4 Club score Visit worldpainter.net

What WorldPainter is

WorldPainter is a free, open-source map generator for Minecraft Java Edition. It lets users sculpt terrain and paint materials and landscape details such as trees, snow, and ice, then export a generated world directly to the Minecraft saves directory. The software is primarily for creating maps; changing existing ones is limited to Import and Merge operations. It supports custom mod blocks, using fully qualified names for Minecraft 1.15 and later and numeric IDs for versions 1.12 and earlier. Custom object layers can load objects in BO2, BO3, schematic, or NBT formats. WorldPainter does not create Minecraft structures itself, but it can direct Minecraft to generate them during population. The application runs on Windows, macOS, and Linux and requires Java 17 or later. The download page provides SHA256 checksums for installer files. The maker points users to the official subreddit for support and links to controls, FAQs, plugins, scripting, and other documentation, while noting that a proper user manual is not available yet.

Who it suits

WorldPainter suits Minecraft Java Edition players who want to make and export custom maps by shaping terrain and painting landscape details. It may also suit users working with custom mod blocks or object layers, provided they have Java 17 or later.

Good to know, and what to watch

  • Exports generated worlds directly to the Minecraft saves directory.
  • Supports custom mod blocks and object layers.
  • Available for Windows, macOS, and Linux.
  • Free and open source under GPL version 3.
  • Editing existing maps is limited to Import and Merge.
  • Requires Java 17 or later.
  • Does not generate Minecraft structures itself.
  • No proper user manual is available yet.

WorldPainter

Free

Free plan

Getting started

  1. Open the WorldPainter website
  2. Install Java 17 or later
  3. Download the installer for Windows, macOS, or Linux
  4. Install and launch WorldPainter
  5. Create a map by sculpting terrain and painting materials
  6. Export the finished world to the Minecraft saves directory

Limits to check

WorldPainter remains limited for existing maps, supports no region or entity editing, and cannot generate structures itself.

The Club's review

Overview

WorldPainter is a free, open-source canvas for building custom worlds in Minecraft Java Edition. It suits players and map makers who want direct control over terrain and surface detail rather than a general-purpose world editor. Its strongest use is designing a new landscape quickly; work on an existing save is more constrained.

The application lets you sculpt land, paint materials and landscape features, and send the resulting world straight to Minecraft's saves directory. That makes it a practical route from a rough concept to a playable Java map without a separate export workflow. The trade-off is scope: region, entity and batch editing are not supported, and existing-map changes are limited to Import and Merge operations.

WorldPainter is a Netherlands-based project implemented in Java. Java 17 or later is required, so the software is not a standalone install for machines without a compatible Java runtime.

Key features

Landscape construction

Terrain sculpting and moulding tools provide the core workflow, while painting covers materials and features such as trees, snow and ice. This combination is well suited to authored adventure maps, themed survival starts and other worlds where the shape and appearance of the landscape matter more than editing every underlying game object.

Export and existing worlds

A generated world can be exported directly to the Minecraft saves directory, reducing file-handling steps for creators who are ready to launch their map. Import and Merge offer a way to incorporate or adjust existing maps, but they are limited operations rather than a full editing suite. There is no region, entity or batch editing, so large-scale maintenance of an established world belongs elsewhere.

Mods and custom objects

Mod blocks are supported through fully qualified names for Minecraft 1.15 and later, and numeric IDs for versions 1.12 and earlier. Custom object layers can load BO2, BO3, schematic and NBT files, which extends the tool beyond its built-in landscape painting. WorldPainter does not generate Minecraft structures itself; it can instead instruct Minecraft to generate structures during world population.

Biome and documentation limits

It cannot customize biomes while leaving Minecraft to generate all land according to those biomes, a significant limitation for workflows based on vanilla terrain generation. There is no full user manual yet, although controls, FAQs, plugin, scripting and other documentation are provided. Official support is directed to the WorldPainter subreddit. Download installers have SHA256 checksums, giving administrators a way to verify files before installation.

Pricing

PlanPriceWhat it includes
WorldPainterFreeFree and open source under GPL version 3

There are no paid tiers, seat limits or renewal charges. The free plan includes the complete WorldPainter product, so choosing it is straightforward for hobbyists, educators, servers and professional map creators alike. Its cost advantage does not remove the Java 17 requirement or the editing and biome limitations.

Platforms

WorldPainter runs on Windows, macOS and Linux. It targets Minecraft Java Edition only, not Bedrock. Supported project and content formats include WorldPainter .world files, Minecraft Java maps, height-map images, and BO2, BO3, NBT, SCHEM and schematic custom objects.

Who it's for

Choose WorldPainter when the job is to author a new Java world with deliberately shaped terrain, painted materials and imported custom objects. It is particularly appropriate for map makers who value a visual landscape workflow and direct export into Minecraft saves.

Look elsewhere when the priority is maintaining a live world: the lack of region, entity and batch operations makes routine large-scale editing a poor fit. It is also unsuitable for Bedrock projects, for users who cannot provide Java 17, or for biome workflows that depend on Minecraft generating all terrain from customized biome assignments.

Pros and cons

Pros

  • Complete free release: The GPL-licensed application costs nothing and has no paid feature split.
  • Strong terrain workflow: Sculpting plus material, tree, snow and ice painting supports detailed authored landscapes.
  • Useful extensibility: Mod blocks and BO2, BO3, schematic and NBT object layers accommodate custom content.
  • Direct export: Sending worlds to the Minecraft saves directory shortens the path from design to play.

Cons

  • Not a full world editor: Existing-map work is limited to Import and Merge, with no region, entity or batch editing.
  • Biome constraint: It cannot customize biomes while delegating all land generation to Minecraft.
  • Java dependency: Java 17 or later is mandatory.
  • Documentation gap: There is no proper user manual, so new users may need the available reference material and subreddit support.

Alternatives

Browse the Minecraft World Editors directory when you want to compare tools by editing focus. biomed is a free, MIT-licensed option for cross-platform users. MCA Selector is another free, cross-platform MIT-licensed choice. Minecraft World Trimmer is free of charge, provided as-is under the MIT License. MCBE Inventory Editor targets inventory editing and supports web, self-hosted and desktop environments. Chunker is an open-source MIT-licensed tool from Hive Games. Dovetail is a freemium web and API text-analytics platform rather than a Minecraft map authoring tool. LiveNBTEditor is free MIT-licensed software for Minecraft Java 26.3 with a Windows editor requirement. MCA JSON provides free open-source command-line tools and a JavaScript library for MCA/Anvil and NBT files.

Verdict

WorldPainter is the right choice for anyone creating a Minecraft Java map from the terrain outward: it is free, capable with landscape painting, and flexible with mod blocks and custom objects. Look elsewhere if you need comprehensive editing of an existing world, biome-driven vanilla generation, Bedrock support or a more complete manual.

The verdict

WorldPainter is focused on creating Minecraft Java maps, with tools for terrain, materials, and custom objects. Its existing-map editing is limited, and using it requires Java 17 or later.

Questions people ask

How much does WorldPainter cost?

WorldPainter is free and open source under GPL version 3.

Which Minecraft edition does it support?

It supports Minecraft Java Edition.

Which operating systems are supported?

WorldPainter supports Windows, macOS, and Linux.

What files can it use?

It supports WorldPainter .world files, Minecraft Java maps, height-map images, and BO2, BO3, NBT, SCHEM, and schematic custom objects.

Where can users get support?

The maker directs users to the official WorldPainter subreddit for support.

What the maker publishes

Compatibility limit
The maker says WorldPainter cannot customize biomes while leaving Minecraft to generate all the land according to those biomes. source
Custom content
Custom object layers can load objects in bo2, bo3, schematic or nbt formats. source
Documentation
The maker says there is no proper user manual yet, but links to controls, FAQ, plugin, scripting and other documentation. source
Existing maps
WorldPainter is primarily a map generator, with limited support for changing existing maps through Import and Merge operations. source
Export
Users can export a generated world directly to their Minecraft saves directory. source
Headquarters
Netherlands source
Minecraft structures
WorldPainter cannot generate structures itself, but can direct Minecraft to generate them during population. source
Mod support
WorldPainter supports custom mod blocks, with fully qualified names for Minecraft 1.15 and later and numeric IDs for versions 1.12 and earlier. source
Purpose
WorldPainter is an interactive map generator for Minecraft Java Edition that lets users paint landscapes with terrain, materials, trees, snow and ice. source
Security checks
The download page provides SHA256 checksums for the listed installer files. source
Support
The maker directs users to the official WorldPainter subreddit for official support. source
Technical requirement
WorldPainter is implemented in Java and requires at least Java 17. source
Terrain tools
The maker describes tools for sculpting and moulding terrain and painting materials and landscape features onto maps. source

Checked against the maker's pages on 30 Sept 2026.