BetterGoPaint

BetterGoPaint paints terrain for Paper servers. Hold a feather, pick a brush and a palette of up to five blocks, then right-click the ground. Every stroke is a FastAsyncWorldEdit edit and can be undone with //undo.

BetterGoPaint is a maintained fork of goPaint by Arcaniax. The store listing text used on Hangar and Modrinth is in docs/store-page.md.

Requirements

Requirement	Version
Server	Paper 26.1.1, 26.1.2, 26.2 or 26.3 (details)
Java	25
Plugin	FastAsyncWorldEdit 2.16 or newer, required

Servers on Minecraft 1.21 keep using BetterGoPaint 1.1.x.

Quick start

1. Install FastAsyncWorldEdit 2.16 or newer, then put the BetterGoPaint jar into plugins/ and restart.
2. Give a builder a feather with /give <player> feather. Operators have the bettergopaint.use permission by default.
3. Left-click the feather to open the brush menu, choose a brush and a palette, then right-click to paint. Run //undo to take back a stroke.

The full walkthroughs are set up BetterGoPaint for your build team and paint your first terrain.

Documentation

The documentation lives in docs/, organised by purpose:

• Tutorials: docs/tutorial/, for a first install and a first stroke.
• How-to guides: docs/how-to/, for specific tasks such as limiting what builders can do or upgrading from 1.x.
• Reference: brushes, commands, permissions, configuration, supported versions.
• Explanation: docs/explanation/, for how settings and brush strokes work and what is out of scope.

Links

• Hangar and Modrinth for downloads
• Discord for questions
• Issues for bug reports and feature requests
• Changelog

Contributing and building

Java 25 is required. ./gradlew build compiles, runs the tests and builds build/libs/BetterGoPaint-<version>.jar.

• CONTRIBUTING.md covers commit conventions and the release process.
• docs/development/ covers testing, dependency injection and documentation.

Credits

BetterGoPaint is a fork of goPaint by Arcaniax and is released under the GNU General Public License v3.0.