Minecraft-Plugin WorldGuardExtraFlags

🔌 About WorldGuard Extra Flags

WorldGuard Extra Flags is a Bukkit/Spigot extension for WorldGuard that provides additional region flags you can set with WorldGuard's region flag commands. It does not replace WorldGuard — it registers extra flags that alter player behavior, chat, movement, effects and other region-specific mechanics.

🎯 Purpose

The plugin's purpose is to extend WorldGuard's region system so server administrators can apply more granular rules and actions to regions without writing custom scripts. Flags cover things like teleport behavior, command execution, movement modifiers, temporary effects, and respawn location handling.

⚙️ Features

• Teleport on region entry and exit (teleport-on-entry, teleport-on-exit).
• Run player or console commands on entry/exit (command-on-entry/exit, console-command-on-entry/exit).
• Join-location and respawn-location flags to move players on login or respawn.
• Movement and flight controls (walk-speed, fly-speed, fly, glide).
• Inventory and experience behaviour (keep-inventory, keep-exp).
• Give temporary potion effects on region entry and restore them on leave (give-effects).
• Chat prefix/suffix when inside a region (chat-prefix, chat-suffix).
• Play sounds inside a region (play-sounds).
• Block and effect controls (blocked-effects, frostwalker, nether-portals, item-durability).
• Control chunk unloading and WorldEdit usage inside regions (chunk-unload, worldedit).

🧩 Who It Is For

Server owners and administrators who already use WorldGuard and need additional per-region behavior without custom plugins or scripts. Useful on survival, SMP and creative servers where region-specific rules, portals, or entry/exit actions are required.

🏗️ Example Use Cases

• Teleport players to a lobby when they enter a spawn region and run a welcome command.
• Grant temporary movement speed or potion effects while inside an event arena and restore previous effects when they leave.
• Prevent nether portal creation in protected towns while allowing portals in other regions.
• Set a region-specific respawn point for a dungeon or arena.

⚙️ Installation

📥 Setup

• Download the official plugin JAR and place it in your server's plugins/ folder.
• Restart the server and check the server console to confirm the plugin and its flags registered correctly.
• Set flags using WorldGuard's region flag command (for example, using rg flag <region> <flag> <value>).

📦 Dependencies

• WorldGuard (required). Ensure you use a WorldGuard version compatible with the plugin build.

🧠 Technical Notes

• Flags are registered with WorldGuard and are used via WorldGuard's existing region commands.
• Administrators bypass most flags by default to allow region management; this bypass behavior can be changed with WorldGuard's bypass settings.
• The plugin maintains multiple flag types (booleans, numeric values, lists, commands, potion/effect definitions) consistent with WorldGuard's flag system.

🤝 When This Plugin Is Useful

If you need more per-region control than vanilla WorldGuard offers—such as running commands, teleporting on entry/exit, or applying temporary effects—WorldGuard Extra Flags provides many common, ready-made flags that integrate directly with WorldGuard's region system.