Plot flags

Description

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 set flag <flag> <value>. For a boolean flag, the value would either be 'true' or 'false'.

As an alias, you can also use /plot set <flag> <value>

To bring up a list of flags use /plot flag list

You can set default flags per world in the /plugins/PlotSquared/settings/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"

*where <world> indicates the name of that plotworld. (The example list is truncated in size here due to length issues)
*Each variant of an item will need to be added separately, as before, but now the full name must be used.

Flag types:

- String

Accepts any letter, number, space, color codes, and a few symbols.

- String (restricted)

Usually only accepts a few specific values (See in game documentation)

- Boolean

Accepts true or false

- Long

Accepts a positive whole number (can be large)

- Interval

Two sets of numbers e.g. 53 6 or 7 93

- UnsignedInteger

A positive whole numer, e.g. 43

- BlockList

A list of blocks, supporting both legacy numerical IDs and new string IDs e.g.

• grass_block for grass blocks
• 7 for bedrock
• 7,3 for bedrock and dirt
• 35:14,35:15 for red and black wool The block list does not accept block names, only id and data.

Flag Permissions

The following tables do not declare explicit flag permissions, because flag permissions follow the same scheme always again. To give a player access to a flag, you need to assign the following permissions, and exchange the value if wanted.

Or assign plots.permpack.basicflags to cover the following permissions and lots of the basic flags.

• plots.set.flag
• plots.flag
• plots.flag.add
• plots.flag.remove

Flag specific permission: 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.

Terminology

The following tables contain phrases covering certain stances of plot member inheritance. We will explain the phrases used below.

• Player: The player, as in user of the server.
• Guest: Person who is not added to the plot (Check Plot Rank Tiers)
• False: The flag intended behavior is not enabled by default
• True: The flag intended behavior is enabled by default
• Null: The flag intended behavior is not set by default

Flags

Boolean:

Name	Description	Default Value
redstone	Set to false to disable redstone on the plot	True
fly	Set to true to enable flight upon plot entry	Null
notify-leave	Set to true to enable leave notifications to plot owners	False
notify-enter	Set to true to enable join notifications to plot owners	False
titles	Set to false to disable titles within a plot	True
hide-info	Set to true to hide plot information	Null
server-plot	Set to true change a plot owner to "Server"	False
explosion	Set to true to allow explosions inside a plot	False
grass-grow	Set to true allow grass to grow	Null
vine-grow	Set to true allow vines to grow	Null
mycel-grow	Set to true mycel to grow	Null
kelp-grow	Set to true kelp to grow	Null
disable-physics	Set to true to disable block physics	False
liquid-flow	Set to false to disable liquid flowing	True
snow-melt	Set to true to enable snow melting	Null
snow-form	Set to true to enable snow spawning on top of blocks	False
ice-melt	Set to true to ice melting	Null
ice-form	Set to true to ice forming	Null
block-burn	Set to true to enable block burning	Null
block-ignition	Set to true to ignite blocks	Null
soil-dry	Set to true to allow soil to dry	Null
device-interact	Set to true to allow guests to work (pressure plates e.g.)	False
vehicle-break	Set to true to allow guests to break vehicles (minecarts e.g.)	False
vehicle-place	Set to true to allow guests to place vehicles (minecarts e.g.)	False
vehicle-use	Set to true to allow guests to use vehicles (minecarts e.g.)	False
hanging-break	Set to true to allow guests to break hangings	False
hanging-place	Set to true to allow guests to place hangings	False
misc-place	Set to true to allow guests to place miscellaneous items (item frames e.g.)	False
misc-break	Set to true to allow guests to break miscellaneous items	False
misc-interact	Set to true to allow guests to interact with miscellaneous items	False
villager-interact	Set to true to allow guests to interact with villagers	False
player-interact	Set to true to allow guests to interact with other players or NPCs	False
tamed-interact	Set to true to allow guests to interact with tamed mobs	False
tamed-attack	Set to true to allow guests to attack tamed mobs	False
animal-interact	Set to true to allow guests to interact with passive mobs	False
animal-attack	Set to true to allow guests to attack passive mobs	False
hostile-interact	Set to true to allow guests to interact with hostile mobs	False
hostile-attack	Set to true to allow guests to attack hostile mobs	False
mob-place	Set to true to allow players to use spawn eggs	False
mob-break	Set to true to allow mobs to break blocks	False
forcefield	Set to true throw back Guests getting close members	False
invincible	Set to true to give players godmode	False
drop-protection	Set to false to stop Guests from dropping items	True
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 deny players to leave the plot	False
untrusted-visit	Set to true to allow Members to teleport if the teleport flag is denied	False

Notification

• titles
• greeting
• farewell
• description
• notify-enter
• notify-leave

Attributes

• feed
• heal
• invincible
• instabreak
• fly
• gamemode
• time
• weather
• music
• disable-physics
• deny-teleport
• grass-grow
• ice-melt
• mycel-grow
• snow-melt
• vine-grow

Caps

• mob-cap
• animal-cap
• hostile-cap
• entity-cap
• vehicle-cap
• misc-cap

Items

• item-drop
• drop-protection

Boolean protection

• pve
• pvp
• deny-exit
• explosion
• player-interact
• hostile-interact
• hostile-attack
• animal-interact
• animal-attack
• tamed-interact
• tamed-attack
• misc-interact
• hanging-place
• hanging-break
• vehicle-use
• vehicle-place
• vehicle-break
• redstone
• device-interact
• liquid-flow
• block-burn
• block-ignition
• mob-place
• snow-form
• untrusted-visit

Block protection (list based)

• place
• break
• use

Misc

• forcefield
• modified-blocks
• price
• no-worldedit
• blocked-cmds
• server-plot