Skip to main content

WorldGuard ExtraFlags Plus

A WorldGuard extension that adds 45+ region flags for player behavior, teleportation, commands, items, blocks, and region rules — with Folia support and fully customizable messages.

GitHub License

:::info Docs sync Documentation aligned with WorldGuardExtraFlagsPlus commit 0e51770 — Release: 4.4.5.

Maintainers: update this block when cutting a release (manual sync; no automation yet). :::

Highlights​

  • Folia ready — async-safe region handling on Folia servers
  • disable-completely — block MACE, FIREWORK_ROCKET, WIND_CHARGE, TOTEM_OF_UNDYING, TRIDENT, GOAT_HORN, vanilla spears (SPEAR or per-tier), with optional PacketEvents / ProtocolLib for full STAB / Lunge coverage
  • disable-throw — block throwing EGG, SNOWBALL, ENDER_PEARL, EXPERIENCE_BOTTLE only (tridents and wind charges stay on disable-completely)
  • console-command-repeat — repeat a console command every 1–60 seconds while a player stays in a region (opt-in in config); cooldown persists across exits
  • console-command-timer — repeat a console command every 1–300 seconds while a player stays in a region; timer resets on exit (hold-to-earn / KOTH semantics, opt-in)
  • deny-mobspawn — block mob spawning by category (ALL_HOSTILE, ALL_NEUTRAL, ALL_PEACEFUL, ALL) or per-entity type
  • entry-permission / entry-deny-permission — permission-based region entry control
  • lightning-damage — lightning visuals without damage (PvP arenas)
  • enderchest-access — per-region ender chest open control (enabled by default in config)
  • entry-min-level / entry-max-level — XP level or PlaceholderAPI integer entry limits
  • Custom messages — messages-wgefp.yml with cooldown (default 2 seconds)
  • Update checker — Spigot, GitHub, and Modrinth
  • EssentialsX integration — godmode and fly flags also disable EssentialsX god/fly when denied

:::warning Do not run both plugins If upgrading from WorldGuardExtraFlags to WorldGuard ExtraFlags Plus:

  • Remove the old WorldGuardExtraFlags.jar
  • Keep only WorldGuardExtraFlagsPlus.jar
  • Both plugins cannot coexist — they will conflict :::

Requirements​

RequirementVersion
Minecraft1.21 – 26.2+
WorldGuard7.0.15+
Java21 (plugin bytecode)
Server softwareSpigot, Paper, Purpur, Folia

The JAR declares api-version: 1.21 in plugin.yml for Paper 1.21.x and forks (e.g. Canvas).

OptionalPurpose
PacketEventsPrimary packet hook for disable-completely (spear Lunge / STAB)
ProtocolLibFallback packet hook when PacketEvents is absent
PlaceholderAPIChat prefix/suffix, integer entry limits, %wgefp_players_in_region_<id>%
EssentialsXGodmode / fly flag integration
TABdisable-collision API integration
DeluxeCombatkeep-inventory combat-log restore

Installation​

  1. Download the latest release from GitHub Releases
  2. Place WorldGuardExtraFlagsPlus.jar in your server's plugins/ folder
  3. Ensure WorldGuard is installed
  4. Restart the server
  5. Edit plugins/WorldGuard/config-wgefp.yml and plugins/WorldGuard/messages-wgefp.yml as needed
  6. Reload with /wgefp reload or /wg reload

Commands​

CommandDescription
/wgefp reloadReload messages-wgefp.yml (aliases: /wgefplus, /worldguardextraflagsplus)

Permissions​

PermissionDescription
worldguardextraflagsplus.reloadUse /wgefp reload
worldguardextraflagsplus.worldedit.bypassBypass worldedit deny regions for WorldEdit / FAWE
worldguardextraflagsplus.worldedit.silent-denySuppress chat when WorldEdit is blocked

Documentation​

Flag overview​

Original ExtraFlags (25): teleport, command, speed, inventory, chat, effects, worldedit, fly, sounds, portals, and more.

Plus additions (22+): disable-completely, disable-throw, entry level limits, entry permissions, villager trade, lightning damage, enderchest-access, collision, block/item control, workbenches, inventory craft, player count limit, deny-mobspawn, console-command-repeat, console-command-timer, hide-players (experimental), chambered-enderpearl (experimental).

See the full flags reference for every flag, accepted values, and examples.

Support​

Authors​