Skip to content

Material Overrides

Synced materials arrive from Revit with their original names and properties. The Materials panel is where you take control of how they look in Blender — without breaking the sync connection. All overrides are non-destructive and you can reset any of them at any time.


Browsing materials

The material browser at the top of the panel shows all materials for the selected document.

  • Search — filter by name
  • Selected only — show only materials on currently selected objects

Each material row displays icons for any active overrides:

Icon Meaning
Globe Global override is active on this material
Refresh arrows A replacement material is active
UV-project UV preview is active
UV grid UV transform or randomize is active
Particles Scatter is active

Browser actions: Reset (selected material), Reset All, Select linked objects, Copy overrides, Paste overrides.

Screenshot needed: Material browser with override icons visible


Per-material overrides

Select a material in the browser to access its override subsections.

Screenshot needed: Material with multiple override subsections expanded

Ignore Global Override

When enabled, this material is excluded from the document's global override. Use this to protect specific materials from a scene-wide color or appearance change.

Preview UV

Enables a UV preview overlay on objects using this material. Useful for checking UV mapping before committing to an override.

Viewport Appearance

Controls the material's appearance in the Blender viewport (not in renders).

Field Description
Base Color Viewport display color
Metallic Metallic value
Roughness Roughness value

Render Appearance

Controls the material's rendered appearance via the Principled BSDF node.

Requires: Material nodes must be enabled on the material. If they aren't, open the material in Blender's Shader Editor and click Use Nodes.

Field Description
Base Color Render color
Metallic Metallic value
Roughness Roughness value
Alpha Opacity
Transmission Transmission (glass/translucency)

Material Replacement

Replaces this material with any Blender material currently in the scene. The picker shows only materials already present in the file — if the material you want isn't there yet, add it to the scene first. The replacement is applied on top of the synced data and can be reset at any time.

UV

Controls UV mapping for objects using this material.

  • UV Projection — enable and choose a mapping type
  • Transform — Translate, Scale, Rotation
  • Randomize Islands — Variation Seed, Rotation Variation, Offset Variation

Scatter

Scatter uses Revit's surface and placement data to distribute instances of a Blender object or collection across synced geometry — for trees, ground cover, furniture arrangements, and similar repeating elements. It's powered by a custom BSync node group that loads automatically — no manual node setup required.

Note: Scatter is available on any material that has an override. The required node group is loaded silently from the bundled add-on assets the first time it is used.

Field Description
Source The Collection or Object whose instances are scattered
Pick Instance How instances are selected from the source — randomly, sequentially, or by other criteria
Source Seed Randomization seed for instance selection. Change this to get a different mix from the same source
Density How many instances are placed per unit of area. Higher values produce denser coverage
Slope Limit Excludes surfaces steeper than this angle from receiving instances — useful for keeping trees off walls
Vertical Preference Biases instance orientation toward vertical (upright). At 0 instances follow the surface normal; at 1 they stand straight up
Lean Variation Adds a random tilt to each instance, so they don't all stand at exactly the same angle
Scale Variation Random scale range applied per instance
Distribution Seed Seed for placement positions. Change this to redistribute instances across the surface
Variation Seed Seed for per-instance variation (scale, lean, etc.)
Viewport Amount Fraction of instances shown in the viewport. Set below 1.0 to improve performance without affecting the final render