Cloner System for Babylon.js

More info and explanations here - https://doc.babylonjs.com/communityExtensions/clonerSystem

TypeDoc Documentation - https://clonersystem.babylonpress.org/docs/

$3

• 
  Cloners: given one or several meshes, either clones or instances will distributed in a specific manner. If more than one mesh is provided, the meshes are distributed alternatively. Additionally, cloners can be nested, so it is possible to clone cloners. Each cloner can have several Effectors (in particular order) to influence the Scale/Position/Rotation parameter of a clone (or cloner). A sensitivity parameter controls this influence for a cloner. Following Objects are designated:
  


• 
  RadialCloner: radial distribution where following parameters are recognized: input-meshlist, count, radius, offset, startangle, endangle, Effector-sensitivity for Position, Scale and Rotation, alignment-flag, orientation.
  


• 
  LinearCloner: linear distribution where following parameters are recognized: input-meshlist, count, offset, growth, Effector-sensitivity for Position, Scale and Rotation. An interpolation-mode-flag  determines, if the clone -parameters (Scale/Position/Rotation) are interpreted as "step" or "end"-values.
  


• 
  MatrixCloner: distribution in 3D space where following parameters are recognized: input-meshlist, mcount, size.
  


• 
  ObjectCloner: distribution over faces of a mesh where following parameters are recognized: input-meshlist, reference-mesh.
  


• 
  RandomEffector: influences Scale/Position/Rotation of a clone with repeatable random values, controlled with an overall "strength" parameter.
  

Demo

The demo with all cloners (animated) - https://clonersystem.babylonpress.org/ (the default example scene for this repo)

The demo with all cloners (static) - https://babylonpress.org/cloner/

Extensive old version documentation - https://doc.babylonjs.com/communityExtensions/clonerSystem

$3

https://playground.babylonjs.com/#1MYQ3T#47

https://playground.babylonjs.com/#1WRUHY#2

https://www.babylonjs-playground.com/#1NYYEQ#5

https://www.babylonjs-playground.com/#1NYYEQ#6

https://www.babylonjs-playground.com/#1NYYEQ#7

https://playground.babylonjs.com/#JWETXJ#0

Import and Usage

npm i bp-cloner

Import needed Cloners like

import { RandomEffector } from "bp-cloner";
import { MatrixCloner } from "bp-cloner"

Then use like

        const mc = new MatrixCloner([capsule, box, sphere], scene, {

            mcount: { x: 5, y: 5, z: 5 },

        });



        mc.root!.position = new Vector3(-10, 0, 15);

		const rr = new RandomEffector();

        rr.strength = 1;

        rr.position = { x: 2, y: 0, z: 2 };

        rr.rotation = { x: 70, y: 30, z: 0 };

        mc.addEffector(rr, 1);

Or if you use