Placement

Overview

ezEdits provides multiple ways to quickly and precisely place clipboards, schematics, and expression-based shapes, which we refer to as 'structures'.

The relevant commands and brushes (introduced in version 0.12.0) are:

Command / Brush

//ezplace

Abbreviation

//ezpl

Description

Places a single structure at the player's position.

Syntax

//ezplace <structure> [<primary>][<secondary>]

Parameters

Accepts Placement Parameters.

Command / Brush

//ezbrush place

Abbreviation

//ezbr pl

Description

Brush that places a single structure at each brush click's target.

Syntax

//ezbrush place <structure> [<primary>] [<secondary>]

Parameters

Accepts Placement Parameters.

Command / Brush

//ezscatter

Abbreviation

//ezsc

Description

Places multiple structures within a selected region.

Syntax

//ezscatter<structure> [<primary>] [<secondary>]

Parameters

Accepts Placement Parameters and Scatter Parameters.

Command / Brush

//ezbrush scatter

Abbreviation

//ezbr sc

Description

Brush that places multiple structures in the area of each brush click's target.

Syntax

//ezbrush scatter<structure> [<primary>] [<secondary>]

Parameters

Accepts Placement Parameters and Scatter Parameters.

Command / Brush

//ezarray

Abbreviation

//ezar

Description

Places multiple structures sequentially along a path.

Syntax

//ezarray<structure> [<primary>][<secondary>]

Parameters

Accepts Placement Parameters and Array Parameters.

Command / Brush

//ezbrush array

Abbreviation

//ezbr ar

Description

Brush that places multiple structures along a brush stroke.

Syntax

//ezbrush array<structure> [<primary>] [<secondary>]

Parameters

Accepts Placement Parameters and Array Parameters.

All six commands are based on the same underlying placement method. As a result, all six commands share the same syntax and parameters.

For completeness, one can also embed a structure or an array of structures into a shaped spline with the ezspline subcommand //ezspline structure (//ezsp structure). However, the structures are not "placed" as much as they are embedded into the spline path, meaning that the alignment settings and the placement parameters do not apply to that command. Which is why it is documented on the splines page instead.

---

Subpage structure

This Placement wiki has multiple subpages. Below you find an overview of the subpages.

We suggest reading the Primary+Secondary Alignment page more carefully, as it covers one of the fundamental concepts of the tools. The remaining chapters can be treated as reference materials, useful for specific tasks or to delve deeper into the tool's capabilities.

• Available Structures

  • Covers the <structure> parameter (necessary for place/scatter/array (and ezspline structure)).

• Primary+Secondary Alignment

  • Covers the [<primary>] [<secondary>] parameters (available for place/scatter/array) and the accompanying flags:

    • [-j <snapDirections>]

    • [-x]

• Placement Parameters

  • Covers the following flags (available for place/scatter/array):

    • [-s <dimensions>]

    • [-o <sizeMultiplierRange>]

    • [-c <orientationAngle>] [-k <orientationAxis>]

    • [-f <randomFlipsAxes>]

    • [-r <randomRotationAxis>]

    • [-a]

• Scatter Parameters

  • Covers the following flags (only available for scatter):

    • [-h <region>]

    • [-d <filterDirections>] [-e <filterThreshold>]

    • [-m <maskFilter>]

    • [-n <density>]

    • [-i <seed>]

    • [-u <iterations>]

    • [-l <coverPattern>]

    • [-t]

• Array Parameters

  • Covers the following flags (only available for array):

    • [-g <gap>]

    • [-y <maxOffset>]

    • [-q <radiiMultiplier>]

    • [-p <kbParameters>]

    • [-n <normalMode>]

    • [-b]

Here are the same flags again, but in alphabetical order:

• [-a]

• [-b]

• [-c <orientationAngle>]

• [-d <filterDirections>]

• [-e <filterThreshold>]

• [-f <randomFlipsAxes>]

• [-g <gap>]

• [-h <region>]

• [-i <seed>]

• [-j <restrictedAngles>]

• [-k <orientationAxis>]

• [-l <coverPattern>]

• [-m <maskFilter>]

• [-n <density>]

• [-n <normalMode>]

• [-o <sizeMultiplierRange>]

• [-p <kbParameters>]

• [-q <radiiMultiplier>]

• [-r <randomRotationAxis>]

• [-s <dimensions>]

• [-t]

• [-u <iterations>]

• [-x]

• [-y <maxOffset>]

---

Note for server admins: The three placement brushes spawn BlockDisplay entities (only visible to the player using their brush) to help visualise the Alignment of the brushes. You may disable the visualisation entities entirely or change how often they are updated in the config.yml under visualisations.

Additionally, the command //ezdebug removeVisualiserEntities will remove any entities spawned by ezEdits from your world in case they got bugged somehow and were not despawned correctly, which should never happen, but there you go.

---