Ultimate Array
Ultimate Array — Documentation
Blender 3.3–5.3 · one zip · Tachyon Studio
Ultimate Array treats every kind of array as one mechanism. You pick a distribution — where the copies go — and the same pipeline runs under it every time: payload, distribution, falloff, variation, masks and output. The same viewport handles mean the same thing on every distribution, and every setting is a property of the object you array, like a modifier: there is no controller object to keep track of.
Requirements - please read before buying
- Blender 3.3 – 5.3. One zip for the whole range: an Extension on Blender 4.2 and later, a classic add-on on 3.3 – 4.1.
- Nothing else to buy or install. No other application, no plugin, no compiled libraries — the add-on is pure Python.
- Platform: developed and tested on Windows. It has no operating-system-specific code.
- Network: none. The add-on opens no connection; the Join Discord, Website and Store buttons on its preferences page only open your browser.
- Licence: GPL-3.0-or-later, like Blender itself.
Installation
The same zip installs on every supported version; each Blender reads the part of it that it understands.
Blender 4.2 and later: drag the zip into the Blender window, or Edit ▸ Preferences ▸ Get Extensions ▸ the drop-down arrow (top right) ▸ Install from Disk… and pick the zip. Blender 3.3 – 4.1: Edit ▸ Preferences ▸ Add-ons ▸ Install…, pick the zip, then tick Ultimate Array.
Once it is enabled, the 3D viewport's sidebar has an Ultimate Array tab (press N if the sidebar is closed).
Getting started
- Select a mesh in Object Mode.
- Press Ctrl+Alt+A. The Create pie opens; pick Radial (the left slot).
- The array builds at once and Adjust opens: move the mouse to change the radius, scroll to change Count, or type a number. Enter keeps it, Esc puts everything back.
- Press N and open the Ultimate Array tab: the viewport card shows every setting of the array. Change any of them and the array follows.
- Drag the handles drawn on the array in the 3D view — the radius, the count, the axis.
- When it is done, leave it live, or press … on the card for Make Real or Apply.
Count N gives exactly N. The source object is one of the copies: a ring of 6 is the source plus 5 copies, and the card's header counts what is drawn, the source included. The source's own Location never changes — where it has to sit on its slot (on a surface, along a curve, on a moved ring), it gets there through its Delta Transform.
The viewport card
Open the sidebar's Ultimate Array tab and the add-on draws itself as a card in the 3D view, beside the sidebar, with every control on it. Rest the pointer on any control and an animated explanation opens beside the card.
- The header names what you are editing (Base or a stage), how many instances are drawn and the array's real Size, with Build (it reads Rebuild once the array is live), Adjust, Clear and … (Make Real, Apply).
- Search — type the name of a setting or a button; it is found even inside a closed folder, and Enter goes to it.
- Favorites — right-click any control to pin it; pinned controls gather in one folder. Right-click a pinned one to let it go.
- Mini Card — folds the card down to its header, the distribution and Build. Double-click the header to open it again.
- Card Width — hold either side edge of the card and drag.
- Back to the sidebar — the button at the top right of the card puts an ordinary sidebar panel in its place, with the same controls; that panel's Switch to the Viewport Card brings the card back. Ctrl+Alt+Shift+C shows or hides the card.
The seven layouts
Every layout carries every control; a layout only changes where they are. Pick one in the add-on's preferences, Design tab.
| Layout | How it reads |
| Icon Rail (default) | A slim labelled rail down the left edge switches whole pages: Array, Place, Features, Stack, Output |
| Preview-led | The array's picture first, then the build row, the distributions as tiles and every feature as a tile that opens in place |
| Command Line | Search first; the array reads as one sentence whose words you change in place |
| Pipeline | The array as it is made: Source, Distribute, Modify, Output, as numbered stages that each fold to one line |
| Layer Stack | Like a modifier stack: the distribution is the bottom layer and what is in use stacks above it |
| Live Chips | Every group is a chip with a tiny live preview of what it would do to this array |
| Hero & Dial | A big live picture, the distributions on a ring with knobs to drag, features as an icon tray |
The Icon Rail's pages
- Array — the distribution and its own settings, Presets, the Bounding Cage, Set Size, Reset Distribution.
- Place — Profile & Aim, Paint Array, Projection, Snapping, Repel / Attract, Spread in Grid.
- Features — Payload, Falloff, Variation, Camera Culling, Overrides, Density Mask, Exclusion, Frame, Materials, More.
- Stack — the Array Stack: the Base and every stage, and the total they make together.
- Output — the Output mode, Merge Distance, Bake to Keyframes, Animation Presets, and Batch Build / Apply All for the whole selection.
The distributions
Eleven. Pick one from the pie or on the card's Array page.
- Linear — a straight run. Mode: Relative (in multiples of the object's own size — 1.0 just touches), Constant (a fixed distance), or Fit Length (Count spread so the first copy's origin and the last's are that far apart).
- Grid — a 3D lattice: Counts and Spacing per axis, Centered, Stagger for brickwork, and Fill Gaps for the holes between neighbours. 4 × 3 × 1 is twelve.
- Radial — round a circle or an arc: Radius, Axis, Arc, Arc Start, Radius X / Y for an oval, Center Offset, Rotate Instances and Point to Center.
- Spiral / Helix — Radial with Turns and Rise; Radius Start and Radius End apart open or close the spiral.
- Sunflower — seed packing by the golden angle. Radius Bias 0.5 spreads by equal area; Use Parastichy Numbers dials the angle from two Fibonacci arm counts. A new Sunflower starts flat.
- Curve — along a curve, never bent: by Count or by Spacing; Align None, Tangent or Full; Trim Start / End, Offset, Resolution.
- Surface — on a mesh: one per face, vertex or edge, or Scatter by face area. Align to Normal stands the copies up out of the surface; Normal Offset lifts them; Scale by Area sizes them by their face.
- Point to Point — from the object to an End Target, or to an End Offset. With no End Target, Build starts Place End Point: a ghost you grab and put where the run should end, previewing the copies in between, then Confirm. Include Endpoints decides whether both ends are occupied.
- Mirror — reflections across one, two or three axes (2, 4 or 8), through a Mirror Plane you can move.
- Volume Fill — inside a closed mesh, with a Wall Margin from its walls. An open mesh is refused, with a note saying why.
- Painted — the copies along the strokes and on the points you paint with Paint Array (below).
For runs (Linear, Curve, Point to Point and the like), Profile & Aim on the Place page bunches the spacing toward one end, both ends or the middle, and turns every copy toward its neighbour or toward an object.
Paint Array
On the Place page. Paint on the surface under the brush:
| Key | Does |
| 1 Path | a stroke the copies follow |
| 2 Line | straight runs between clicks |
| 3 Spray | a scatter inside the brush circle |
| 4 Lasso | a filled outline |
| Ctrl | erase |
| F | brush size |
| Ctrl+Z | take back the last stroke |
| Enter | finish |
Path and Line strokes are kept as a curve, Spray and Lasso as a point mesh — editable geometry. Paint more any time. Stroke Spacing, Density, Smooth, Snap Stroke, Pressure, Mirror and Paint On sit on the card. The Painted distribution then turns the copies: Align (None, Along Stroke, Surface), Track and Up Axis, Height, Flip, Spin, Random Spin, Bank, Start Offset and End Trim.
Shaping an array
- Falloff ramps Translate, Rotate and Scale from the first copy to the last, with Linear, Smooth, Ease In, Ease Out or a Custom Curve you draw. Ramp Across: Distance ramps by distance from the 3D cursor, the array's origin or an object instead. Phase slides the ramp along the array; keyframe it and the falloff travels.
- Variation gives every copy its own seeded Jitter, Rotation Jitter and Scale Jitter, or reads a Variation Texture. The same Seed always gives the same array.
- Repel / Attract pushes copies away from an object; a negative Strength pulls them in.
Which copies stay
These skip copies; none of them moves one.
- More ▸ Every — a regular gap (take one out of every N, or keep one of every N). Minimum Spacing refuses a copy that lands too close to one already kept.
- Exclusion — removes the copies inside another object's bounds, sphere or real mesh, or keeps only those. Margin grows the region.
- Density Mask — thins by a painted Vertex Group, a Mask Texture, By Slope or By Height. Invert Mask flips it.
- Camera Culling — skips what the camera cannot see, with a Cull Margin past the frame. Nothing is destroyed: turn the camera and the copies come back, and the array follows the camera as it moves.
What goes in each slot
-
Payload — Self, another Object, or a Collection cycled through with Pick Mode: Sequential (in order, then holds the last), Alternating (wraps round), Random, or Weighted (by each member's
ua_weight). Cap Start / Cap End put a different object first or last. - Materials — Material Variation gives each copy a material from a list, overriding only the Target Slot you name, without copying the mesh. Objects and Merged output.
- Overrides — on Objects output, move a generated copy by hand and press Pin Instance: that move survives every rebuild. Show Numbers, Select Overridden, Remove Override and Clear All Overrides manage them.
- Use Selection arrays every selected object at once, keeping their layout or one each in turn.
Where an array is built
- Frame — the source, the 3D cursor, the world, another object, the view, the camera, a bounding-box point, or a new Controller Empty. Orbit The Frame centres the ring on the frame with the source on it.
- Pivot to Cursor moves the array's centre to the 3D cursor; Cursor to Pivot goes the other way. Pivot Object spawns an Empty you can keyframe, parent or constrain.
-
Array Stack — arrays of arrays. Add Stage repeats everything so far as one unit: a Radial of 6 with a Linear stage of 4 is
6 × 4 = 24instances, on one object. Each stage has its own distribution, falloff and variation. Select Base goes back to editing the base. - Spread in Grid — lays out the objects you already have in a grid. It copies nothing; Spacing and Columns stay live until you Confirm or Cancel.
Outputs
| Output | What you get |
| Instances (Modifier) (default) | One live Geometry Nodes modifier. Fastest; mesh sources. Every change applies live. Carries ua_index and ua_random for shaders. |
| Objects | Real duplicates in a hidden child collection, individually selectable. Works on lights, cameras, curves and empties too. Rebuild with one press. |
| Merged | Build, then join into one mesh with Merge Distance and normals recalculated. One-way. |
| Collection Instances | Each copy an Empty instancing a whole collection — kit pieces that stay one unit. |
| Cutter | The array becomes holes in another mesh (Cut Into), through one Boolean modifier: Difference, Union or Intersect, Exact or Fast. A Cutter cuts once: change the settings, then Cut again. Count N cuts N holes. |
Projection (drop the finished layout onto a surface) runs on Objects and Merged output; on Instances its controls are greyed out with the reason.
Finishing
- Make Real — the copies become independent objects, each with its own mesh.
- Apply — the source and every copy join into one mesh and the array settings are forgotten. Undo is the way back.
- Batch Build copies the active object's array onto every selected mesh; Apply All applies every array on the selection.
- Clear removes every copy and resets the array's settings; Ctrl+Z brings it back.
Animation
Every array setting can be keyframed or driven; the array follows during playback.
- Animation Presets — Wave (a cycling scale ramp), Stagger (an eased translate ramp) and Product Reveal (copies grow from nothing), each written as ordinary keyframes on Phase.
- Bake to Keyframes — sweeps a frame range and writes real keyframes onto the copies, so they keep animating without the add-on. Needs Objects output (offered as a convert). Clear Bake hands the array back to live animation.
- NLA strips that animate the array's settings are not followed; keyframe directly, or bake.
- Blender 4.4 has a one-frame lag on the first frame of a render; it is fixed in Blender 4.5, and every other supported version renders every frame.
Presets & Favorites
- Presets (Array page) save every setting of the array — never object pointers — in Blender's own preset menu, and drop it on any object. Six ship with it: Bolt Ring, Brick Wall, Fence Posts, Spiral Staircase, Sunflower and Tapered Column.
- Favorites: right-click any control to pin it.
The pie and Adjust
Ctrl+Alt+A in Object Mode (rebindable in Preferences ▸ Keymap). On an object with no array it opens the Create pie; on a live array, the Actions pie. Each has a More slot that opens a second pie.
| Pie | Default slots |
| Create | left Radial, right Linear, down Along Curve, up Grid, top-left Point to Point, top-right Spiral / Helix, bottom-left Settings, bottom-right More (Surface, Sunflower, Mirror, Spread in Grid) |
| Actions | left Rebuild, right Clear, down Apply, up Add Stage, top-left Make Real, top-right Toggle Output Mode, bottom-left Settings, bottom-right More (Batch Build, Apply All, Cursor to Pivot, Animation Presets, Pivot to Cursor) |
Every slot can hold any distribution, any action, Settings, More or nothing: preferences, Pies tab. Restore Default Layout puts them back.
Adjust opens when the pie builds an array (and from the card's Adjust button):
| Input | Does |
| Mouse | drags the main value (Radius, Offset, Rise…) |
| Wheel | Count (on a Grid, its counts) |
| Digits | type an exact value |
| Tab | the next value |
| X / Y / Z | one axis |
| Shift | fine |
| Ctrl | snap to round values |
| Space | pause, to orbit the view |
| Enter / left click | keep |
| Esc / right click | put everything back |
Viewport handles
Every live array carries handles in the 3D view, coloured by meaning on every distribution: teal for size (radius, offset, extent), violet for count, magenta for the pivot and free moves, Blender's own red / green / blue for anything bound to an axis, and the accent blue for Falloff. Arrows move along a direction, dials turn, bars count. Hover a handle to read its name and value; Ctrl snaps while dragging; each drag is one undo step. The Bounding Cage swaps them for a box you drag by its faces, edges and corners (Alt for uniform); Set Size types the overall size instead.
Preferences
Edit ▸ Preferences ▸ Add-ons ▸ Ultimate Array opens the add-on's own drawn page, with five tabs:
- Design — the seven card layouts, each shown as a live picture of your card.
- N Panel — the card's position, width, opacity, density, text size, accent colour and where it shows; Export, Import and Reset of its settings.
- Pies — every slot of both pies.
- Viewport — the drag readout and the handles.
- Limits — when a big array warns (2,000 instances), when Objects and Merged refuse to build (5,000), the hard ceiling (100,000) and the live animation limit (2,000).
The page also carries Join Discord, Website and Store, and a switch to Blender's classic preferences layout.
Files without the add-on
Objects output is real linked duplicates; Merged is an ordinary mesh; the Instances modifier's node group is saved in the .blend and still evaluates — it just cannot be edited from the card without the add-on.
Support
Questions and bug reports: the Tachyon Studio Discord — https://discord.gg/T4CkhDghNP
Ultimate Array — Tachyon Studio · tachyonstudio.net
Included
Includes 12 months of
- Support from Tachyon Studio
- Product updates
Extend this product’s Support Period +12 months: 50% of product price
Have questions before purchasing?
Login to message
Discover more products like this
Radial Array instancing layout hard surface scatter modeling distribution pattern paint procedural geometry nodes array