Last reviewed 26 May 2026

Applies to

Unity scene refinement Mesh painting workflows VR environment polish

Difficulty Intermediate

Polybrush

Polybrush is a Unity tool used for painting and editing certain kinds of mesh-based detail directly inside the editor. Unity describes it as a mesh painting, sculpting, and geo-scattering tool. It can be useful for adding variation, blending surfaces, painting colors, and scattering detail in a more hands-on way than manual placement alone.

For world builders, it is often helpful when a scene feels too clean, too repeated, or too obviously assembled from identical parts.

Package And Support Quick Reference

Need	Use this	Notes
Install Polybrush if supported	Window -> Package Manager -> Unity Registry -> Polybrush -> Install	Unity's package docs say Polybrush 1.0 and newer is available only through Package Manager.
Add it when search fails	com.unity.polybrush	Use Install package by name only if your Unity version can resolve the package.
Open the tools	Tools -> Polybrush -> Polybrush Window	Unity documents this menu path for the Polybrush window.
Check Unity 6 support	Unity Polybrush package docs	Unity's package page says Polybrush is deprecated and no longer supported in Unity 6.3 and later.
Terrain work	Use Unity terrain tools instead	Unity's Polybrush docs say Polybrush is not compatible with Terrains.

Video Companion

This official Unity video is useful here because Polybrush is much easier to understand once you see the brush workflow in motion instead of only reading about surface variation.

Make a Planet in Unity 2019 with Polybrush

Where Polybrush Fits In The Workflow

Polybrush belongs after the main space is already proven.

Stage	Better tool	Goal
First layout	ProBuilder or simple meshes	Test room size, movement, doors, stairs, and gathering areas.
Modular alignment	Installing ProGrids or built-in snapping	Keep floors, walls, and repeated pieces on a clean grid.
Visual refinement	Polybrush	Add subtle breakup, vertex color variation, surface blending, or detail placement.

If the room is still changing every hour, wait before using Polybrush. Brush work is easy to waste when the base geometry is not stable yet.

What Polybrush Is Useful For

Polybrush provides five brush modes in Unity's documentation:

• Sculpt moves mesh vertices.
• Smooth smooths differences between vertex positions.
• Color paints colors on the mesh.
• Texture paints and blends textures across the mesh.
• Scatter places or scatters prefabs on the mesh surface.

This can make environments feel less artificial without requiring every detail to be modeled by hand.

For example, a hallway blocked out with ProBuilder might feel too clean after the layout is approved. Polybrush-style work can help add subtle wear, color variation, or edge breakup without rebuilding the entire room in Blender.

Polybrush Shader Samples

Unity's Polybrush docs say the package includes sample shaders compatible with vertex colors and texture blending.

To import them:

1. Open Window -> Package Manager.
2. Select Polybrush.
3. Find the package Samples section.
4. Import the shader sample that matches your render pipeline or material workflow.

Unity imports these under Assets/Samples/Polybrush. If vertex colors or texture blending do not show as expected, confirm that your material and shader actually support the data Polybrush is painting.

Why It Matters

A scene built from repeated assets can look overly uniform very quickly.

Polybrush-style workflows help by letting you:

• Vary surfaces.
• Soften transitions.
• Add controlled randomness.
• Make repeated geometry feel less copy-pasted.

That is often more valuable than simply adding more and more separate props.

Good Beginner Use Cases

Polybrush is worth exploring when you want to:

• paint variation onto terrain-like surfaces
• reduce obvious repetition in modular areas
• place detail more organically
• add subtle visual breakup to an environment

It is most useful once the base scene is already in place and you want to improve how natural it looks.

Keep The Workflow Controlled

It is easy to overdo brush-based tools.

A better approach is:

1. Build the scene structure first.
2. Get materials and major props in place.
3. Save or duplicate the scene before brush-heavy work.
4. Use Polybrush to add controlled variation.
5. Test whether the result actually improves readability.
6. Check performance after the detail pass, not only before it.

The tool should support the scene, not make it noisier.

VRChat Checks Before You Keep Polybrush Detail

Before keeping a Polybrush pass in a VRChat world, check:

• The detail is visible enough to matter from normal player distance.
• The surface still reads clearly in VR and desktop.
• The material setup is not more complex than the visual result deserves.
• The detail does not distract from navigation, signage, portals, or event areas.
• The world still performs acceptably with avatars present.
• The edited meshes are named and organized so they can be revised later.

If the detail only looks good in a still screenshot, keep testing. VRChat worlds are experienced while moving, talking, and standing near other avatars.

Common Mistakes

Using brush detail before the environment is stable.

If the main structure is still changing, fine detail work is often wasted. Finish the blockout and snapping pass first, then paint detail after the space works.

Adding variation everywhere.

Too much variation can make the scene look messy instead of natural. Use it where repetition is obvious, then stop when the surface supports the room instead of calling attention to itself.

Ignoring performance impact.

Extra detail still has a cost, especially if it increases material complexity, scene density, or draw-call pressure. Test in the target world context, not only in an empty scene.

Painting over layout problems.

Polybrush can make a surface more interesting, but it cannot fix bad scale, awkward movement, unclear paths, or broken modular alignment. Fix those earlier with ProBuilder and snapping.

Best Practice

Use Polybrush after the main blockout and material setup are already working. Treat it like a refinement tool, not the starting point. Add variation where repetition is obvious, then stop once the scene feels more natural.

Helpful follow-up pages

• Tools
• Terrain
• ProBuilder
• Installing ProBuilder
• Installing ProGrids
• ProBuilder Blockout Workflow for VR Worlds
• Unity Performance Basics for VRChat Worlds
• Building a simple cartoon water shader

Final Advice

Polybrush is most effective when used with restraint. A little variation in the right places can improve a scene a lot more than heavy detail everywhere. Think of it as a finishing tool that helps unify and soften the environment.

Help! Should I use this tool in my main world immediately?

Try it in a test scene first. Once the workflow is clear, move the cleaned result into the main VRChat project.

Help! The tool created messy geometry or assets.

Clean naming, pivots, materials, and mesh organization before relying on the result. Tool output still needs normal world-building discipline.

References

• Unity Manual: Polybrush package
• Unity Polybrush package manual
• Unity Polybrush brush modes documentation
• Unity Manual: Install a UPM package by name
• Unity video: Make a Planet in Unity 2019 with Polybrush

Related Navigation

• Unity3D Documentation
• Unity Troubleshooting
• VRChat Documentation