> For the complete documentation index, see [llms.txt](https://ezedits.gitbook.io/ezedits/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ezedits.gitbook.io/ezedits/commands/selections.md).

# Selections

## Selection Commands

### `//selload`

<details>

<summary>Selection Load</summary>

**`//selload [selection] [-h]`**

*Alternate for* **`//ezsel load`**

The `//selload` command retrieves a previously saved selection from the player's saved selection list.

* Selection: A previously saved selection.
* **-h**: Moves the selection to the player when loaded

</details>

### `//next`

<details>

<summary>Selection Shift</summary>

**`//next <direction> <gap>`**

The `//next` command shifts your current selection area by its own size in a specified direction.

* **Direction** (Default: Player AIM): Specifies the direction to shift the selection towards. If not provided, it defaults to the direction the player is aiming.
* **Gap** (Default: 0): An optional parameter to add an additional gap between the current selection position, and the shifted position.

</details>

### `//selhere`

<details>

<summary>Move Selection to Player</summary>

**`//selhere [selectionPosition]`**

**`Alias: //seltome`**

The `//selhere` command moves your current selection to your location.

* **SelectionPosition** (Default: POS1): Specifies which point in the selection to move to the player's position. All other points will be moved to the relative position.
  * POS1 - The "Pos1" of the selection, or first point for convex/poly selections.
  * POS2 - The "Pos2" of the selection, or the last points for convex/poly selections.
  * CENTER - The center point of the selection

</details>

### `//ezselinvert`

<details>

<summary>Selection Invert</summary>

**`//ezselinvert`**

**`Alias: //selinvert`**

The `//ezselinvert` command reverses the order of points in your current selection.\
This will be most noticeable with convex selections as with a cuboid selection pos1 and pos2 will simply swap places, whereas a convex selection will reverse the order of every point.

</details>

### `//delpos2`

<details>

<summary>Delete Last Position</summary>

**`//delpos2`**

**`Alias: //-2`**

The `//delpos2` command removes the last secondary selection point for convex and poly selections.

</details>

### `//encapsulate`

<details>

<summary>Encapsulate Blocks In Selection</summary>

**`//encapsulate <mask>`**

**`Alias: //enc`**

The `//encapsulate` command takes your existing selection and changes it to the smallest CUBOID selection which contains blocks matching the given mask.

* **Mask**: Blocks to encapsulate

</details>

### `//encapsulatenear`

<details>

<summary>Encapsulate Nearby Blocks In a New Selection</summary>

**`//encapsulatenear <radius> <mask>`**

**`Aliases: //encnear or //selnear`**

The `//encapsulatenear` command creates a new selection of the smallest CUBOID selection which contains blocks matching the given mask within the radius.

* **Radius**: Cuboid radius to search for matching blocks
* **Mask**: Blocks to encapsulate

</details>

## Selection Management Commands

All sub-commands are under `//ezselection` (`//ezsel`)\
e.g `//ezsel list`

### `list [-g]`

Lists all the user's saved selections. Click a selection name to load.\
`-g` to group selections by type.

### `load <selection>`

Retrieves a previously saved selection from the player's saved selection list.

### `save <selectionName> [-f]`

Saves the user's current selection with a given name.\
`-f` to override an existing saved selection.

### `delete <selectionName>`

Deletes a user's selection with the given name.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ezedits.gitbook.io/ezedits/commands/selections.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.