# 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: 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:

```
GET https://intellectualsites.gitbook.io/plotsquared/customization/plot-component-presets.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.