Configuration

WorldGuard ExtraFlags Plus stores its files in the WorldGuard plugin folder:

plugins/WorldGuard/
├── config-wgefp.yml      # Plugin behavior & flag toggles
└── messages-wgefp.yml    # Customizable player messages

Reload both with /wgefp reload or /wg reload.

config-wgefp.yml

Master flag control (all-flags-control)

Each flag can be enabled or disabled globally. Disabled flags are not registered — useful to avoid Paper deprecation warnings for unused flags.

Setting	Default	Notes
Most flags	true	Standard flags enabled (includes enderchest-access)
hide-players	false	Experimental — opt-in
console-command-repeat	false	Opt-in repeating commands
console-command-timer	false	Opt-in hold-to-earn timer commands
papi-placeholders	false	Opt-in %wgefp_players_in_region_<id>%
teleport-on-exit-ignore-teleports	true	Ignore teleports/respawn for teleport-on-exit
check-order	allow-first	Block allow/deny evaluation order (deny-first alternative)

Key toggles for Plus flags:

all-flags-control:
  disable-completely: true
  disable-throw: true
  console-command-repeat: false
  console-command-timer: false
  papi-placeholders: false
  hide-players: false
  chambered-enderpearl: true
  lightning-damage: true
  deny-mobspawn: true
  join-location: true   # set false on Folia or if unused
  teleport-on-exit-ignore-teleports: true
  check-order: allow-first   # or deny-first

Permit workbenches (permit-workbenches)

Setting	Default	Description
permit-workbench-block-placement-too	false	Also block placing workbench blocks
permit-all-includes-enderchest	false	ALL keyword includes ender chests

Godmode (godmode)

Setting	Default	Description
auto-give-godmode-region-left	false	Restore godmode when leaving region

Keep inventory (keep-inventory)

Setting	Default	Description
combat-log-restore	true	DeluxeCombat: restore inventory after combat-log in keep-inventory regions

Allow block place / break

Setting	Default	Description
allow-block-place.require-membership	false	Whitelist only applies to region members/owners
allow-block-break.require-membership	false	Same for block break whitelist
allow-block-break-settings.waterlogged-material-check	both	Bucket fill/break on waterlogged blocks: both, host, or liquid

Bucket water/lava pickup and placement is evaluated through the block allow/deny flags. waterlogged-material-check controls whether the host block, liquid, or both are checked.

Logging (logging)

Setting	Default	Description
verbose-startup-logs	false	Detailed startup lines (config paths, collision banner, chunk tickets)

YAML defensive loading

config-wgefp.yml and messages-wgefp.yml use defensive loading:

• Oversize files (>300 KB) are quarantined to <name>.corrupt.<timestamp> and defaults are regenerated (plugin keeps loading).
• At most 3 corrupt backups are kept per file type.
• YAML parse failures attempt one auto-recovery before disabling the plugin.
• Direct WGEFP YAML writes use atomic temp-file replacement to reduce crash corruption.

messages-wgefp.yml

All player-facing messages are customizable.

• Edit text to match your server style
• Color codes supported (&c, &7, etc.)
• Set a message to "" to disable it
• Common placeholders: {permission}, {required}, {current}, {item}, {workbench}
• disable-throw-blocked uses {item}
• disable-completely-blocked for blocked item usage

Message cooldown

Default 2 seconds between repeated denial messages to prevent spam. Configured in the messages file / plugin defaults. Existing servers keep their configured value on upgrade.

Update checker

Automatically checks Spigot, GitHub, and Modrinth for new releases on startup.

Optional integrations

Plugin	Feature
PacketEvents	Primary disable-completely packet hooks
ProtocolLib	Fallback packet hooks
PlaceholderAPI	Chat prefix/suffix, entry level placeholders, players-in-region placeholder
EssentialsX	Godmode / fly flag sync
TAB	disable-collision via TAB API
DeluxeCombat	keep-inventory combat-log restore

Related

• Flag usage examples
• Flags reference
• deny-mobspawn categories