System Requirements

Core Features

• Supports array operations for a single object or multiple objects within a collection.
• Provides three flexible array methods: Straight Array, Circular Array, and Curve Array.
• Easy-to-use control options: Adjust counts, rotation, scales, circular radius (for Circular Array), or random seed (for collection instances) with simple panel settings.
• Versatile compatibility: Lights, texts, and curves can also be arrayed using the plugin.

Usage Guide

Scenario 1: Single Object (Editable Mesh)

1.1 Straight Array

• Count: Number of arrayed instances.
• Distance: Spacing between each instance in the straight array.
• Rotation: Rotation angle of each instance.
• Scale: Size of each arrayed instance.

1.2 Circular Array

1. Select the circular center: Choose either the 3D Cursor or the object itself as the center point.
2. Set the align axis to determine the direction of the circular array.
3. Adjust parameters in the Array-Circular panel:
   1. Count: Number of instances in the circular array.
   2. Radius: Radius of the circular path.
   3. Rotation: Rotation of each instance along the circular path.
   4. Scale: Size of each arrayed instance.

1.3 Curve Array

1. Select a curve object to serve as the array path.
2. Bend control:
   1. If checked: The arrayed objects will bend along the curve’s shape.
   2. If unchecked: You can choose whether to use the curve’s direction. A object carrier will be automatically created to prevent deformation of the original object.
3. Adjust parameters in the Array-Curve panel:
   1. Fit type: How the instances fit along the curve (e.g., fit to curve length).
   2. Distance: Spacing between instances along the curve.
   3. Rotation: Rotation of each instance relative to the curve.
   4. Scale: Size of each arrayed instance.

Scenario 2: Multiple Objects, Lights, Texts, or Curves

1. Create a new collection and drag all target objects into this collection.
2. In the plugin panel, switch Target Type to Collection, then select the newly created collection as the target.

2.1 Straight Array (Collection)

1. Select a reference object: Its location will be used as the starting point of the array.
2. Choose between Instance or Reset Children for the collection (based on your needs).
3. Adjust parameters in the Array-Simple panel: Count, Distance, Rotation, Scale.
4. Random variation (optional): Check Random and adjust the seed to add randomness to the arrayed instances.
5. Important note: Before clicking the check mark to apply modifiers, confirm that all objects in the collection are editable meshes (if you need to apply modifiers).

2.2 Circular Array (Collection)

1. The 3D Cursor’s location will be used as the circular center (fixed setting for collection circular array).
2. Select a reference object: Its location will be used as the starting point of the circular array.
3. Choose between Instance orReset Children for the collection.
4. Set the align axis to determine the circular direction.
5. Adjust parameters in the Array-Circular panel: Count, Radius, Rotation, Scale.
6. Random variation (optional): Check Random and adjust the seed for random instance placement.
7. Important note: Before applying modifiers (check mark button), confirm that all objects in the collection are editable meshes.

2.3 Curve Array (Collection)

1. Select a curve object to serve as the array path.
2. Curve direction control: Choose whether to use the curve’s direction. A object carrier will be created to avoid object deformation.
3. Choose between Instance or Reset Children for the collection.
4. Set the align axis as needed.
5. Adjust parameters in theArray-Curve panel: Fit type, Distance, Rotation, Scale.
6. Random variation (optional): Check Random and adjust the seed to add randomness to the array.
7. Important note: Before applying modifiers (check mark button), confirm that all objects in the collection are editable meshes.

Limitations

• Multiple objects array: All target objects must be placed in the same collection. Use Target Type: Collection to start the array operation.
• Non-mesh objects (lights, texts, curves): These cannot be arrayed as single objects. You must create a new collection, add these objects to it, and then use Target Type: Collection.
• Collection array modifier application: When clicking the check mark to apply the "ARR.GN" modifier, if the collection contains non-editable mesh objects (e.g., lights, texts, curves), the modifier will not be applied (these objects cannot be realized as instances). However, you can still render the project normally while keeping the "ARR.GN" modifier enabled.

Notes