Cloner

Cloner

Script for Adobe Illustrator

✦ Available exclusively on Patreon for Pro supporters.

ㅤ

Description

Cloner is an Adobe Illustrator script for creating precise repeated arrangements from one or more selected objects. It combines eight cloning modes with live preview, dedicated Settings, Editor, Randomize, and Presets workspaces, direct-manipulation controls, precise numeric input, reusable presets, stacking controls, opacity transitions, deterministic randomization, and fast visual tools for building anything from simple rows to complex radial, honeycomb, wave, and Fibonacci patterns.

ㅤ

Features

Cloner provides a single, responsive interface for constructing and refining object-based patterns without manually duplicating and positioning every instance.

  • Eight cloning modes: Create Linear, Grid, Honeycomb, Radial, Spiral, Random, Wave, and Fibonacci arrangements.
  • Four focused workspaces: Switch between Settings for precise values, Editor for visual manipulation, Randomize for seeded per-instance variation, and Presets for reusable mode configurations.
  • Interactive Controls in every mode: Open the Editor tab to drag arrangement handles, scrub counts, adjust visual tracks, and switch mode-specific options directly in a live diagram. The active editor remains visible and enabled, while editors for other modes initialize on demand.
  • Shared source transforms: Editor includes icon-led Scale and Rotate controls that adjust the selected source appearance and every generated instance without changing the arrangement geometry. Preview remains non-destructive until OK.
  • Synchronized mode selectors: The complete eight-mode selector is available in Settings, Editor, and Randomize. Choosing a mode updates all three selectors in one coordinated change, refreshes only the visible interface, and queues one preview for the final selection.
  • Built-in searchable guide: Open a detailed, resizable User Guide dialog from the footer, browse by section or mode, and search the documentation without leaving Illustrator.
  • Live non-destructive preview: Preview changes using temporary staged objects that are removed when refreshed, cancelled, or confirmed. Cloner displays its dialog before building the initial preview, uses a shared 75 ms scheduler for rapid edits, and waits 200 ms after mode changes so quick navigation renders only the final selection. Clicking OK discards the preview and builds once from the original source objects so Preview ON and OFF preserve the same source identity.
  • Flexible numeric controls: Drag sliders, use the − and + buttons, press arrow keys, enter values beyond the visible slider range, or type calculations such as 100/2, 5*2, 100-50, and 5+10. Value-based tick marks, magnetic detents, and Shift-drag snapping make common round values easy to reach.
  • Practical count protection: Counts must be positive whole numbers. Cloner warns above 1,000 resulting objects and rejects requests above the hard limit of 10,000 objects across all selected sources.
  • Deterministic Random mode: Keep an arrangement stable with a visible Random Seed and generate a new variation only when requested.
  • Independent Randomize channels: Add stable X Offset, Y Offset, Size, Rotation, Opacity, Horizontal Flip, and Vertical Flip variation to any of the eight cloning modes, with independent channel seeds, per-channel dice actions, Randomize All, and seed Undo/Redo.
  • Grid sizing and gutters: Use fixed spacing or calculate spacing from object dimensions with adjustable horizontal and vertical gutters. Tall icon-only link controls sit beside the Columns/Rows and Horizontal/Vertical label pairs, with a divider separating count and spacing controls.
  • Honeycomb grid overlay: Display a temporary orange dashed hexagonal guide with evenly distributed, non-overlapping shared edges.
  • Radial orientation control: Keep the original orientation or rotate instances outward or inward along full circles and partial arcs.
  • Progressive transformations: Apply distribution, twist, scale, opacity, offsets, and stacking-order changes where supported.
  • Persistent interface settings: Restore saved custom values, selected modes, toggles, and preview preferences between sessions.
  • Reusable preset library: The Presets tab contains saved user presets only. Right-click its workspace tab to save the current settings without switching workspaces. Click a row to apply it; double-click its name to rename it; drag to reorder; or use the inline and right-click/Ctrl-click actions. Names are limited to 64 characters with collision-safe suffixes, and failed writes revert the visible change instead of pretending it was saved.
  • Reset and viewport tools: Reset individual values or all numeric controls, hide selection edges, fit the result in the window, and restore the launch view with a second Zoom-to-Fit click.
  • Stable dialog layout: The dialog uses a fixed width while adapting its height to the active workspace and cloning mode, preventing cropped controls or unused resize space.

ㅤ

Installation

1. Download the Cloner.jsx script file.

2. Place the script in your Adobe Illustrator Scripts folder:

⮑ Mac: /Applications/Adobe Illustrator (Version)/Presets/(Language)/Scripts

⮑ Windows: C:\Program Files\Adobe\Adobe Illustrator (Version)\Presets(Language)\Scripts

3. Restart Adobe Illustrator if it's already running

4. Access the script via File > Scripts > Cloner

5. Alternatively, run it directly via File > Scripts > Other Script... and browse to the file location

Tip: You can also drag and drop the .jsx file directly onto the Illustrator workspace to run the script instantly – no installation needed.

ㅤ

Using the Script

ㅤ

Launch the Script

Cloner needs an open Illustrator document and at least one selected object. The selected artwork becomes the source for the active cloning mode.

  1. Open or create an Illustrator document.
  2. Select one or more objects to clone.
  3. Run Cloner from File > Scripts > Cloner, use Other Script, or drag the JSX file onto Illustrator.
  4. Choose a mode from the synchronized color-coded selector in Settings, Editor, or Randomize.
  5. Enter precise values in Settings or manipulate the always-visible diagram in Editor while Preview is enabled.
  6. Click OK to create and group the final arrangement, or click Cancel to discard the preview.

ㅤ

ㅤ

Choose a Cloning Mode

Cloner opens with four workspace tabs: Settings, Editor, Randomize, and Presets. Settings contains precise mode controls, Editor contains the visual Interactive Controls, Randomize adds independent seeded variation to any arrangement, and Presets manages reusable mode configurations.

The color-coded cloning-mode selector is available in Settings, Editor, and Randomize. All three copies contain the eight arrangement types and stay synchronized. Switching modes updates the other selectors as one operation, shows the matching settings or editor, preserves each mode's values, and changes the interface accent. When Preview is enabled, rapid mode changes are combined and only the final selection is rendered after a brief pause.

  • Linear: Repeat objects along X and Y axes or along a custom direction.
  • Grid: Build rectangular grids with fixed spacing, object-size gutters, and alternating offsets.
  • Honeycomb: Place objects on pointy-top or flat-top hexagonal cells.
  • Radial: Arrange objects around a complete circle or a partial arc.
  • Spiral: Distribute objects outward through a configurable angular spread.
  • Random: Scatter objects reproducibly inside a defined rectangular area.
  • Wave: Position objects along sine, cosine, triangle, or square waves.
  • Fibonacci: Create phyllotaxis-style arrangements based on the golden angle.

ㅤ

ㅤ

➊ Linear Mode

Linear mode creates a sequence from the selected object using either independent axis offsets or a distance along a chosen direction.

image gallery
Linear Mode

Controls

  • Count: Sets the number of instances. The slider covers common values, while direct entry supports larger counts.
  • Movement: Switches between X / Y Axes and Custom Angle.
  • Horizontal and Vertical: Set independent movement per instance in X / Y Axes mode. Their sliders show 100-unit ticks and gently snap near those values.
  • Distance: Replaces Horizontal when Custom Angle is active and controls movement along the selected direction. Hold Shift while dragging to lock to 100-unit increments.
  • Direction: Sets the custom movement angle with the angle control or numeric field.
  • Distribution: Eases the spacing from the first instance to the last; zero produces even spacing.
  • Twist: Applies progressive rotation across the sequence.
  • End Scale: Applies progressive scaling from the source size to the chosen final percentage.
  • End Opacity: Blends from the source opacity to the chosen final opacity.
  • Link Horizontal & Vertical: Keeps both axis values synchronized in X / Y Axes mode.
  • Reverse Order: Reverses which instances occupy the sequence positions and stacking order.

Use zero on one axis for a straight horizontal or vertical row. Combine Distribution, Twist, End Scale, and End Opacity for eased motion trails and progressively transformed repeats.

In the Editor tab, the Linear Interactive Controls diagram lets you drag the endpoint to set X / Y movement or Distance and Direction, then refine Distribution, Twist, End Scale, and Opacity on its side tracks. Count can be scrubbed or stepped directly below the diagram.

image gallery
Tab: Linear / Count: 15 / Scale: 0
image gallery
Tab: Linear / Count: 15 / Twist: 90

ㅤ

ㅤ

➋ Grid Mode

Grid mode creates rows and columns with conventional spacing or spacing calculated from each source object's dimensions.

image gallery
Grid Mode

Controls

  • Columns: Sets the horizontal number of cells. Larger slider ticks mark 10, 20, 30, and subsequent 10-step values.
  • Rows: Sets the vertical number of cells with the same 10-step major ticks.
  • Horizontal and Vertical: Set the absolute distance between columns and rows when Use Object Size is off.
  • Use Object Size: Uses each object's width and height as the base cell spacing. Its toggle shares a row with Reverse Order.
  • H Gutter and V Gutter: Replace Horizontal and Vertical when Use Object Size is enabled. Positive values add space and negative values create overlap.
  • Link Columns & Rows: Keeps both grid counts synchronized. Its tall icon-only button sits directly beside the Columns and Rows labels and spans both input rows.
  • Link Horizontal & Vertical: Synchronizes either the spacing pair or the gutter pair. Its matching two-row icon button sits beside the Horizontal and Vertical labels, below the divider.
  • Offset: Chooses None, Rows, or Columns for an alternating brick-style shift.
  • Shift: Sets the alternating shift as a percentage of the active horizontal or vertical step.
  • Reverse Order: Reverses the assignment and stacking of instances and shares a row with Use Object Size.

Use Object Size with zero gutters creates edge-to-edge cells. A Rows offset with a 50 percent Shift produces a classic running-bond layout.

In the Editor tab, the Grid Interactive Controls diagram provides draggable X and Y spacing handles, column and row steppers, link toggles, Use Object Size, offset mode, Shift, and Reverse Order without leaving the visual grid preview.

image gallery
Tab: Grid / Rows: 3 / Columns: 8
image gallery
Tab: Grid / Rows: 3 / Columns: 8 / Offset Columns

ㅤ

ㅤ

➌ Honeycomb Mode

Honeycomb mode arranges instances on a true hexagonal grid using a shared cell radius.

image gallery
Honeycomb Mode

Controls

  • Columns: Sets the number of horizontal honeycomb cells; major slider ticks represent 10-step increments.
  • Rows: Sets the number of vertical honeycomb cells; major slider ticks represent 10-step increments.
  • Radius: Controls the distance from each hexagon center to its corners and therefore the grid spacing. The slider has magnetic 100-unit detents.
  • Orientation: Switches between Pointy Top and Flat Top cells.
  • Reverse Order: Reverses instance placement and stacking.
  • Grid Preview: Displays an orange dashed hexagonal overlay while Preview is active.

The grid overlay is created on a temporary non-printing top layer. Shared borders are drawn once, and each edge receives evenly fitted dash-gap cycles so overlapping cells do not produce solid-looking lines.

In the Editor tab, the Honeycomb Interactive Controls diagram shows the actual pointy-top or flat-top lattice. Drag the highlighted hexagon or Radius track, scrub Columns and Rows, change Orientation, reverse the order, or toggle Grid Preview directly in the editor. Grid Preview is aligned at the far right of the controls row for quick access.

image gallery
Honeycomb / Pointy-Top
image gallery
Honeycomb - Flat-Top

ㅤ

ㅤ

➍ Radial Mode

Radial mode distributes instances around a center using a radius and an angular range.

image gallery
Radial Mode

Controls

  • Count: Sets the number of radial instances.
  • Radius: Sets the distance from the center to each instance. Drag near a 100-unit tick to snap to it, or hold Shift to snap strictly in 100-unit increments.
  • Start Angle: Sets the first position in the circle or arc.
  • End Angle: Sets the final extent of the circle or arc.
  • End Opacity: Blends opacity from the first instance to the last.
  • Original: Preserves the source orientation.
  • Outward: Rotates instances to face away from the center.
  • Inward: Rotates instances to face toward the center.
  • Reverse Order: Reverses the placement and stacking order.
  • Randomize tab: Optionally adds independent X/Y Offset, Size, Rotation, Opacity, and horizontal/vertical flipping while preserving the underlying radial arrangement.

A 360-degree range creates an evenly spaced full circle without duplicating the endpoint. Partial arcs include both endpoints so the final object reaches the End Angle.

In the Editor tab, drag the Radial radius square or the start and end angle handles, scrub Count, and use Original or Full Circle shortcuts to restore common arc setups.

image gallery
A: Keep original orientation / B: Rotate outward / C: Rotate inward

ㅤ

ㅤ

➎ Spiral Mode

Spiral mode moves instances progressively from the center toward a maximum distance across an angular spread.

image gallery
Spiral Mode

Controls

  • Count: Sets the number of instances in the spiral.
  • Distance: Sets the maximum distance reached by the last instance. Its marked 100-unit positions provide magnetic detents; Shift-drag locks to those increments.
  • Spread: Sets the total angular range of the spiral.
  • Twist: Rotates instances progressively along the spiral.
  • End Opacity: Blends opacity across the sequence.
  • Reverse Order: Reverses placement and stacking.
  • Randomize tab: Optionally adds independent X/Y Offset, Size, Rotation, Opacity, and horizontal/vertical flipping while retaining the spiral's overall structure.

Increase Spread for additional turns and increase Distance for a wider spiral. Count 1 is supported and places a valid single instance without invalid coordinates.

In the Editor tab, drag the Spiral outer square to change Distance and use the visual tracks for Distance, Spread, Twist, and End Opacity. Count can be scrubbed or stepped below the diagram.

image gallery
Check the 'Reverse Order' box to reverse the spiral direction

ㅤ

ㅤ

➏ Random Mode

Random mode scatters instances inside a rectangular region while keeping the current arrangement stable during editing.

image gallery
Random Mode

Controls

  • Count: Sets the number of scattered instances.
  • Width: Sets the horizontal size of the distribution area.
  • Height: Sets the vertical size of the distribution area.
  • Link Width & Height: A compact vertical icon between the Width/Height labels and their aligned numeric fields keeps both dimensions synchronized for a square distribution.
  • Randomize tab: Provides shared X/Y Offset, Size, Rotation, Opacity, and horizontal/vertical flip controls.
  • Random Seed: Identifies the current deterministic arrangement and appears in Randomize.
  • Randomize All: Creates a new seed for the Random arrangement and every enabled Randomize channel while preserving disabled-channel seeds. The Random Editor also provides its own Regenerate control.

Changing Width, Height, or another Random option preserves the same seed, so the layout does not reshuffle unexpectedly. Record or reuse a seed when you want to reproduce a specific arrangement.

In the Editor tab, drag the Random area’s right, bottom, or corner handle to resize the distribution region. Its side tracks provide direct access to the shared Rotation, Size, and Opacity amounts, while Regenerate produces a new seeded arrangement. The area rectangle is intentionally translucent so the scattered instances remain easy to inspect.

image gallery
A: Random Offset / B: Random Scale / C: Random Rotation

ㅤ

ㅤ

➐ Wave Mode

Wave mode spaces instances horizontally and offsets them vertically using one of four waveform calculations.

image gallery
Wave Mode

Controls

  • Count: Sets the number of instances along the wave.
  • Distance: Sets the horizontal spacing between instances. Minor ticks appear every 50 units, major ticks every 100, and Shift-drag snaps to 100-unit values.
  • Amplitude: Sets the maximum vertical displacement.
  • Period: Sets the number of wave cycles across the sequence.
  • Wave Type: Selects Sine, Cosine, Triangle, or Square.
  • End Opacity: Blends opacity from the source to the final instance.
  • Reverse Order: Reverses placement and stacking.
  • Randomize tab: Optionally adds independent X/Y Offset, Size, Rotation, Opacity, and horizontal/vertical flipping while preserving the selected waveform.

Sine and Cosine produce smooth paths, Triangle creates straight peaks, and Square creates stepped alternation. Increase Period for more frequent cycles or Amplitude for a taller wave.

In the Editor tab, drag the Wave D and A handles for Distance and Amplitude, refine the values on the side tracks, scrub Count, and cycle the waveform directly in the diagram.

image gallery
A: Sine / B: Cosine / C: Triangle wave type

ㅤ

ㅤ

➑ Fibonacci Mode

Fibonacci mode uses the golden angle and square-root radial growth to create natural phyllotaxis patterns.

image gallery
Fibonacci Mode

Controls

  • Count: Sets the number of instances in the pattern.
  • Spacing: Controls how quickly the spiral expands outward and must be greater than zero.
  • Rotation: Adds an orientation offset to every instance from −360° to 360°.
  • End Opacity: Blends opacity toward the outside of the pattern.
  • Reverse Order: Reverses instance placement and stacking.
  • Randomize tab: Optionally adds independent X/Y Offset, Size, Rotation, Opacity, and horizontal/vertical flipping while retaining the phyllotaxis structure.

Lower Spacing values create compact seed-like clusters. Higher values open the pattern for sunflowers, mandalas, particle bursts, and galaxy-style arrangements.

In the Editor tab, drag the Fibonacci outer square to change Spacing and use the visual tracks for Spacing, Rotation, and End Opacity. Count can be scrubbed or stepped below the diagram.

image gallery

ㅤ

ㅤ

Editor and Interactive Controls

The dedicated Editor workspace uses the supplied pointer-click icon and always displays the Interactive Controls for the currently selected cloning mode. Its mode selector mirrors those in Settings and Randomize, and edits made in the diagram remain synchronized with the precise numeric controls.

  • Choose a mode: Use the color-coded selector in Settings, Editor, or Randomize. All three selectors remain synchronized.
  • Always available: The active mode's editor is visible and enabled whenever Editor is open; each editor is initialized on demand the first time its mode is shown.
  • Drag arrangement handles: Use the highlighted handles in the diagram to reshape the active arrangement directly.
  • Scrub or step counts: Drag the displayed count, or use the − and + buttons when present.
  • Use visual tracks: Drag a parameter track to make a focused adjustment while watching the arrangement update.
  • Scale the source: Use the icon-led Scale control and numeric field below the canvas to resize the selected source and every instance together. Its 0–200% track has twenty 10% divisions, starts at 100% in the center, and extends left for reductions or right for enlargements; the enforced minimum is 1%, and the field accepts values above 200%. This multiplies mode-specific and randomized scaling without changing arrangement spacing.
  • Rotate the source: Use the adjacent Rotate control and numeric field to rotate the selected source and every instance. The track covers −180° to 180° with 5° minor ticks, 10° major ticks, and gentle 5° magnetic detents, while the field accepts angles beyond that range. Rotation is added after mode-specific orientation and before per-instance Randomize variation.
  • Use modifiers: Hold Shift while dragging to snap to a control-appropriate round interval: commonly 10, 15° for angles, or 100 document units for Radius and Distance.
  • Reset the editor: Option-click on macOS, Alt-click on Windows, or right-click the interactive canvas to restore that editor's defaults.
  • Keep exact control: Switch to Settings whenever an exact numeric value is required.

The dialog is intentionally not manually resizable. It changes height automatically when switching workspaces or modes, keeping every control aligned and visible.

ㅤ

ㅤ

Presets

The Presets workspace contains a permanent built-in Default preset plus reusable settings you create for individual cloning modes.

image gallery
  • Default: The first row restores all modes, shared Editor transforms, Randomize channels, visibility options, and the active mode to their built-in values. Its fixed seed keeps the reset result reproducible. Default cannot be renamed, deleted, or reordered.
  • Save Preset: Captures the current mode and that mode's settings, adds a numbered row, and opens its name for editing. Pressing Enter while the Presets tab is active also starts this action unless a name or context menu is already open.
  • Quick Save: Right-click the Presets workspace tab from Settings, Editor, Randomize, or Presets to save immediately without changing workspaces. The new preset uses the next available numbered name and can be renamed later.
  • Apply: Click a row to load its mode-specific values and make that cloning mode active without replacing settings belonging to other modes.
  • Mode-colored badges: Default is marked D; each user preset is numbered and uses the accent color assigned to its saved cloning mode.
  • Rename: For a user preset, double-click only the name line, use the inline rename icon, choose Rename from the context menu, or click Rename Preset. Enter saves, Escape cancels, and leaving the field saves. The complete name is selected when editing begins.
  • Delete: Hover a user preset for the inline delete action, choose Delete from its context menu, or click Delete Preset.
  • Reorder: Right-click, or Ctrl-click on macOS, to open Rename, Delete, Move Up, and Move Down commands for user presets. User rows can also be dragged into a new order beneath Default.
  • Names: Preset names are limited to 64 characters. If a normalized name already exists, Cloner reserves room for a numeric suffix and creates a unique final name.
  • Immediate persistence: Saving, renaming, deleting, and reordering presets writes the library immediately, even if the main dialog is later closed with Cancel. If writing fails, the in-memory change is reverted and the Presets panel title shows Save failed; hover the panel for details.

Use Default to reset the complete script, or use individual reset controls when only one value should change.

ㅤ

ㅤ

Randomize

The dedicated Randomize workspace applies deterministic per-instance variation after any of the eight arrangement modes has built its base layout. Its frameless layout keeps every channel and its right-side dice button visible within the dialog width.

  • Randomize ON / OFF: Temporarily bypasses or restores all seven channels for an immediate before-and-after comparison. It preserves every channel toggle, amount, and the current seed.
  • Per-channel shuffle: Click the dice button at the right of any enabled channel to generate a different pattern for that property without changing the other six channel seeds. The new seed is also shown in the Random Seed field.
  • Randomize All: Uses a prominent button matching the master toggle's size to regenerate enabled channels and the Random mode placement together. Disabled-channel seeds remain unchanged.
  • Seed history: The Random Seed label and field are left-aligned. Use the adjacent Undo and Redo buttons to move backward or forward through individual-channel and Randomize All seed shuffles. A typed seed remains a draft until Enter is pressed or the field loses focus; committing it or applying a preset begins a fresh history.
  • X Offset: Moves each instance left or right by up to the chosen amount in document ruler units.
  • Y Offset: Moves each instance up or down by up to the chosen amount in document ruler units.
  • Size: Scales each instance above or below its arranged size by up to the chosen percentage, with a 1% minimum.
  • Rotation: Rotates each instance clockwise or counterclockwise by up to the chosen angle.
  • Opacity: Reduces each instance's arranged opacity by up to the chosen percentage, clamped at 0%.
  • Flip Horizontal: Gives each instance an independent 50% chance of mirroring left-to-right.
  • Flip Vertical: Gives each instance an independent 50% chance of mirroring top-to-bottom. Enabling both channels can flip an instance on both axes.
  • Independent toggles: Click a channel's icon or label to enable it. Disabled labels, sliders, −/+ icons, and reset controls appear faded and have no effect.
  • Stable variation: Changing an amount scales the same seeded values instead of generating a different pattern on every preview refresh.
  • Random Seed and Randomize All: Enter a positive integer to establish a common seed for all channels, or click Randomize All to assign a new seed only to enabled channels. The displayed seed also drives Random mode placement, while per-channel dice actions create tracked seed overrides; Undo and Redo restore earlier or later complete seed snapshots.
  • Reset and persistence: Right-click a slider or use its reset control to return its amount to 0. Channel states, amounts, and independent seeds are saved with settings and presets.

Randomize is separate from Random mode: Random mode defines a scattered base layout, while Randomize can add controlled irregularity to that layout or to any structured mode.

ㅤ

ㅤ

Preview and View Controls

Preview uses temporary duplicates, leaving the original objects untouched until the result is confirmed.

The dialog is displayed before the initial preview is generated. Mode changes use a 200 ms trailing delay, so moving quickly across several modes rebuilds the document preview only for the final selection.

  • Preview ON / OFF: Enables or disables live generation while values change.
  • Hide / Show Edges: Deselects or reselects preview objects without changing Illustrator's global edge-display preference.
  • Zoom to Fit: Fits the current preview or source selection in the active window. Click it again to restore the center and zoom captured when Cloner launched.
  • Honeycomb Grid Preview: Adds or removes the temporary dashed hexagonal overlay independently of the final artwork.

Refreshing or cancelling Preview removes only the objects generated by Cloner. It does not call a generic Undo command, so unrelated document history remains safe.

Each refresh is staged completely before the originals are hidden. If any selected source cannot be duplicated or generation fails, Cloner removes the partial staging result, restores the originals, turns Preview off, and reports the failure.

ㅤ

ㅤ

Precise Input and Reset Controls

Every numeric row supports several input methods for quick exploration and exact values.

  • Slider: Drag to adjust within the displayed range. Tick positions are based on actual values rather than equal visual subdivisions.
  • Magnetic ticks: Radius and Distance sliders gently settle on nearby 100-unit marks without preventing values between them.
  • Rows and Columns ticks: Small ticks represent single steps; larger ticks represent exact multiples of 10.
  • Shift-drag: Locks the active slider to a useful round interval—typically 10, 15° for angles, or 100 for large distance-based controls.
  • Minus and plus buttons: Change the value by one step; hold Shift for larger increments.
  • Text field: Type an exact value or a calculation using +, -, *, /, and parentheses, including supported values beyond the slider limits. The field changes to the result when you finish editing. Count, Rows, and Columns must resolve to positive whole numbers.
  • Arrow keys: Press Up or Down to adjust the focused numeric field; hold Shift to change by five.
  • Reset indicator: A colored dot marks a modified value; hover to reveal the reset arrow and click it to restore the default.
  • Row-label reset: Option-click on macOS or Alt-click on Windows to reset that row.
  • Slider reset: Right-click a slider to restore its default.
  • Reset all numeric values: Option-click or Alt-click Cancel to reset numeric controls without closing the dialog.

Incomplete input such as a minus sign, decimal point, empty field, or unfinished calculation does not become zero. Cloner keeps the last valid value until the edit is completed.

Before preview or final creation, Cloner validates every active numeric value. Linear End Scale accepts any finite value of 0% or greater, including values above its 200% slider range; opacity accepts 0–100%; Fibonacci Spacing must be positive and Rotation accepts −360° to 360°. Non-finite measurements and fractional counts are rejected with a specific message.

ㅤ

ㅤ

Apply or Cancel

Use the bottom action controls after the preview matches the intended result.

  • OK: Removes any temporary preview, builds the final arrangement transactionally from the original source objects, groups the complete result, saves the current settings, and closes. This keeps source identity consistent whether Preview was on or off.
  • Cancel: Removes temporary preview objects, restores the source selection, and closes without changing the previously saved settings.
  • Window close: Performs the same safe preview cleanup as Cancel, including temporary guide layers, without saving settings.

Saved settings: Cloner restores the last values, selected mode, toggles, Preview preference, and dialog position from the previous successful OK action. Cancel and the window close button leave those stored settings unchanged. Preset-library actions are saved immediately.

When a requested arrangement exceeds 1,000 resulting objects, Cloner displays the estimated total and asks for confirmation. Requests above 10,000 resulting objects are rejected. Both totals include every selected source multiplied by its requested positions.

ㅤ

ㅤ

Workflow and Performance

Start with broad structural choices, then refine the transformation controls.

  1. Choose the mode in Settings or Editor.
  2. Use Settings to enter Count, Rows, Columns, spacing, radius, distance, area, and other exact values.
  3. Switch to Editor for direct visual adjustments; its mode selector and values remain synchronized with Settings.
  4. Refine opacity, twist, scale, distribution, or stacking order.
  5. Open Randomize to enable any X/Y Offset, Size, Rotation, Opacity, Horizontal Flip, or Vertical Flip variation.
  6. Use Zoom to Fit if the arrangement leaves the visible canvas.
  7. Confirm with OK when the preview is ready.
  • Disable Preview temporarily when working with complex source artwork.
  • Increase large counts gradually and review the warning estimate before proceeding.
  • Use direct numeric entry for values beyond a slider's normal range.
  • Apply Cloner repeatedly to a grouped result to build nested patterns.
  • Use negative Linear/Grid spacing or gutters intentionally for overlapping designs; radius, Wave distance/amplitude, and Fibonacci Spacing must remain positive.

ㅤ

ㅤ

☻ Wrap-Up

Cloner brings structured repetition, organic distribution, and precise pattern control into one consistent Illustrator workflow. Use live preview to explore quickly, then rely on deterministic seeds, safe cleanup, and automatic grouping to produce a clean final result. Combining modes across grouped results makes it possible to build sophisticated patterns from simple source artwork.

ㅤ

ㅤ

Leave a comment

Cloner

Version: 2.1.1

Updated:

    • 1.0.0: Introduced the initial cloning workflow.
    • 1.0.1: Added per-parameter reset buttons.
    • 1.0.2: Added right-click slider resets.
    • 1.0.3: Added Reverse Order to Linear mode.
    • 1.0.4: Added Reverse Order to Wave mode.
    • 1.0.5: Added Reverse Order to Radial mode.
    • 1.0.6: Added Reverse Order to Grid mode.
    • 1.0.7: Added Random Opacity.
    • 1.0.8: Added adjustable Random Rotation.
    • 1.0.9: Added adjustable Random Scale.
    • 1.1.0: Added adjustable Random Opacity amount.
    • 1.1.1: Added End Opacity to Linear mode.
    • 1.1.2: Added End Opacity to Radial mode.
    • 1.1.3: Added End Opacity to Spiral mode.
    • 1.1.4: Added End Opacity to Wave mode.
    • 1.1.5: Added Linear Distribution easing.
    • 1.1.6: Added persistent interface settings.
    • 1.1.7: Added Honeycomb mode with two orientations.
    • 1.1.8: Reworked Hide / Show Edges to change selection instead of Illustrator's global view state.
    • 1.1.9: Added label-based resets and option cycling.
    • 1.2.0: Added Fibonacci mode and reordered Grid and Honeycomb count controls.
    • 1.2.1: Reordered mode tabs and added Grid Use Object Size.
    • 1.2.2: Added Grid row and column offsets with percentage Shift.
    • 1.2.3: Introduced theme-aware reset indicators and Option / Alt reset shortcuts.
    • 1.2.4: Added the theme-aware vector interface, tooltips, and branded footer.
    • 1.2.5: Replaced standard option controls with labeled vector toggle buttons.
    • 1.2.6: Added custom sliders with integrated minus and plus controls.
    • 1.2.7: Added segmented selectors and the custom angle control foundation.
    • 1.2.8: Added color-coded icon tabs and mode-specific accent colors.
    • 1.2.9: Added automatic dialog sizing for the active tab.
    • 1.3.0: Added Linear Custom Angle movement and refined conditional controls.
    • 1.3.1: Improved responsive alignment, spacing controls, and saved-state compatibility.
    • 1.3.2: Added icon-based Grid Offset and Radial orientation selectors.
    • 1.3.3: Added stable Random seeds, safe preview cleanup, count warnings, corrected Radial and Spiral edge cases, Honeycomb grid preview, Grid gutters, updated icons, and automatic result grouping.
    • 1.3.4: Added the Radial Interactive Controls editor for direct radius, count, angle, opacity, and orientation adjustment.
    • 1.3.5: Added the Grid Interactive Controls editor and a collapsible, space-saving Interactive Controls panel.
    • 1.3.6: Added the Linear Interactive Controls editor with corrected canvas-direction mapping.
    • 1.3.7: Added the Wave Interactive Controls editor and refined the Random Seed layout.
    • 1.3.8: Added the Spiral Interactive Controls editor with matching canvas orientation.
    • 1.3.9: Added the Fibonacci Interactive Controls editor.
    • 1.4.0: Added the Random Interactive Controls editor with linked Width and Height, refined its distribution display, guarded preview updates when no document is active, and locked the dialog to its intended responsive layout.
    • 1.4.1: Added per-instance Randomize controls to Radial, Spiral, Wave, and Fibonacci, including the compact scrollbar, shuffle toggle, deterministic variation, and saved states.
    • 1.4.2: Added the Honeycomb Interactive Controls editor with live lattice editing, radius, counts, orientation, Reverse Order, and right-aligned Grid Preview.
    • 1.4.3: Replaced the external User Guide action with a searchable, resizable in-script guide styled after the reference UI kit, while retaining links to online resources.
    • 1.4.4: Expanded the built-in guide with mode illustrations, improved reset behavior, and added reversible Zoom to Fit.
    • 1.4.5: Moved persistent settings to the system user-data ScriptBox folder with safe JSON storage, migration, backups, and validation.
    • 1.4.6: Optimized OK to reuse an up-to-date live preview instead of deleting and recreating the same arrangement, with safer preview-source validation.
    • 2.0.0: Public release of the redesigned Cloner with advanced Interactive Controls in every mode, searchable built-in documentation, persistent settings, preview reuse at that release, stable randomization, reversible Zoom to Fit, value-based slider ticks, magnetic Radius/Distance detents, and control-specific Shift-drag snapping.
    • 2.0.1: Added safe arithmetic expressions in numeric fields, including parentheses and standard operators, with incomplete entries preserved during editing and evaluated values committed on completion.
    • 2.0.2: Added correct regular- and Large Canvas measurement handling through document.scaleFactor, centralized point and ruler-unit conversions across every cloning mode, corrected Fibonacci spacing units, and added a dedicated 0° reset icon beside the Linear Direction input.
    • 2.0.3: Added the Presets workspace with mode-specific user presets, click-to-apply behavior, inline rename and delete actions, drag and context-menu reordering, and immediate preset-library persistence.
    • 2.0.4: Introduced separate Settings, Editor, and Presets workspaces; moved all visual Interactive Controls into the new Editor tab; added synchronized color-coded mode selectors to Settings and Editor; made every active editor permanently visible and enabled; added the pointer-click Editor icon; removed the built-in Default preset; added a first-use empty state; and color-coded preset number badges by cloning mode.
    • 2.0.5: Added a dedicated Randomize workspace with a Shuffle icon; replaced the former shared compact control with independent X Offset, Y Offset, Size, Rotation, and Opacity channels for all eight modes; added a shared reproducible seed and Regenerate action; persisted Randomize values in settings and presets; introduced horizontal and vertical offset icons; shortened toggle labels; dimmed disabled labels and −/+ controls in dark mode; and removed redundant Editor headers so the Interactive Controls use the available height without blank space or cropping.
    • 2.0.6: Kept a synchronized cloning-mode selector visible in Randomize; moved the master Randomize ON / OFF toggle to the bottom of the frameless Randomize workspace; added a matching, prominent Randomize All action; added a visible right-side dice button to every channel; left-aligned the Random Seed label and field; added Undo/Redo controls for navigating complete seed snapshots; centralized preview throttling across sliders, visual editors, and numeric inputs; added diagnostic logging for non-fatal internal errors; and replaced Random mode's separate Link Width & Height row with a compact two-row icon control that preserves numeric-field alignment. Turning the master off still preserves all channel states, amounts, and seeds for immediate before-and-after comparison.
    • 2.0.7: Added double-click preset-name editing; collision-safe 64-character preset names; write-failure rollback for preset changes; centralized numeric validation with positive whole-number counts and a 10,000-object ceiling; corrected Square Wave amplitude; safer selection handling; transactional preview, generation, and grouping cleanup; consistent source identity with Preview on or off; and reliable XMP resource cleanup.
    • 2.0.8: Added shared Editor Scale and Rotate controls with icon-led labels, live preview, preset/settings persistence, validation, and transactional application to the source and all generated instances. Scale uses twenty 10% track divisions; Rotate uses a ±180° track with 5° minor ticks, 10° major ticks, and gentle detents. Numeric fields and step buttons can exceed both visual ranges.
    • 2.0.9: Corrected Linear End Scale tracks to grow left below 100% and right above 100%, allowed exact End Scale values above the 200% slider range, added right-click quick saving on the Presets workspace tab, added deterministic 50% Horizontal Flip and Vertical Flip channels to Randomize, and restored a protected Default preset that resets every setting.
    • 2.1.1: Redesigned Grid controls with tall icon-only link buttons beside paired labels, separated count and spacing sections, and placed Reverse Order beside Use Object Size. Improved launch and navigation performance with batched mode synchronization, visible-only theme redraws, delayed initial preview, 200 ms trailing mode-preview updates, and on-demand editor initialization.

    ㅤ

    ㅤ

    ㅤ

    Tested on MacOS:

    ㅤ

    • Adobe Illustrator 2023 (27.0)
    • Adobe Illustrator 2024 (28.1)
    • Adobe Illustrator 2025 (29.0)
    • Adobe Illustrator 2026 (30.3)
  • Supported Versions:

    • Compatible with Adobe Illustrator CS6 and later, including Adobe Illustrator CC versions.

    Operating Systems:

    • Works on both macOS and Windows platforms.
  • End User License Agreement (EULA)

    Last Updated: 21.12.2024

    ㅤ

    This End User License Agreement (“Agreement”) is a legal agreement between you (“User” or “Licensee”) and Samolevsky.com (“Licensor”) regarding the use of the Adobe Illustrator scripts (“Software”). By downloading, installing, or using the Software, you agree to be bound by the terms of this Agreement.

    ㅤ

    1. Grant of License

    Licensor grants the User a non-exclusive, non-transferable, and revocable license to use the Software in accordance with this Agreement.

    • Free Software: If the Software is provided for free, you may use it for personal or commercial purposes without payment, subject to the restrictions outlined in this Agreement.
    • Paid Software: If the Software is provided for a fee, you may use it only after payment has been made in full.

    ㅤ

    2. Usage Rights

    You are permitted to:

    • Install and use the Software on devices you own or control.
    • Use the Software in your personal or commercial projects, subject to compliance with this Agreement.

    ㅤ

    3. Restrictions

    You may NOT:

    • Reverse engineer, decompile, or otherwise attempt to discover the source code, underlying ideas, or algorithms of the Software.
    • Reuse, incorporate, or integrate any portion of the Software into any other software, product, or project, except as expressly permitted by the Licensor in writing.
    • Resell, redistribute, or share the Software, whether in its original or modified form, without prior written consent from the Licensor.
    • Claim ownership of the Software or its underlying code.
    • Use the Software in any way that violates applicable laws or regulations.

    ㅤ

    4. Ownership

    The Software and all intellectual property rights therein remain the exclusive property of the Licensor. This Agreement does not transfer ownership of the Software or any intellectual property rights to the User.

    ㅤ

    5. Disclaimer of Warranties

    THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE, AND NONINFRINGEMENT. IN NO EVENT SHALL THE LICENSOR BE LIABLE FOR ANY CLAIM, DAMAGES, OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT, OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

    ㅤ

    6. Limitation of Liability

    To the maximum extent permitted by law, Licensor shall not be liable for any damages, including but not limited to direct, indirect, incidental, special, or consequential damages, arising out of or related to the use or inability to use the Software.

    ㅤ

    7. Termination

    This Agreement is effective until terminated. Licensor may terminate this Agreement immediately if you breach any term of this Agreement. Upon termination, you must cease all use of the Software and destroy any copies in your possession.

    ㅤ

    8. Updates and Support

    Licensor is not obligated to provide updates, support, or maintenance for the Software. However, updates may be provided at the sole discretion of the Licensor.

    ㅤ

    9. Governing Law

    This Agreement shall be governed by and construed in accordance with the laws of the State of New York, without regard to its conflict of law principles.

    ㅤ

    10. Entire Agreement

    This Agreement constitutes the entire agreement between you and the Licensor concerning the Software and supersedes all prior or contemporaneous understandings regarding such subject matter.

    By using the Software, you acknowledge that you have read this Agreement, understand it, and agree to be bound by its terms.

    ㅤ

    For any questions or concerns regarding this Agreement, please contact us at hello@samolevsky.com

Browse More Scripts

  1. Explore Gradient Type Switcher
    Gradient Type Switcher

    Gradient Type Switcher

    Gradient Type Switcher converts gradient fills and strokes between linear and radial types in Adobe Illustrator. 

    Explore
  2. Explore Sequential Text Numbering
    Sequential Text Numbering

    Sequential Text Numbering

    Sequential Text Numbering automates numbering and labeling across selected text frames in Adobe Illustrator.

    Explore
  3. Explore Quick Resize
    Quick Resize

    Quick Resize

    Quick Resize is a floating panel for Adobe Illustrator that resizes selected objects to an exact width or height.

    Explore

Introducing ScriptBox

Your Complete Adobe Illustrator Productivity Hub

Required Software

Adobe Illustrator

Adobe Illustrator is a professional vector graphics software developed by Adobe Inc. It is widely used by designers, illustrators, and artists for creating a variety of digital artwork, including logos, icons, illustrations, typography, and complex design layouts. Illustrator is known for its precision and scalability, allowing users to create high-quality graphics that can be resized without losing clarity. Its features include powerful drawing tools, customizable brushes, advanced typography options, and seamless integration with other Adobe Creative Cloud applications. Illustrator is a go-to tool for creative professionals working on projects for print, web, and multimedia platforms.

  • 🅰 Locating the Scripts Folder

    To install a Cloner.jsx script in Adobe Illustrator, you need to place it in the correct directory where Illustrator
can recognize it. Follow these steps to locate the Scripts folder:

    1. MacOS:
      Open Finder and navigate to:
      Applications/Adobe Illustrator <Version>/Presets/<Language>/Scripts
    2. Windows:
      Open File Explorer and navigate to:
      C:\Program Files\Adobe\Adobe Illustrator <Version>\Presets\<Language>\Scripts
    3. Replace <Version> with your Adobe Illustrator version (e.g., 2025).
    4. Replace <Language> with your language folder (e.g., "de_DE" for German, "en_US" for English).

    ㅤ

    🅱 Installing the Script

    1. Copy the Script File: Copy the Cloner.jsx file to the Scripts folder located in the path above.
    2. On some systems, you may need administrator permissions to modify the Scripts folder.
    3. Restart Adobe Illustrator: To refresh the scripts menu, close and reopen Adobe Illustrator.

    ㅤ

    Explore our complete guide to mastering Adobe Illustrator scripts.

    1. Open Adobe Illustrator and ensure a document is active.
    2. Go to the top menu bar and select File > Scripts.
    3. If the script is installed in the Scripts folder, it will appear in the dropdown list.
    4. Click the Cloner script to run it.
    5. The Cloner script will execute, and any dialog boxes or results will appear based on the script’s functionality.

    ☻ Before running any scripts, it’s strongly advised to save your work — especially when working with complex or large documents.

Got questions?

Need help or have an idea to share? We’d love to hear from you! Whether you have questions, found a bug, have a feature request, or just want to share your feedback, reach out to us—we’re here for you!