> 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

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

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.