> For the complete documentation index, see [llms.txt](https://intellectualsites.gitbook.io/plotsquared/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://intellectualsites.gitbook.io/plotsquared/customization/plot-component-presets.md).

# Plot component presets

## Introduction

PlotSquared v5.12.0 introduced a new component preset system. The new system allows server owners to make component presets that players can then apply to their plots via a GUI. The GUI menu overrides player specific permissions. Thus, you can use the GUI to let players use components that they're not normally permitted to use.

## Components

The components available - and the values you can use - are the same as those in the `/plot set <component>` command.

Available components:

* floor
* wall
* all
* air
* main
* middle
* outline
* border

More information can be found here: [Plot Components](/plotsquared/customization/plot-component-presets.md)

## Configuration

The system is toggled in the `settings.yml` file under `enabled-components`. It is enabled by default.

Presets are configured in the file `plugins/PlotSquared/settings/components.yml`:

Messages are styled using [MiniMessage](https://docs.adventure.kyori.net/minimessage.html). To preview the outcome, you can use a tool like [MiniMessageViewer](https://webui.adventure.kyori.net).

```yaml
presets:
  - component: floor
    cost: 0.0
    pattern: '##wool'
    name: <rainbow:2>Disco Floor</rainbow>
    icon: yellow_wool
    description:
      - <gold>Spice up your plot floor</gold>
    permission: ''
```

This is a powerful system as it allows you to use the power of [BlockBuckets](/plotsquared/features/block-bucket.md) to define block-patterns.

## Cost

If a non-zero cost is defined and both [Vault](https://www.spigotmc.org/resources/34315) and an economy plugin is present, the GUI will charge using the in-game currency.

## Icons

You can use any [Minecraft material](https://www.digminecraft.com/lists/item_id_list_pc.php) as the preset icon.

## Permission

The player won't be able to see presets that they are not permitted to use. If the permission is set to `''` (an empty string) then all players will be able to use that preset.

## /plot components

The command for opening the GUI is `/plot components` and has the permission node `plots.components`.

Using this command will bring up the GUI menu, but only if the player is in a plot that they own.

![image](https://i.imgur.com/brFlzw6.png%5Bcomponent_small.png)


---

# 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://intellectualsites.gitbook.io/plotsquared/customization/plot-component-presets.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.