Flag usage examples

All flags use standard WorldGuard syntax:

/rg flag <region> <flag> <value>
/rg flag <region> <flag> clear

Item blocking

disable-completely

Blocks all usage of listed items: MACE, FIREWORK_ROCKET, WIND_CHARGE, TOTEM_OF_UNDYING, TRIDENT, GOAT_HORN, SPEAR (all vanilla spear tiers), or individual spear materials.

:::note permit-completely replaced Use disable-completely instead of the old permit-completely flag. :::

Spear Lunge (packet STAB, including Lunge enchant) needs PacketEvents or ProtocolLib for reliable blocking. Install PacketEvents first; ProtocolLib is used as a fallback.

/rg flag spawn disable-completely MACE
/rg flag spawn disable-completely MACE,FIREWORK_ROCKET,GOAT_HORN
/rg flag spawn disable-completely SPEAR
/rg flag spawn disable-completely IRON_SPEAR
/rg flag spawn disable-completely clear

disable-throw

Blocks throwing only: EGG, SNOWBALL, ENDER_PEARL, EXPERIENCE_BOTTLE. Use disable-completely for tridents and wind charges.

Enable in config-wgefp.yml → all-flags-control.disable-throw (default: true). Customize message disable-throw-blocked in messages-wgefp.yml ({item} placeholder).

/rg flag arena disable-throw EGG,SNOWBALL
/rg flag arena disable-throw ENDER_PEARL
/rg flag arena disable-throw EXPERIENCE_BOTTLE
/rg flag arena disable-throw clear

Entry control

Level restrictions

Supports raw XP level or PlaceholderAPI placeholders (integer output).

/rg flag dungeon entry-min-level 20
/rg flag dungeon entry-min-level 20 XP
/rg flag dungeon entry-min-level 40 %battlepass_tier%
/rg flag dungeon entry-max-level 50

Entry permissions

/rg flag vip entry-permission myPlugin.myPermission.1
/rg flag vip entry-deny-permission myPlugin.myPermission.1

entry-permission requires players to have the given permission node to enter the region. entry-deny-permission denies entry to players holding the given permission node. If both flags are set, entry-permission takes priority.

Player count

/rg flag arena player-count-limit 10

Chambered ender pearl (experimental)

Mitigates chambered ender pearl bypasses. Behavior may change in future releases.

/rg flag spawn chambered-enderpearl deny
/rg flag spawn chambered-enderpearl allow
/rg flag spawn chambered-enderpearl clear

Interaction & environment

/rg flag spawn villager-trade deny
/rg flag spawn enderchest-access deny
/rg flag arena lightning-damage deny
/rg flag spawn disable-collision true
/rg flag hub hide-players true

See flags reference — disable-collision for team/TAB details and troubleshooting.

Block control

/rg flag spawn allow-block-place STONE,COBBLESTONE,GRASS_BLOCK
/rg flag spawn deny-block-place TNT,LAVA_BUCKET
/rg flag spawn allow-block-break STONE,COBBLESTONE
/rg flag spawn deny-block-break BEDROCK,SPAWNER

The order in which the allow/deny checks run is controlled by all-flags-control.check-order in config-wgefp.yml:

• allow-first (default): if a material is in the allow list it is allowed, even if it is also in the deny list.
• deny-first: if a material is in the deny list it is denied, even if it is also in the allow list.

Bucket fill/empty (water and lava) is covered by the block allow/deny flags. See configuration for waterlogged-material-check.

Item drops & pickup

Works when WorldGuard allows drops/pickups in the region.

/rg flag spawn deny-item-drops DIAMOND,EMERALD,NETHERITE_INGOT
/rg flag spawn deny-item-pickup APPLE,REDSTONE,IRON_INGOT

Mob spawning

/rg flag spawn deny-mobspawn ALL_HOSTILE
/rg flag spawn deny-mobspawn ALL_HOSTILE,ALL_NEUTRAL
/rg flag spawn deny-mobspawn ALL
/rg flag spawn deny-mobspawn ZOMBIE,CREEPER
/rg flag spawn deny-mobspawn clear

See deny-mobspawn categories for exactly which mobs each category includes.

Workbenches & crafting

permit-workbenches CRAFT blocks crafting table (3×3) only. Use inventory-craft for inventory (2×2) crafting.

/rg flag spawn permit-workbenches ALL
/rg flag spawn permit-workbenches ALL,ender
/rg flag spawn permit-workbenches craft,anvil,ender
/rg flag spawn permit-workbenches clear
/rg flag spawn inventory-craft deny

Protection & movement

/rg flag spawn godmode deny
/rg flag spawn fly deny
/rg flag spawn keep-inventory true
/rg flag spawn glide force

godmode deny and fly deny also disable EssentialsX god/fly when EssentialsX is installed.

Chat formatting

Supports PlaceholderAPI in prefix/suffix.

/rg flag spawn chat-prefix "&7[%vault_rank%] "
/rg flag spawn chat-suffix " &7[%player_level%]"

Repeating console commands

Opt-in: set all-flags-control.console-command-repeat: true in config-wgefp.yml.

Quote the entire "<seconds> <command>" as one string. Interval: 1–60 seconds. Cooldown persists across region exits — re-entering does not reset the timer.

/rg flag arena console-command-repeat "20 give %player% diamond 1"
/rg flag arena console-command-repeat "5 eco give %player% 10"
/rg flag arena console-command-repeat clear

Timed console commands (hold-to-earn)

Opt-in: set all-flags-control.console-command-timer: true in config-wgefp.yml.

Quote the entire "<seconds> <command>" as one string. Interval: 1–300 seconds. Timer resets on exit — leaving the region cancels the dwell and clears all state. Re-entering starts a fresh wait from zero (hold-to-earn / KOTH semantics). No instant reward on entry; the player must wait the full interval before the first payout.

/rg flag koth console-command-timer "60 give %player% diamond 1"
/rg flag koth console-command-timer "120 eco give %player% 50"
/rg flag koth console-command-timer clear

Teleportation & commands

/rg flag lobby teleport-on-entry world,0,64,0,0,0
/rg flag lobby console-command-on-entry "eco give %player% 100"
/rg flag lobby command-on-entry "say Welcome, %player%!"

Command placeholders: %player%, %username%, %uuid%, {player}, {username}, {uuid} (player name or UUID string).

teleport-on-exit only triggers on real movement out of a region (walking, riding, knockback) — teleports (/wild, /spawn, /warp, ender pearls, portals) and respawn are ignored by default. Toggle with all-flags-control.teleport-on-exit-ignore-teleports (default true; set to false to restore the legacy always-pull behavior).

Effects & sounds

/rg flag spawn blocked-effects BLINDNESS,SLOWNESS
/rg flag spawn give-effects night_vision,strength:1:false
/rg flag spawn play-sounds minecraft:block.note_block.pling

give-effects accepts night_vision, minecraft:night_vision, and optional amplifier:particles format.

PlaceholderAPI — players in region

Requires PlaceholderAPI on the server. Toggle with all-flags-control.papi-placeholders in config-wgefp.yml (default false — opt-in, set to true to enable).

%wgefp_players_in_region_spawn%     # players currently inside the "spawn" region

• Region id is case-insensitive and may contain underscores (they are kept, not split).
• Sums players across all worlds that have a region with the same id.
• Returns 0 when the region doesn't exist or is empty.
• Values are cached and refreshed once per second; each player is counted on their own region thread (Folia-safe).

Flag categories

Category	Flags
Location & teleportation	teleport-on-entry, teleport-on-exit, join-location*, respawn-location
Command execution	command-on-entry, command-on-exit, console-command-on-entry, console-command-on-exit, console-command-repeat, console-command-timer
Movement & speed	walk-speed, fly-speed, fly, glide, frostwalker
Protection & survival	godmode, keep-inventory, keep-exp, item-durability
Chat	chat-prefix, chat-suffix
Effects	blocked-effects, give-effects, play-sounds
World interaction	worldedit, nether-portals, chunk-unload, villager-trade, enderchest-access, inventory-craft
Block & item control	allow-block-place, deny-block-place, allow-block-break, deny-block-break, deny-item-drops, deny-item-pickup, disable-completely, disable-throw, permit-workbenches
Mob & spawn control	deny-mobspawn
Entry control	entry-min-level, entry-max-level, entry-permission, entry-deny-permission, player-count-limit
Special	disable-collision, hide-players, lightning-damage, chambered-enderpearl

* join-location is not available on Folia. Flags marked * are experimental or require config opt-in.

Notes

• Use clear to remove a flag value
• Some flags require PlaceholderAPI for placeholder-based values
• Toggle individual flags in configuration → all-flags-control
• Full per-flag descriptions: flags reference