---

📖 About

WorldGuardFlagPanel is a lightweight Paper/Folia plugin that adds a fully interactive in-game GUI to manage WorldGuard region flags — no complex commands needed.

Instead of typing /region flag <region> <flag> <value> every time, simply open the panel, click a flag, and the value cycles or a form opens for you to type a new one. Changes are saved instantly.

---

✨ Key Features

🖱️ Native In-Game Panel

• Click-through interface — Flags are listed with their current value; one click toggles or opens an editor
• State flags — Cycle through ALLOW → DENY → (unset) with a single click
• Boolean flags — Toggle TRUE / FALSE instantly
• Text / numeric flags — Opens a native input form pre-filled with the current value
• Set flags — Multiline editor, one entry per line
• game-mode flag — Dropdown selector: Survival, Creative, Adventure, Spectator
• Location flags — Accepts x,y,z or x,y,z,world format

🏝️ Smart Region Detection

• Auto-detect — Opens the panel for the region you're standing in
• Multi-region selector — If you're inside overlapping regions, a picker lets you choose which one to edit
• Direct access — Target any region by name: /wgfpanel <region>
• Global region — Falls back to __global__ when no region is found at your position

🌍 Multi-language Support

• Ships with fr_FR 🇫🇷 and en_GB 🇬🇧
• Language is picked automatically from each player's Minecraft client locale
• Fully customizable via .toml files

⚡ Performance

• Instant saves — Region changes are persisted to disk immediately after each edit

---

📋 Requirements

Component	Minimum version
Paper or Folia	1.21.8
WorldGuard	7.0.13
WorldEdit	7.3.11
Java	21

---

🚀 Installation

1. Download the latest .jar from GitHub Releases.
2. Place it in your server's plugins/ folder.
3. Make sure WorldGuard and WorldEdit are already installed.
4. Restart the server.

No configuration file is required to get started.

---

🎮 Commands

/wgfpanel [region]

Usage	Behaviour
/wgfpanel	Opens the panel for the region at your position. Shows a region selector if multiple regions overlap.
/wgfpanel <region>	Opens the panel for the specified region, wherever you are.

Tab-completion is available for region names.

---

🔐 Permissions

Permission	Description	Default
worldguardflagpanel.use	Allows opening the panel for regions the player owns	OP
worldguardflagpanel.admin	Full access to all regions in any world	OP

Without worldguardflagpanel.admin, players can only edit regions where they are set as owner in WorldGuard.

---

🌍 Languages

The plugin ships with two built-in translations:

• 🇫🇷 fr_FR — French
• 🇬🇧 en_GB — English

The displayed language is automatically determined by each player's Minecraft client locale — no configuration needed.

To customize messages, edit the .toml files located in:

plugins/WorldGuardFlagPanel/language/

---

📊 Statistics

This plugin collects anonymous usage statistics (server count, player count) via FastStats. No personal data is ever transmitted. These metrics help track adoption and guide future development.

---

📞 Support

• GitHub: Euphillya/WorldGuardFlagPanel
• Issues: Report a bug
• Discord: Join the discussion

---

📜 License

WorldGuardFlagPanel is open source. See the LICENSE file for details.