Flags

Overview

Flags control what non-members can do on a plot. Each flag can be toggled by the plot owner (or members with the CHANGE_FLAG permission) through the GUI or by an admin using /plotsadmin setflag.

When a non-member attempts a blocked action, they receive a notification via action bar or chat (configurable).

Available Flags

Flag	Default	Configurable	Description
PVP	Enabled	Yes	Player vs player combat
BUILD	Enabled	Yes	Block placement by non-members
DESTROY	Enabled	Yes	Block breaking by non-members
INTERACT	Enabled	Yes	Block interaction (buttons, levers, doors)
ITEM_FRAME	Enabled	Yes	Item frame interaction
CHEST	Enabled	Yes	Chest and container access
EXPLOSION	Enabled	Yes	TNT and creeper explosions
LAVA	Enabled	Yes	Lava placement and flow
WATER	Enabled	Yes	Water placement and flow
IGNITE	Enabled	Yes	Fire spread and ignition
SNOW_MAN	Enabled	No	Snow golem building
ARMOR_STAND	Enabled	Yes	Armor stand interaction
ENDER_PEARL	Enabled	Yes	Ender pearl teleportation
SET_HOME	Enabled	Yes	Setting home points (sethome commands)
DAMAGE_PASSIVE_MOBS	Enabled	Yes	Damaging passive mobs (cows, sheep, etc.)
DAMAGE_AGGRESSIVE_MOBS	Enabled	Yes	Damaging aggressive mobs (zombies, etc.)
POTION	Enabled	Yes	Potion usage
VEHICLE	Enabled	Yes	Minecart and boat usage
RECEIVE_DAMAGE_FROM_MOBS	Disabled	Yes	Players receive damage from mobs
PHANTOM_SPAWN	Disabled	Yes	Phantom spawning on the plot

Tip: When a flag is “Enabled” by default, it means the action is allowed for non-members. Toggle it off to block that action.

Configuration

Notification Type

Control how blocked action notifications are displayed:

notification-type: ACTION_BAR

Type	Description
ACTION_BAR	Shows notification above the hotbar
CHAT	Shows notification in the chat

Flag Change Delay

Prevents flag spam by requiring a cooldown between changes:

flag-delay: 5s

Set Home Commands

Commands that are blocked when the SET_HOME flag is disabled:

set-home-commands:
  - "sethome"
  - "cmi:sethome"
  - "essentials:sethome"

Non-Configurable Flags

Flags with configurable: false cannot be toggled by players through the GUI. They are set to their default value and can only be changed by administrators.

Flag Configuration Example

Each flag can be customized with a display item in the GUI:

flags:
  - flag-type: PVP
    delay: false
    configurable: true
    default-flag: true
    flag-item:
      material: DIAMOND_SWORD
      display-name: "&cPVP"
      lore:
        - "&7Toggle player combat"

Field	Type	Description
flag-type	Enum	The flag identifier
delay	Boolean	Whether this flag has a change cooldown
configurable	Boolean	Whether players can toggle this flag
default-flag	Boolean	Default state for new plots
flag-item	Object	GUI display item (material, name, lore)