Page Contents ×


This page provides information on the Particle Instancer.


The VRayInstancer plugin creates instances of objects over a variety of supported particles input: ParticleFlow system, Alembic particles loaded through VRayProxy, Thinking particles, and PRT particles loaded with KrakatoaPRTLoader. In comparison to the Particle Flow itself, which can only work with mesh objects, the VRayInstancer can instantiate any renderable object, including VRayProxy, lights, hair, displaced objects, Alembic particles (through VRayProxy), etc.

The source code for the VRayInstancer plugin is included with the V-Ray SDK.


UI Path: ||V-Ray menu|| > Create > Geometry > V-Ray Instancer


||V-Ray menu|| > Create > Geometry > V-Ray Instancer

||Create menu|| > V-Ray > V-Ray Instancer


||Command panel|| > Create tab > Geometry > V-Ray category > VRayInstancer



Instance mode – Specifies how particles are associated with one of the source objects.

Cycle – The first particle is assigned the first source object, the second particle - the second object etc., with the source objects list wrapping back to the beginning.
Random – Each particle is randomly assigned a source object based on its particle ID.
By particleInteger – Source objects are assigned based on the .particleInteger value of each Particle Flow particle. This value can be customly scripted in the Particle Flow system.

Source objects – A list of source objects that are instanced over the particle system. The way source objects are associated with particles is controlled by the Instance mode parameter.

Add/Remove – Add or removes source objects from this list.

Remove All – Remove all source objects from the list.

Particles – A list of particle systems that are used to create the instances.

Add/RemoveUse the two buttons to add or remove particle systems from this list.

Remove All – Remove all particle systems from the list.



Particle Flow Parameters

All Particle Flow Events – When enabled, all particle flow events of the particle systems specified in the Particles list are used. When disabled, VRayInstancer only considers the events specified in the Particle Flow Events list for generating instances.

Add/Remove – Use the two buttons to add or remove particle flow events from this list.

Remove All – Removes all particle flow events from the list.




Icon text – When enabled, shows the VRayInstancer icon text in the viewport.

Random seed – When the Instance mode is set to Random, this parameter allows you to change the seed used for the random distribution.

Render % – Allows you to render only a portion of the instanced geometry. The number of rendered instances is determined as a percentage of the total instances.

Override node properties – When enabled, allows global override of the object properties of the instances by the properties specified in VRayInstancer.

Multithreaded – An experimental option to use multithreaded generation of the instanced meshes.




  • VRayInstancer uses the materials assigned to the instanced geometry, unless a material is specified in the Particle Flow system. In that case the particles' material is applied. This feature is not yet available with V-Ray GPU.