The extensive flagging system allows you to do all sorts of things such as setting the plot weather.
Setting a flag is easy, just use /plot flag set <flag> <value>
. For a boolean flag, the value would either be 'true' or 'false'.
Tip: All the flag commands come with tab auto completion.
To bring up a list of flags use /plot flag list
. These values are clickable, and clicking a flag name will show you information about that particular flag. You can also use /plot flag info <flag>
directly, if you already know the flag name.
You can set default flags per world in the plugins/PlotSquared/config/worlds.yml
. Default flags will be present in each claimed plot unless a different value is manually set for that plot. The following is an example of setting the use
flag to allow interaction with doors, and trapdoors, levers, gates, pressure plates, buttons and trip wires:
worlds:
<world>:
[...]
flags:
use: "oak_door,iron_trapdoor,lever,acacia_fence_gate,light_weighted_pressure_plate,oak_button,tripwire"
pvp: true
<world>
indicates the name of that plotworld.
Tip: Instead of all materialnames of the same kind seperate you can use the tags to specify a "material-group".
Accepts true
or false
.
Accepts commands with multiple parameters, e.g /gamemode creative
.
A binary tuple of numbers e.g. 53 6
or 7 93
.
A list of blocks, supporting both legacy numerical IDs and new string IDs e.g.
grass_block
for grass blocks7
for bedrock7,3
for bedrock and dirt35:14,35:15
for red and black woolThese flags also support vanilla-tags, like:
#signs
for all sign types#buttons
for all button typesAccepts a predefined collection of values.
Accepts any decimal number (all real numbers),
Accepts the plot tiers trusted
, members
, nonmembers
, nontrusted
and nonowners
.
Accepts all integers.
Flags used internally.
To give a player access to a flag, you need to assign the following permissions, and exchange the value if wanted:
plots.set.flag
plots.flag
plots.flag.add
plots.flag.remove
Tip: Also you can assign
plots.permpack.basicflags
to cover the following permissions and lots of the basic flags.
plots.set.flag.<name>.*
(e.g. plots.set.flag.fly.*
)
The asterisk covers the values of the flag, if it's a boolean flag you cover true
and false
, if it's a Long flag you cover all positive numbers and so on. Make sure to decide whether you need it or not.
The following tables contain phrases covering certain stances of plot member inheritance and flag states. We will explain the phrases used below.
Flags such as mob caps, interaction flags, etc, make use of entity categories. PlotSquared divides entities in the following categories:
Name | Description | Default Value |
---|---|---|
redstone | Set to false to disable redstone in the plot. |
True |
fly | Set to true to enable flight within the plot. |
False |
chat | Set to false to prevent plot chat on the plot. |
False |
notify-leave | Set to true to notify the plot owners when someone leaves the plot. |
False |
notify-enter | Set to true to notify the plot owners when someone enters the plot. |
False |
hide-info | Set to true to hide plot information. |
False |
server-plot | Set to true to turn the plot into a server plot. This is equivalent to setting the server as the plot owner. |
False |
explosion | Set to true to allow explosions inside a plot. |
False |
grass-grow | Set to false to disable grass to grow within the plot. |
True |
vine-grow | Set to false to disable vines to grow within the plot. |
True |
mycel-grow | Set to false to disable mycelium to grow in the plot. |
True |
kelp-grow | Set to false to disable kelp to grow in the plot. |
True |
instabreak | Set to true to allow blocks to be instantaneously broken in survival mode. |
False |
disable-physics | Set to true to disable block physics in the plot. |
False |
liquid-flow | Set to false to disable liquid flowing. |
True |
snow-melt | Set to true to allow snow to melt within the plot. |
True |
snow-form | Set to false to disallow snow to form within the plot. |
False |
ice-melt | Set to true to allow ice to melt in the plot. |
False |
ice-form | Set to true to allow ice to form in the plot. |
False |
block-burn | Set to true to allow blocks to burn within the plot. |
False |
block-ignition | Set to true to allow blocks to ignite within the plot. |
False |
soil-dry | Set to true to allow soil to dry within the plot. |
False |
coral-dry | Set to true to allow corals to dry within the plot. |
False |
device-interact | Set to true to allow devices to be interacted with in the plot. |
False |
vehicle-break | Set to true to allow guests to break vehicles in the plot. |
False |
vehicle-place | Set to true to allow guests to place vehicles in the plot. |
False |
vehicle-use | Set to true to allow guests to use vehicles in the plot. Applies to the following entity categories: vehicle |
False |
hanging-break | Set to true to allow guests to break hanging objects in the plot. Applies to the following entity categories: hanging |
False |
hanging-place | Set to true to allow guests to hang objects in the plot. |
False |
misc-place | Set to true to allow guests to place miscellaneous items. |
False |
misc-break | Set to true to allow guests to break miscellaneous items. Applies to the following entity categories: armorstands |
False |
misc-interact | Set to true to allow guests to interact with miscellaneous items. Applies to the following entity categories: hanging, other |
False |
villager-interact | Set to true to allow guests to interact with villagers in the plot. |
False |
player-interact | Set to true to allow guests to interact with players in the plot. Applies to the following entity categories: player |
False |
tamed-interact | Set to true to allow guests to interact with tamed mobs. Applies to the following entity categories: tameable |
False |
tamed-attack | Set to true to allow guests to interact with tamed animals in the plot. Applies to the following entity categories: tameable |
False |
animal-interact | Set to true to allow animals to be interacted with in the plot. Applies to the following entity categories: animal |
False |
animal-attack | Set to true to allow animals to be attacked in the plot. Applies to the following entity categories: animal |
False |
hostile-interact | Set to true to allow players to interact with hostile mobs in the plot. Applies to the following entity categories: hostile |
False |
hostile-attack | Set to true to enable players to attack hostile mobs in the plot. Applies to the following entity categories: hostile |
False |
mob-place | Set to true to allow mobs to place blocks within the plot. |
False |
mob-break | Set to true to allow mobs to break blocks within the plot. |
False |
forcefield | Set to true to enable member forcefield in the plot. |
False |
invincible | Set to true to prevent players from taking damage inside of the plot. |
False |
item-drop | Set to false to prevent item drop by non-members. |
True |
drop-protection | Set to true to prevent dropped items from being picked up by non-members of the plot. |
False |
pvp | Set to true to allow PvP. |
False |
pve | Set to true to allow PvE. |
False |
no-worldedit | Set to true to disable WorldEdit usage within the plot. |
False |
deny-exit | Set to true to disallow players from exiting the plot. |
False |
untrusted-visit | Set to false to disallow untrusted players from visiting the plot. |
True |
prevent-creative-copy | Set to true Prevents people from copying item NBT data in the plot unless they're added as members. |
False |
description | Set the plot description. Supports '&' color codes. | Empty |
greeting | Message sent to players on plot entry. Supports '&' color codes. | Empty |
farewell | Message sent to players when leaving the plot. Supports '&' color codes. | Empty |
leaf-decay | Set to false to prevent leaves from decaying. |
True |
Name | Description | Default Value |
---|---|---|
blocked-cmds | A list of commands that are blocked in the plot. | None |
gamemode | Determines the gamemode in the plot. | None |
guest-gamemode | Determines the guest gamemode in the plot. | None |
Name | Description | Default Value |
---|---|---|
feed | Specify an interval in seconds and an optional amount by which the players will be fed (amount is 0 by default = vanilla-regeneration). | None |
heal | Specify an interval in seconds and an optional amount by which the players will be healed (amount is 0 by default = vanilla-regeneration). | None |
Name | Description | Default Value |
---|---|---|
use | Define a list of materials players should be able to interact with in the plot even when they aren't added to the plot. | None |
break | Define a list of materials players should be able to break in the plot even when they aren't added to the plot. | None |
place | Define a list of materials players should be able to place in the plot even when they aren't added to the plot. | None |
Name | Description | Default Value |
---|---|---|
weather | Specifies the weather conditions inside of the plot. | None |
deny-teleport | Deny a certain group from teleporting to the plot. Available groups: members, nonmembers, trusted, nontrusted, nonowners | None |
titles | Set to true to allow the plot title when someone enters the plot. |
None |
music | Set to a music disk ID (item name) to play the music disc. | None |
Name | Description | Default Value |
---|---|---|
price | If set a plot can be bought for this price using /plot buy . Requires economy to be enabled and lists plots under /plots list forsale . |
Not Buyable |
Name | Description | Default Value |
---|---|---|
misc-cap | Set to an integer value to limit the amount of miscellaneous entities on the plot. Applies to the following entity categories: projectile, other, hanging | Infinity |
entity-cap | Set to an integer value to limit the amount of entities on the plot. | Infinity |
mob-cap | Set to an integer value to limit the amount of mobs on the plot. Applies to the following entity categories: animal, villager, tameable, hostile | Infinity |
animal-cap | Set to an integer value to limit the amount of animals on the plot. Applies to the following entity categories: animal, villager, tameable | Infinity |
hostile-cap | Set to an integer value to limit the amount of hostile entities on the plot. Applies to the following entity categories: hostile | Infinity |
vehicle-cap | Set to an integer value to limit the amount of vehicles on the plot. Applies to the following entity categories: vehicle | Infinity |
time | Set the time in the plot to a fixed value | Disabled |
Name | Description | Default Value |
---|---|---|
done | Mark a plot as done. | Null |
analysis | A multi purpose debug analysis flag. | Null |