> For the complete documentation index, see [llms.txt](https://docs.onelitefeather.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.onelitefeather.net/reference/brushes.md). # Brushes Every brush places blocks from the palette. The brush decides which positions are painted. Settings that a brush does not use are hidden in the menu. | Brush | Paints | Extra setting | | -------------- | -------------------------------------------------------------------------------- | --------------------------------------- | | Sphere Brush | Every block in a sphere around the clicked block. | — | | Spray Brush | Random blocks in the sphere. | Chance | | Splatter Brush | Random blocks, more likely close to the clicked block. | Falloff | | Disc Brush | A flat disc on one axis through the clicked block. | Axis | | Bucket Brush | Connected blocks of the same type as the clicked block. | — | | Angle Brush | Only steep faces such as cliffs. | Angle distance, angle height difference | | Overlay Brush | Blocks with air above them. | Thickness | | Underlay Brush | Blocks without air above them. | Thickness | | Fracture Brush | Cracks and fissures. | Fracture distance | | Gradient Brush | A gradient that blends the palette blocks into each other. | Mixing, falloff | | Paint Brush | Strokes along a curve through every point you click; sneak to finish the stroke. | Falloff | The Paint Brush keeps at most 256 points of one stroke. A click past that limit is refused with a message; sneak and click to paint the stroke with the 256 points it already holds. Settings shared by all brushes: size and mask (only replace the mask block). The surface mode (`DIRECT`, `RELATIVE`, `DISABLED`) applies to every brush except Overlay, Underlay and Fracture. Strokes also respect the global mask of the builder's WorldEdit session (`//gmask`). Defaults and limits are in [Configuration](/reference/configuration.md). The menu slots of these settings are in [Brush menu](/reference/brush-menu.md). ## Shapes Each picture shows the shape from the top and as a cross-section through the clicked block. The legend in each picture names the colours of the painted, unchanged and air blocks and of the clicked block. ### Sphere Brush ![Sphere Brush shape, top view and side cross-section: every block in a sphere around the clicked block is painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-a3c7affbebacb4affc7b20be2beaaa9493ec637e%2Fsphere-brush.svg?alt=media) ### Spray Brush ![Spray Brush shape, top view and side cross-section: random blocks in the sphere are painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-a8ba3f9285b46483149c6d10d090213363fc9531%2Fspray-brush.svg?alt=media) ### Splatter Brush ![Splatter Brush shape, top view and side cross-section: blocks near the clicked block are painted more often](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-857cc70c8504e80adfba1afed16ca03d62ad8ac7%2Fsplatter-brush.svg?alt=media) ### Disc Brush ![Disc Brush shape, top view and side cross-section: a flat disc through the clicked block](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-602d3581b480f9ba72e4928e5369e1c704013496%2Fdisc-brush.svg?alt=media) ### Bucket Brush ![Bucket Brush shape, top view and side cross-section: connected blocks of the clicked block's type are painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-446918579a7e879a88145ae15aa41f090f4ba2d2%2Fbucket-brush.svg?alt=media) ### Angle Brush ![Angle Brush shape, top view and side cross-section: only the steep face of a cliff is painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-adeb645794cb71f0c151c71195eff9f876a32094%2Fangle-brush.svg?alt=media) ### Overlay Brush ![Overlay Brush shape, top view and side cross-section: blocks with air above them are painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-bd42fa058cb48022a57126b49af190c60a5edd12%2Foverlay-brush.svg?alt=media) ### Underlay Brush ![Underlay Brush shape, top view and side cross-section: blocks without air above them are painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-c8efad86db433008b01ce3c68eaf654b8942e431%2Funderlay-brush.svg?alt=media) ### Fracture Brush ![Fracture Brush shape, top view and side cross-section: cracks and fissures are painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-6c7023a2fb00523c08cc4135b9c4ee1bade1aea0%2Ffracture-brush.svg?alt=media) ### Gradient Brush ![Gradient Brush shape, top view and side cross-section: palette blocks in bands from bottom to top](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-79462e12103cd14ad5e1dfc6e75ac9236a48f636%2Fgradient-brush.svg?alt=media) ### Paint Brush ![Paint Brush shape, top view and side cross-section: blocks along a curve through the clicked points are painted](https://862810040-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F3dAk0UjgUbQUOWgnpUwe%2Fuploads%2Fgit-blob-65181aaed742f3e238285e22026da30ea229d338%2Fpaint-brush.svg?alt=media) --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation by asking a question. Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters: ``` GET https://docs.onelitefeather.net/reference/brushes.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.