World Brush

World Brush is a bilingual Godot 4 editor plugin that lets you paint, arrange, and erase reusable 3D scenes directly inside the editor viewport.

It is designed to speed up environment creation by allowing you to place trees, rocks, plants, props, decorations, and other 3D scenes using a configurable brush instead of positioning every object manually.

Main Features

• Paint multiple 3D scene instances directly in the editor viewport.
• Erase previously painted instances using an erase brush.
• Add multiple PackedScene resources to a scene palette.
• Switch quickly between scenes using Previous and Next buttons.
• Save independent brush settings for every scene.
• Adjustable brush radius.
• Adjustable number of instances per stamp.
• Adjustable minimum spacing between placed instances.
• Optional random Y-axis rotation.
• Optional rotation with the surface slope.
• Adjustable maximum allowed surface slope.
• Optional random scale with minimum and maximum values.
• Adjustable height offset.
• Offset direction using either World Y or the surface normal.
• Immediate undo and redo support for painting and erasing.
• Persistent scene palette and brush settings.
• Scrollable and compact editor interface.
• Arabic and English interface support.

Scene-Specific Settings

Each scene in the palette remembers its own brush configuration.

For example, a tree scene can use a large brush radius, wide spacing, and random scale, while a rock scene can use a smaller radius, different spacing, and surface rotation.

When switching between scenes, World Brush automatically loads the saved settings for the selected scene.

Installation

1. Download the addon package.
2. Extract the downloaded ZIP file.
3. Copy the included addons folder into the root of your Godot project.
4. Open the project in Godot.
5. Go to Project > Project Settings > Plugins.
6. Find World Brush.
7. Enable the plugin.

The final addon path should be:

res://addons/world_brush/

Basic Usage

1. Open a 3D scene in Godot.
2. Open the World Brush dock.
3. Add one or more PackedScene resources to the scene palette.
4. Select the scene you want to paint.
5. Configure its brush settings.
6. Enable the brush.
7. Paint directly in the 3D viewport.
8. Use the erase mode to remove painted instances when needed.
9. Use undo and redo to reverse or restore painting actions.

Intended Uses

World Brush can be used for placing:

• Trees
• Rocks
• Plants
• Grass groups
• Environment props
• Decorations
• Repeated buildings
• Reusable gameplay scenes
• Other Node3D-based scenes

Compatibility

• Godot 4.6.3 or newer
• Godot editor plugin
• Intended for 3D projects

License

World Brush is released under the MIT License.