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 | Abbreviation | Description | Syntax | Parameters | |
|---|---|---|---|---|---|
//ezplace | //ezpl | Places a single structure at the player's position. | //ezplace <structure> [<primary>][<secondary>] | Accepts placement-parameters.md. | |
//ezbrush place | //ezbr pl | Brush that places a single structure at each brush click's target. | //ezbrush place <structure> [<primary>] [<secondary>] | Accepts placement-parameters.md. | |
//ezscatter | //ezsc | Places multiple structures within a selected region. | //ezscatter<structure> [<primary>] [<secondary>] | Accepts placement-parameters.md and scatter-parameters.md. | |
//ezbrush scatter | //ezbr sc | Brush that places multiple structures in the area of each brush click's target. | //ezbrush scatter<structure> [<primary>] [<secondary>] | Accepts placement-parameters.md and scatter-parameters.md. | |
//ezarray | //ezar | Places multiple structures sequentially along a path. | //ezarray<structure> [<primary>][<secondary>] | Accepts placement-parameters.md and array-parameters.md. | |
//ezbrush array | //ezbr ar | Brush that places multiple structures along a brush stroke. | //ezbrush array<structure> [<primary>] [<secondary>] | Accepts placement-parameters.md and array-parameters.md. |
All six commands are based on the same underlying placement method. As a result, all six commands share the same syntax and parameters.
{% hint style="info" %}
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.
{% endhint %}
This Placement wiki has multiple subpages. Below you find an overview of the subpages.
{% hint style="info" %} 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. {% endhint %}
- Available Structures
- Covers the
<structure>parameter (necessary for place/scatter/array (and ezspline structure)).
- Covers the
- Primary+Secondary Alignment
- Covers the
[<primary>] [<secondary>]parameters (available for place/scatter/array) and the accompanying flags:
- Covers the
- Placement Parameters
- Covers the following flags (available for place/scatter/array):
- Scatter Parameters
- Covers the following flags (only available for scatter):
- Array Parameters
- Covers the following flags (only available for array):
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]
{% hint style="warning" %}
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.
{% endhint %}