Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

[1.2.1] - 2025-10-31

[POLBR-28] Fixed an issue with compute-based raycasting and compute-based vertex color lerping that would write to VRAM outside the bounds of the destination stuctured buffer, which would lead to VRAM corruption, incorrect mesh rendering, and other graphical issues on Metal.

[1.2.0] - 2025-08-07

Changes

Updated minimum Unity version to 2022.3.
Added missing public API documentation for Math.

Bug fixes

[POLBR-30] Fixed an issue which would create unwanted files and folders in unrelated packages that contained Texture2d assets.
[POLBR-25] Fixed an issue where the texture list would disappear.
[POLBR-24] Fixed an issue where the texture brush painted incorrectly along the borders of a mesh when applying textures to multiple GameObjects.
Fixed an issue where blend shape frames for meshes are not transferred to the generated PolyMesh and then transferred back to the exported Unity mesh.

[1.1.8] - 2024-07-15

Bug fixes

[POLBR-22] Fixed compilation errors related to the use of FindObjectsByType in affected editors.

[1.1.7] - 2024-07-10

Bug fixes

[POLBR-20] Fixed a bug where moving the brush to an object that doesn't support painting would cause NullReferenceException errors.

[1.1.6] - 2024-02-13

Bug fixes

[POLBR-16] Fixed a bug where the brush would deactivate on a MouseDrag event after a MouseDown event.

[1.1.5] - 2023-08-01

Bug fixes

[case: POLBR-15] Fixed an issue that broke the application of Polybrush edits to ProBuilder meshes.

[1.1.4] - 2023-04-04

Bug fixes

[case: POLBR-7] Fixed an issue where brushes would not paint correctly on dense meshes.
[case: POLBR-9] Fixed an issue where undo would not work with polybrush meshes.
[case: POLBR-3] Fixed issue causing brushes to paint when navigating the scene using right mouse button.
[case: 1394848] Fixed preview mesh incorrectly truncating index buffer, resulting in broken mesh.
[case: POLBR-6] Fixed an issue where brushes would not work with meshes composed of very small triangles.

[1.1.3] - 2022-02-16

Features

Updated Settings Manager dependency to improve performance with Version Control.
[case: 1355575] Performance improvement on Asset Import (OnPostprocessAllAssets).
[case: 1294127] Improved performance by using ComputeShaders on some costly methods.

Bug fixes

[case: 1325318] Fixed Undo on prefab instances.
[case: 1394643] Hid ZoomOverride and OverlayRenderer in Inspector.

[1.1.2] - 2021-03-31

Features

Added new Simple Texture Blend shader example.
Added better support for prefab painting in 2D mode (placement and removal).
[case: 1197102] Added support for painting on multiple meshes.

Changes

Improved performance improvement when drawing wireframe and gizmos.
Removed obsolete "Lock Brush to First" preference.

Bug fixes

[case: 1324105] Fixed _Albedo1 texture in SRP shaders for texture painting.
[case: 1324106] Fixed problems in ProBuilderBridge functions and updates.
[case: 1322672] Fixed mesh collider update when modifying polybrush mesh topology.
[case: 1316957] Fixed errors when painting textures in the UV channels.
Fixed brush gizmo not showing the correct orientation in raise/lower and smooth modes.
Fixed wireframe not updating when applying changes in sculpting modes.
[case: 1314295] Fixed polybrush prefab painting with flat curve causing crash.
[case: 1306986] Fixed brush not registering correct placement when inside a concave mesh.
[case: 1315475] Fixed warning when opening Polybrush for the first time and pressing "Save" brush settings.
[case: 1314249] Fixed Undo on painting texture mode.
[case: 1305101] Fixed brush list not updated on new brush creation.
[case: 1305738] Fixed "Bake vertex stream" functionality.
[case: 1271427] Improving UpdateBrush performances, reducing calls to repaint method
[case: 1268586] Fixed erase problem when painting/removing prefabs where the pivot was too far from the brush
[case: 1271799] Fixed broken Copy/Paste of Prefab Settings
[case: 1270029] Fixed color palette does not disappear when dragged outside editor window.
[case: 1275880, 1275887] Fixed potential errors caused by out of sync material caches in Texture Painting mode.
[case: 1238128] Fixed Standard Texture Blend shader rendering black when graphics API is set to Metal.

[1.0.2] - 2020-08-04

Bug fixes

[case: 1259746] Fixed error when opening and closing display dialog to save brush.
[case: 1259770] Fixed on hovering above Settings tooltips always appear on centre of window.
[case: 1241241] Fixed null ref on adding or deleting PolybrushMesh component to Gameobjects without a MeshFilter.
[case: 1246495] Fixed PolybrushMesh component always marking the scene dirty when enabled.
[case: 1241241] Fixed null ref on Adding/Deleting "PolybrushMesh" Component to Gameobjects without a Mesh Filter
[case: 1171437] Fixed Export to Asset deleting the source mesh when overwriting an existing asset.
[case: 1192477] Fixed prefab scattering placing objects outside the brush radius when parent object transform is scaled.
Fixed errors thrown when vertex count changed between two strokes.
Fixed PolybrushMesh component staying on ProBuilderMesh object once painting is done.
Fixed Polybrush re-generating a new mesh when modifying a ProBuilderMesh.
Fixed errors thrown when deleting ProBuilderMesh object after modifications with Polybrush.
Fixed error Something went wrong saving brush settings happening when user deletes brush settings.
Fixed color preview not appearing when it should.
Fixed errors when unloading scenes in certain cases.
General performance improvements.

Known Issues

Lightmapping is currently not compatible with use of "Additional Vertex Streams". Workaround is to disable "Use Additional Vertex Streams" in preferences.

Changes

Updated to Settings Manager 1.0.3.
Documentation has been fully updated.
Renamed LWRP to Universal Rendering Pipeline.

[1.0.1] - 2019-09-05

Bug fixes

Fixed errors when entering playmode.
Fixed jagged geometry when smoothing with Brush normal.
Fixed broken normals in some situations.
Fixed compilation errors.
Fixed minor UI issues.

[1.0.1-preview.3] - 2019-08-21

Bug fixes

Fixed errors when entering playmode.

[1.0.1-preview.2] - 2019-08-01

Bug fixes

Fixed jagged geometry when smoothing with Brush normal.
Fixed broken normals in some situations.

[1.0.1-preview.1] - 2019-07-26

Bug fixes

Fixed compilation errors.
Fixed minor UI issues.

[1.0.0] - 2019-07-08

Changes

Added support for Unity 2018.4.
Using Polybrush on an object will always add the PolybrushMesh component.
PolybrushMesh component now allows you choose how mesh edits are applied (Override Mesh or Additional Vertex Streams).
Texture Blend Mode: shader setup is now done by clicking the "Configure" button in Texture Blend Mode, and saved into the shader meta file.
Removed obsolete example files, replaced with basic "Vertex Colored" and "Texture Blend" example shaders, built specifically for Non-SRP, LWRP, and HDRP.

Bug fixes

Fixed crash occuring when users convert from Additional Vertex Streams to Baked mode (and vice-versa).
Fixed crash occurring when users undo changes and not using Additional Vertex Streams.
Fixed loss of data when not using Additional Vertex Streams and Prefab mode.
Fixed Prefab mode not showing data from Polybrush when it opens.
Fixed erase action (hold CTRL) not removing data for only the selected texture in Texture Blend mode.
Fixed brush not showing the visual preview when hovering over meshes until first stroke.
Fixed brush not showing the proper visual preview for data removal when holding CTRL.
Fixed brush direction gizmo not matching the movement vector.
Fixed exception appearing sometimes while working with mirrored brushes.
Fixed Reset action on ColorPalette not properly resetting the data.
Fixed console warnings from Overlay and VertexBillboard shaders.
Fixed minor UI issues.

[1.0.0-preview.17] - 2019-05-13

Changes

Set "Use Additional Vertex Streams" default value to false.

[1.0.0-preview.16] - 2019-04-30

Changes

Added support for Unity 2018.3.

Bug fixes

Fixed an issue occurring when there is a vertex count mismatch between Additional Vertex Streams and the mesh referenced in the MeshFilter component.

Changes

Polybrush will automatically upgrade Z_AdditionalVertexStreams to PolybrushMesh components.
Added new section in documentations: Upgrading Polybrush.

[1.0.0-preview.14] - 2019-04-04

Changes

Polybrush will automatically upgrade Z_AdditionalVertexStreams to PolybrushMesh components.
Added new section in documentations: Upgrading Polybrush.

[1.0.0-preview.13] - 2019-03-20

Changes

Updated samples.

[1.0.0-preview.12] - 2019-03-20

Changes

Updated dependencies.

[1.0.0-preview.11] - 2019-03-13

Bug fixes

Minor fixes

[1.0.0-preview.10] - 2019-03-12

Bug fixes

Minor fixes

Changes

Made every modes use Ctrl key to invert actions.

[1.0.0-preview.9] - 2019-03-08

Bug fixes

Fixed compatibility issues with SkinnedMeshRenderer component.
Fixed compatibility issues with ProBuilder 4.
Scattering tool: fixed exceptions thrown when removing objects from palettes.
Scattering tool: fixed issues with prefabs having more than one mesh.

[1.0.0-preview.8] - 2019-02-26

Bug fixes

Fixed brush inner and outer rings not always reflecting user's Preferences.

[1.0.0-preview.7] - 2019-02-08

Bug fixes

Scattering tool: prefab preview compatibility with PolybrushMesh.
Scattering tool: fixed distance between objects being to great when Avoid Overlap is enabled.

[1.0.0-preview.6] - 2019-02-04

Bug fixes

Fixed Polybrush not able to paint on mesh with multiple submeshes.
Fixed scattering tool not removing prefabs based on the active loadout.
Fixed "Save To Asset" button in MeshFilter component not doing anything.
Small UI fixes.

[1.0.0-preview.5] - 2019-01-28

Bug fixes

Fixed scattering tool not removing prefabs in some cases.
Fixed "Fill" mode with the Texture Blend tool.
Fixed "Flood" mode with Vertex Color tool.
Small UI fixes.

[1.0.0-preview.4] - 2019-01-16

Changes

Updated Polybrush for Unity 2019.1 compatibility.
General settings are now in Unity Preferences window.
Updated Polybrush skin and improve Polybrush window reactivity.
Samples are now available through the Package Manager in their own section (Unity 2019.1+).

Bug fixes

Fixed PolybrushMesh component staying on GameObject even when we don't apply changes.
Fixed Undo actions not totally reverting back GameObjects state.
Fixed broken shader graphs for LWRP and HDRP.
Fixed Polybrush losing control when mouse cursor goes out of scene view while applying a brush.

[1.0.0-preview.3] - 2018-10-12

Features

Port Polybrush from Asset Store to Package Manager.
New prefab scattering brush mode settings.
Updated Polybrush for Unity 2018.1, 2018.2, and 2018.3 compatibility.
New example shaders for HDRP and LWRP.

Bug fixes

Updated ShaderForge examples to Unity 2018.1 and up.
Fixed Polybrush modified meshes losing values when converted to a prefab.
Fixed Undo not updating Additional Vertex Stream mesh modifications.
Fixed the detection of texture blend support when switching materials on an object.

Changes

Escape key now exits the brush editing tool.
Replace Save As with Save As New brush in the save menu of Brush Settings.
Removed legacy code for custom made shaders.
AdditionalVertexStream modified meshes are now stored in a component, fixing issues with lost data.
Dramatically improved unit testing coverage.
z_ prefix removed from class names.

[0.9.13-preview.0] - 2017-08-04

Bug fixes

Fixed compile error due to z_ZoomOverride.cs incorrectly being included in builds.

Changes

New example textures.

[0.9.12-preview.0] - 2017-06-19

Bug fixes

Fixed compile errors when building to Standalone.
Fixed issue where subdividing in ProBuilder could cause Polybrush to endlessly throw errors.

[0.9.11-preview.0] - 2017-04-25

Features

Added Flood paint brush in Vertex Color and Texture painting modes.
Added utility for baking additional vertex streams back to mesh.
Set better defaults for Push/Pull and Prefab modes.

Bug fixes

sRGB should be marked false on icons in 5.5 and up.
Fixed deprecated handle warnings in Unity 5.6.
Updated header backing color to match GUI Color Scheme.
Fixed bug where additional vertex streams would modify static meshes at runtime, causing them to either disappear or be moved.

[0.9.10-preview.0] - 2016-12-09

Features

Prefab Brush Mode added (still very early in development).
Significant performance improvements when working with high vertex count meshes.
Added a height based blend shader.
Added texture blend modulate shader.
Added option to hide vertex dots.

Bug fixes

Fixed bug where Polybrush would always instance a new mesh when "Meshes Are Assets" was enabled in ProBuilder.
Increase text contrast in Polybrush skins.
Try to crash less when mesh has no normals.
Fixed bug where loading a new scene would prevent brush from updating.
Fixed mismatched text color in command toolbar.
Fixed bug where hovering multiple selected objects would repeatedly instance new brush targets.
Fixed additional space in Color field labels when content is null or empty.
Fixed bug where hovering multiple meshes would sometimes apply the previous mesh vertex positions to the current.
Fixed brush settings anchor setting clipping the top header.
Fixed scene not repainting when applying brush in Unity 5.5.

Changes

Store some brush settings per-mode.
Preferences now stored local to project instead of in Unity Editor preferences.
Used hinted smooth glyph rasterization instead of OS default for Roboto font.

[0.9.9-preview.2] - 2016-11-14

Features

Redesigned interface.
Added support for "Additional Vertex Streams" workflow.
Unity 5.5 beta compatibility.
Added ability to save brush setting modifications to preset.
Enabled multiple axes of mirroring.
Show color palette as a set of swatches instead of a reorderable list.
Improved performance when painting larger meshes.
Handle wireframe and outline disabling/re-enabling correclty in Unity 5.5.
Clean up various 5.5 incompatibilities.
Added a question mark icon to header labels with link to documentation page.
Improved performance by caching mesh values instead of polling UnityEngine.Mesh.
Improved memory pooling in some performance-critical functions.
Manual redesigned to better match ProBuilder.
Mode toolbar now toggles Polybrush on/off when clicking active mode.

Bug fixes

Fixed cases where pb_Object optimize could be skipped on undo.
Fixed import settings for icons.
Don't leak brush editor objects if the brush target has changed.
Fixed serialization warnings on opening editor in Unity 5.4.
Marked z_Editor brushSettings as HideAndDontSave so that loading new scenes doesn't discard the instanced brush settings, resulting in NullReference errors in the Brush Editor.
Destroyed BrushEditor when z_Editor is done with it so that unity doesn't try to serialize and deserialize the brush editor, resulting in null reference errors.
Fixed texture brush inspector always showing a scroll bar on retina display.
Fixed bug where the texture brush would show a black swatch on the mesh after a script reload.
Removed shift-q shortcut since it's inconsistent and when it does work interferes with capital Qs.
Fixed bug where OnBrushExit sometimes wouldn't refresh the mesh textures.
Layer texture blend shaders instead of summing.

Changes

"Raise" mode is now "Push Pull."
Removed vertex billboards from mesh sculpting overlay in favor of just the wireframe.

[0.9.8-preview.0] - 2016-08-17

Features

Added option to make brush normal direction sticky to first application.

Bug fixes

Fixed Polybrush errors when working with pb 2.6
Don't specify isFallback in CustomEditor implementations since they are not actually fallback editors.
Don't rely on loaded assembly names matching the expected ProBuilderEditor assembly name when reflecting types and methods. Fixes null reference when assembly names are changed somewhere in the pipeline.
Don't bother testing that shader references match when looking for shader metadata since instance ids are so fickle in the first place

[0.9.7-preview.0] - 2016-06-01

Features

Significantly improved perfomance in all modes for high vertex count meshes.
Added "Texture Blend with Vertex Color" shader.
Added two new default meshes, a smooth and hard icosphere.
Texture Mode backend rewritten entirely to allow for far more complex interactions with shader properties. See "Writing Texture Shaders" in documentation.
Added color mask settings to vertex color painter.

Bug fixes

Improve performance of shared edge triangle lookups, fixing lengthy lags when mousing over high vertex count meshes in paint and texture modes.
When blending multiple brushes in texture mode use the max weight instead of summing.
Added information about setting shader paths to Hidden in Shaderforge instructions.
In vertex sculpting modes iterate per-common index instead of per-vertex, improving brush application performance and minimizing chances of splitting a common vertex by accident.
Minor cleanup of enum types (make sure they're namespaced & remove unused includes).
Fixed bug where script reloads would null-ify texture mode brush color and not properly reset it.
Fixed errors in brush event logic that caused OnBrushEnter/Move/Exit to be called at incorrect times with invalid targets, resulting in crashes when editing prefabs with multiple meshes with different shaders
Fixed undo throwing errors when splat_cache is null.
Clamp radius max value to min+.001 to avoid crashes when scrolling radius shortcut with equal min/max values.
Fixed uv3/4 not applying or applying to incorrect mesh channels in ProBuilder (requires update to ProBuilder 2.5.1).
Fixed null errors when sculpting pb_Object meshes caused by FinalizeAndResetHovering iterating the same object multiple times.

Changes

Set default brush settings radius max to 5.
When blending multiple brush effects use lighten blending mode instead of additive.
Shortened ShaderForge source file suffix to _SfSr (but keep compatibility for older _SfTexBlendSrc).

[0.9.6-preview.0] - 2016-04-28

Bug fixes

Fixed lag when selecting or hovering an object with large vertex count.
Increased the min threshold for vertex weight to be considered for movement in raise/lower mode.
Fixed out of bounds errors in overlay renderer when mesh vertex count is greater than ushort.max / 4.
Fixed typo that caused pb_Objects not to update vertex caches on z_EditableObject Apply calls.

[0.9.5-preview.0] - 2016-04-20

Bug fixes

114ccc2 Showed checkbox in z_Editor context menu for current floating state.
f44d4d6 When applying mesh values to pb_Object also include vec4 uv3/4 attributes.
c3d3f7a Fixed ambiguous method error in z_EditableObject when modifying a ProBuilder mesh.

[0.9.4-preview.0] - 2016-02-28

Features

Added new "Diffuse Vertex Color" and "TriPlanar Blend Legacy" shaders.

Bug fixes

Fixed Unity crash when selection contains non-mesh objects.

[0.9.3-preview.0] - 2016-02-22

Features

Added option to ignore unselected GameObjects when a brush tool is in use.
Improved detection of meshes in selected children.
Added button to clear Polybrush preferences in Settings.

Bug fixes

Fixed mirrored brush applying only one brush in texture and vertex paint modes.

[0.9.2-preview.0] - 2016-02-18

Features

Instead of a single readme, used a static site generator to build documentation.

Bug fixes

Fixed triplanar blend shader stretching on some poles. Added more detailed information on using vertex color and texture blend shader materials
When checking mouse picks for selection include children of selected gameObjects as valid targets (fixes issue where a selected model root would not register for brush.
Fixed null reference errors when brush mirroring is enabled.
Don't throw null ref when weights cache in overlay doesn't match new set.
Added docs for brush settings, interface, and general settings.
Added misc and troubleshooting section to docs.
Added warnings that Polybrush does not work on Unity terrain objects

Changes

Migrated project to Github. For access to the latest development builds of Polybrush please email contact@procore3d.com with your invoice number and request Git access (this will be automated in the future).

[0.9.1-preview.1] - 2016-01-01

Bug fixes

Register children of current selection as valid mesh editables. Fixes potential confusion when a model prefab is selected at it's root with children.

[0.9.1-preview.0] - 2015-12-01

Features

Texture Blend Mode now supports any combination UV0, UV2, UV3, UV4, Color, Tangent mesh attributes, as set by the shader using the syntax define Z_MESH_ATTRIBUTES UV0 ....
Improve the Unlit Texture Blend example shader.
Added option to automatically rebuild collision meshes.
Split Direction Normal into Brush Normal and Vertex Normal.
Improved the behavior of Smooth Mode.
Removed relax option from Smooth Mode (what was once Normal w/ Relax on or off becomes Vertex Normal and Brush Normal, respectively).
Added option to keep the brush focused on the first mesh hit when dragging.
When dragging, always restrict brush application to the current selection.

Bug fixes

Fixed issue where Texture Paint Mode would sometimes apply values to the incorrect channel after switching between two different materials with the same shader.
Made sure that the Texture Paint mode always has valid splat-weights to work with (usually causing "black face errors").
Fixed warnings when shaderforge isn't installed, and update version number.
Fixed instances where setting ProBuilder edit level would not correctly unset Polybrush tool (and vice-versa).

Changes

Standard Vertex Color and Standard Texture Blend shaders now default to metallic / roughness workflow.

[0.9.0-preview.0] - 2015-11-01

Initial Release.