1 Plot Component Presets
NotMyFault edited this page 2021-04-27 17:46:00 +02:00

PlotSquared v5.12.0 introduces 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 difference here is that 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.

component_small.png

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 Settings.

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/components.yml: Future versions (v6 and higher) have the file stored in plugins/PlotSquared/settings/components.yml

title: '&6Plot Components'
presets:
- component: floor
  cost: 0.0
  pattern: '##wool'
  name: '&6D&ai&cs&ec&bo &2F&3l&do&9o&4r'
  icon: yellow_wool
  description:
  - '&6Spice up your plot floor'
  permission: ''

This is a powerful system as it allows you to use the power of WorldEdit patterns.

Tip: It is a good idea to try out the pattern in-game using /plot set.

Titles And Descriptions

Both titles and descriptions support '&' (ampersand) color codes.

Cost

If a non-zero cost is defined and both Vault and an economy plugin is present, the GUI will charge using the in-game currency.

Icons

You can use any Minecraft material 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.