Flags reference

Complete reference for all 47+ flags in WorldGuard ExtraFlags Plus.

Syntax: /rg flag <region> <flag> <value> — use clear to remove a value.

Location & teleportation

Flag	Description	Values	Example
teleport-on-entry	Teleport player on region entry	world,x,y,z,yaw,pitch	/rg flag spawn teleport-on-entry world,0,64,0,0,0
teleport-on-exit	Teleport player on region exit	world,x,y,z,yaw,pitch	/rg flag spawn teleport-on-exit world,0,64,0,0,0
join-location	Login spawn inside region	world,x,y,z,yaw,pitch	/rg flag spawn join-location world,0,64,0,0,0
respawn-location	Death respawn override in region	world,x,y,z,yaw,pitch	/rg flag spawn respawn-location world,0,64,0,0,0

:::info Folia join-location is not available on Folia. Disable it in config if unused to silence Paper warnings. :::

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. Set all-flags-control.teleport-on-exit-ignore-teleports to false to restore the legacy always-pull behavior.

Command execution

Flag	Description	Values	Example
command-on-entry	Run as player on entry	command string	/rg flag spawn command-on-entry "say Welcome, %player%!"
command-on-exit	Run as player on exit	command string	/rg flag spawn command-on-exit "say Goodbye!"
console-command-on-entry	Run from console on entry	command string	/rg flag spawn console-command-on-entry "eco give %player% 100"
console-command-on-exit	Run from console on exit	command string	/rg flag spawn console-command-on-exit "eco take %player% 100"
console-command-repeat	Repeat console command on interval while inside region	"<seconds> <command>" (1–60s)	/rg flag arena console-command-repeat "20 give %player% diamond 1"
console-command-timer	Repeat console command on interval while inside region; timer resets on exit	"<seconds> <command>" (1–300s)	/rg flag koth console-command-timer "60 give %player% diamond 1"

console-command-repeat and console-command-timer are disabled by default — enable in config-wgefp.yml. Repeat cooldown persists across exits; timer resets on exit (hold-to-earn / KOTH semantics).

Command placeholders: %player%, %username%, %uuid%, {player}, {username}, {uuid}.

Movement & speed

Flag	Description	Values	Example
walk-speed	Walk speed in region	-1.0 to 1.0	/rg flag spawn walk-speed 0.5
fly-speed	Fly speed in region	-1.0 to 1.0	/rg flag spawn fly-speed 0.3
fly	Allow/deny flight	allow / deny	/rg flag spawn fly deny
glide	Elytra control	allow / deny / force	/rg flag spawn glide force
frostwalker	Frost Walker enchant	allow / deny	/rg flag spawn frostwalker deny

fly deny also disables EssentialsX flight when EssentialsX is installed.

Protection & survival

Flag	Description	Values	Example
godmode	Invulnerability in region	allow / deny	/rg flag spawn godmode allow
keep-inventory	Keep inventory on death	true / false	/rg flag spawn keep-inventory true
keep-exp	Keep XP on death	true / false	/rg flag spawn keep-exp true
item-durability	Item durability loss	allow / deny	/rg flag spawn item-durability deny

godmode integrates with EssentialsX. keep-inventory can restore inventory on combat-log with DeluxeCombat (see configuration).

Chat

Flag	Description	Values	Example
chat-prefix	Prefix for chat in region	text (PlaceholderAPI)	/rg flag spawn chat-prefix "&7[Spawn] "
chat-suffix	Suffix for chat in region	text (PlaceholderAPI)	/rg flag spawn chat-suffix " &7[Lv %player_level%]"

Effects

Flag	Description	Values	Example
blocked-effects	Block potion effects	effect names	/rg flag spawn blocked-effects BLINDNESS,SLOWNESS
give-effects	Apply effects while inside	effect:amp:particles	/rg flag spawn give-effects night_vision,strength:1:false
play-sounds	Play sounds in region	sound data	/rg flag spawn play-sounds minecraft:block.note_block.pling

World interaction

Flag	Description	Values	Example
worldedit	WorldEdit / FAWE in region	allow / deny	/rg flag spawn worldedit deny
nether-portals	Nether portal use/creation	allow / deny	/rg flag spawn nether-portals deny
chunk-unload	Prevent chunk unload	allow / deny	/rg flag spawn chunk-unload deny
villager-trade	Villager trading	allow / deny	/rg flag spawn villager-trade deny
enderchest-access	Ender chest access	allow / deny	/rg flag spawn enderchest-access deny
inventory-craft	Inventory 2×2 crafting	allow / deny	/rg flag spawn inventory-craft deny

Bypass WorldEdit deny with permission worldguardextraflagsplus.worldedit.bypass.

Block & item control

Flag	Description	Values	Example
allow-block-place	Whitelist placeable blocks	materials	/rg flag spawn allow-block-place OAK_PLANKS,STONE
deny-block-place	Blacklist placeable blocks	materials	/rg flag spawn deny-block-place TNT,LAVA
allow-block-break	Whitelist breakable blocks	materials	/rg flag spawn allow-block-break GLASS
deny-block-break	Blacklist breakable blocks	materials	/rg flag spawn deny-block-break DIAMOND_BLOCK
deny-item-drops	Block dropping items	materials	/rg flag spawn deny-item-drops DIAMOND
deny-item-pickup	Block picking up items	materials	/rg flag spawn deny-item-pickup DIAMOND
disable-completely	Block item usage entirely	MACE, SPEAR, TRIDENT, GOAT_HORN, etc.	/rg flag spawn disable-completely MACE,SPEAR
disable-throw	Block throwing throwables	EGG, SNOWBALL, ENDER_PEARL, EXPERIENCE_BOTTLE	/rg flag spawn disable-throw EGG,SNOWBALL
permit-workbenches	Block workbench types	ALL, CRAFT, ANVIL, etc.	/rg flag spawn permit-workbenches ALL

allow-block-place / allow-block-break support optional member-only mode in config. Evaluation order when both allow and deny lists are set is controlled by all-flags-control.check-order (allow-first default, or deny-first). Bucket fill/empty is covered by block allow/deny flags.

Mob & spawn control

Flag	Description	Values	Example
deny-mobspawn	Block mob spawning by category or entity type	ALL_HOSTILE, ALL_NEUTRAL, ALL_PEACEFUL, ALL, entity names	/rg flag spawn deny-mobspawn ALL_HOSTILE

See deny-mobspawn categories for per-category mob lists.

Entry control

Flag	Description	Values	Example
entry-min-level	Minimum XP level or PAPI value	number / placeholder	/rg flag dungeon entry-min-level 20
entry-max-level	Maximum XP level or PAPI value	number / placeholder	/rg flag dungeon entry-max-level 50
entry-permission	Permission required to enter	permission node	/rg flag vip entry-permission myPlugin.myPermission.1
entry-deny-permission	Permission that denies entry	permission node	/rg flag vip entry-deny-permission myPlugin.myPermission.1
player-count-limit	Max players in region	integer	/rg flag arena player-count-limit 10

If both entry-permission and entry-deny-permission are set, entry-permission takes priority.

Special features

Flag	Description	Values	Example
disable-collision	Disable player collision	true / false	/rg flag spawn disable-collision true
hide-players	Hide players from each other (experimental)	true / false	/rg flag hub hide-players true
chambered-enderpearl	Chambered pearl mitigation (experimental)	allow / deny	/rg flag spawn chambered-enderpearl deny
lightning-damage	Lightning damage (visuals remain)	allow / deny	/rg flag arena lightning-damage deny

disable-collision

Disables player-to-player collision inside a region. Players can walk through each other — useful for spawn areas, hubs, and crowded lobbies.

/rg flag spawn disable-collision true
/rg flag spawn disable-collision false
/rg flag spawn disable-collision clear

How it works

The flag uses Minecraft's native scoreboard team system — the only reliable way to control entity-to-entity collision.

1. Single-player teams — If a player is alone on their team, the plugin temporarily sets collision to NEVER, then restores the original rule on exit.
2. Multi-member teams — If the player shares a team with others, a temporary per-player team (WGC_<hash>) is created so other members are unaffected. The player is restored to their original team on exit.
3. No team — Player is added to a per-player team with collision disabled, then removed on exit.

When TAB is installed, the plugin uses TAB's API to set collision rules. TAB integration takes priority over direct team manipulation. Without TAB, the plugin falls back to direct scoreboard team changes.

Compatibility

Plugin	Status
TAB	Fully supported (API integration)
Most plugins	Generally compatible
CMI, NametagEdit, DeluxeTags, VentureChat, LuckPerms	May conflict — team collision changes
Party / guild / PvP plugins	Coordinate team usage

On startup, the plugin may warn if other team-using plugins are detected. TAB is the only plugin with official API integration support.

Team conflict edge cases

1. Shared teams — Only the entering player is moved to a per-player team; teammates stay unchanged.
2. Other plugins modifying teams — Stored collision rules are restored on exit, which may overwrite another plugin's changes made while the player was inside the region. Coordinate team usage with other plugins, or ensure players in collision-disabled regions are not in shared teams.
3. Deleted teams — If a team is deleted while a player is inside, restoration fails gracefully (player ends with no team).

Troubleshooting

Players still collide

1. Verify the flag: /rg flags <region> → disable-collision: true
2. Confirm the player is inside the region: /rg info <region>
3. Check server logs for [Collision] or [Collision Flag] warnings
4. Reload: /wgefp reload or /wg reload

Conflicts with other plugins

1. Identify team-using plugins (TAB, CMI, NametagEdit, party plugins, guild plugins, PvP arena plugins, etc.)
2. Test with other plugins temporarily disabled
3. Re-enable one by one to find the conflict

Players kicked on entry

1. Check logs for IllegalStateException or team-related errors
2. Team names use format WGC_<hash> (12 chars, within Minecraft's 16-char limit)
3. Ensure the server scoreboard system is healthy — restart the server if the scoreboard seems corrupted

Per-player team name format: WGC_<hash> — e.g. WGC_a1b2c3d4 (4-char prefix + 8-char hex from UUID hashCode()).

PlaceholderAPI

Requires PlaceholderAPI and all-flags-control.papi-placeholders: true in config (opt-in).

Placeholder	Description
%wgefp_players_in_region_<regionId>%	Number of online players inside the region (summed across all worlds, case-insensitive id, refreshed once per second)

In-game flag help

The plugin exposes flag metadata for external tools (e.g. WG-GUI). Use /wgefp commands where available on your server build.