What Is WorldPainter and What Can You Create With It for Minecraft?

WorldPainter is an interactive graphical map generator for Minecraft Java Edition. It lets you "paint" a landscape with tools similar to a regular paint program: sculpt and mould terrain, paint materials, and place trees, snow and ice on top of it. You then export the result as a playable Minecraft map. It is a desktop application written in Java, so it runs on Windows, macOS and Linux, and it needs Java 17 or newer. It suits players who want to design custom worlds outside the game rather than edit terrain block by block in-game.

What you can create with it

Because the program treats the map as a canvas, the output is limited mainly by how much time you spend painting. Typical uses include:

• Custom terrain — sculpt hills, valleys, mountains and coastlines by painting height rather than placing blocks.
• Painted surfaces — apply materials across the landscape to define biomes, rock, grass, sand and similar ground cover.
• Vegetation and weather detail — add trees, snow and ice as layers on top of the terrain.
• Playable worlds — export the finished map and open it in Minecraft Java Edition.

The site describes the program as "pretty self-explanatory" and notes there is not much documentation yet, so expect to learn largely by experimenting with the menus and tools.

What you need before you start

The site advises trying the program first if you think Java may already be installed, and only downloading Java if needed. On macOS, the Intel .dmg is an older version (2.26.1) with an up-to-date version promised; the current version is offered in .tgz form under the "If you have trouble" section. Portable, installer-less archives exist for all platforms but are explicitly not recommended and unsupported.

Basic workflow

1. Install Java if required. Check your version first; the program needs at least Java 17.
2. Download and install WorldPainter for your OS and architecture from worldpainter.net. If an installer fails, the portable archive is a fallback, though unsupported.
3. Create or work on a world and paint the terrain: shape the surface, apply materials, then add trees, snow and ice.
4. Export the map. Choose Export in the File menu to produce the playable map.
5. Test in Minecraft Java Edition and iterate on the design.

The site's own guidance is to "just experiment and try everything out," including checking the menus and trying right-click instead of left-click to see what changes.

Things to watch out for

• Antivirus false positives. The site states WorldPainter contains no virus or malware and that scanner warnings are false positives. It suggests reporting them to the scanner maker and using the "unquarantine" function (or temporarily disabling the scanner) to install and run the program. VirusTotal results for the download links are published on the site.
• macOS Gatekeeper warnings. If macOS says the .dmg is "damaged," the site says it is not and provides instructions for temporarily disabling Gatekeeper.
• Linux Java runtime. Some Red Hat-based distributions ship a headless Java runtime by default; the site advises installing a complete Java runtime instead.
• File integrity. MD5 and SHA256 checksums are published if you want to verify downloads.
• Learning curve. This is a desktop map-building tool, not an in-game editor, and documentation is thin, so budget time for trial and error.

Is it the right tool for you?

WorldPainter fits if your goal is to author a custom Minecraft Java Edition world from scratch or heavily reshape an existing one, and you are comfortable installing Java software and learning by experimentation. It is less suitable if you want quick in-game edits, need extensive official documentation, or play Minecraft Bedrock Edition, since the site describes it specifically as a generator for Java Edition. The site lists PayPal among its payment platforms, but no pricing details are stated on the page, so check the site directly for current terms before relying on any assumption about cost.