> 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/palettes/palette-commands.md).

# Palette Commands

All sub-commands are under `//ezpalette` (`//ezp`)\
e.g `//ezpalette list`

## `//ezpalette ...`

### `fetch <fetchMode> <paletteName> [length] [-d <direction>] [-f]`

<details>

<summary>Fetch Palette</summary>

Saves a user-defined palette with a given name.

* **Fetch Mode**: From where to fetch the palette blocks:
  * **`WORLD`**
    * Takes the blocks from the player's position
  * **`SELECTION`**
    * Takes the blocks from the player's selection
    * Selection must be 1x1xN in size, where N is the desired palette length
  * **`HOTBAR`**
    * Takes blocks from the player's hotbar
    * Ignores items and uses default block properties
* **Length** (Default: 0): How many block to fecth. A length of 0 (default) will fetch blocks until air is reached.
* **-d** (Default: me): The direction to fetch in. Defaults to the direction the user is facing.
* **-f**: When activated, overwrites the existing palette with the same name.

<img src="/files/zyqnoQuE2h2PW5yJSnO1" alt="" data-size="original">

</details>

### `save <paletteName> <palette> [-f]`

Saves a user-defined palette with a given name.

* **-f**: When activated, overwrites the existing palette with the same name.

### `delete <paletteName>`

Deletes a user-defined palette matching the given name.

### `list [SET]`

* `ALL`\
  Lists all available palettes
* `DEFAULT`\
  Lists all default plugin palettes
* `MINE`\
  Lists all user-defined palettes

### `place <palette> [direction]`

Places a palette in the world as a row of blocks in the given direction.\
Direction defaults to the direction the user is facing.

### `swap <sourcePalette> <targetPalette> [-a] [-f]`

Region operation which swaps the blocks of the source palette with those of the target palette.

* **-a**: Activate to ignore air blocks in source palette.
* **-s**: Activate to stretch the target palette to match the size of the source palette.
* **-f**: Enables fuzzy matching mode. Ignoring the block states of the source palette.
* **-b**: Copies the block states from the source palette blocks onto the target palette.

### `print <palette> [-v]`

Prints the blocks of a given palette in chat. Block list can be clicked to copy.

**-v**: Verbose mode. Will print full block name and block states.

### `encode <palette>`

Prints an encoded string representing a given palette. Click the string to copy.\
\&#xNAN;*Only supports vanilla Minecraft blocks.*

### `decode <string>`

Prints the blocks of a given encoded palette string. Block list can be clicked to copy.


---

# 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/palettes/palette-commands.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.