Installation procedure:

1. To install download the file named Addon_DPFR_DistributeObjects_#_##.py and save it to a convenient location.
2. Under Blender got to the Edit menu and open Preferences > Addons.
3. Press the button on top header that reads Install.
4. Browse to the location where you saved the downloaded file (like say the Downloads folder of the operating system), and double-click to install it
5. After installation the addon name will be visible in the list. Enable it with the check box to the left.

If you don't have Autosave Preferences enabled press the Save Preferences button on the bottom left, if you want the addon to remain available for future sessions by default as well.

Usage

To use the addon just select a portion of objects in the 3D View, then go to the 3D View header menu under Object > Transform > Distribute.

Parameters

Adjust settings as desired in the operator properties panel to the bottom left.

Star Point

The Start Point defines the place in the scene where objects will start to be arrayed at. Options include the

• 3D Cursor (default)
• Active Object, or
• World Origin (Scene [0,0,0]).

Sorting

Sort optional sorting for selected objects.

Can be left Unsorted (default), will use whatever order Blender internally defines (often object creation order), Sort by Name will make similarly named objects be placed together, Random will generate a new randomized order every time you pick it as an option, or by current X,Y or Z position in the scene, if you had already sorted them roughly beforehand.

All relevant methods have a counterpart reversed option to obtain the exact opposite order.

Spacing

Spacing X, Y and Z adjusts the spacing between each object for each of the axis.

Count

Count X and Y and Z limits the number of objects in each direction, forcing to start populating a new row or column after the limit is reached.

Maximum Distance

Maximum X and Y another type of limit defined by distance, after reaching defined distance a new row or column will be populated.

Axis

The addon works by default by distributing along X then Y then Z axis in this specific order by default. To stack objects exclusively on the Y or Z axis limit the count or distance of the previous axis to 1 or 0 respectively.

If you only want to distribute along the Y axis you can do so by limiting the count on the X axis to 1, so it wraps immediately and starts stacking along Y then Z instead.

If you want to stack on Z axis limit both X and Y to the count of 1.

Otherwise there is an Axis option which specifies in which order the axis should be populated, XYZ, XZY, YXZ, YZX , ZXY, ZYX .

XYZ

XZY

YXZ

YZX

ZXY

ZYX