ZoneGuard

# 🛡️ ZoneGuard — Region Protection for Paper & Folia **ZoneGuard** is a lightweight, no-nonsense region protection plugin. Define zones, set rules, and protect your world — with zero external dependencies and full Folia support. → Commands information are written in French, if requested I can change the language to english in game. --- ## ✨ What ZoneGuard Does - Protect areas from **block breaking, block placing, and interactions** - Block **PvP and PvE** damage in safe zones - Prevent **explosions, fire spread, mob spawning, hunger loss, and fall damage** - Define zones as a **rectangle (cuboid)** or any **custom polygon shape** - Apply rules **globally per world** without needing a region - Visualize your selection and zones live with **colored particle outlines** - Everything saves **asynchronously** — zero server lag --- ## 🚀 Quick Start ### 1. Select your zone Hold a **Wooden Axe**, then run: ``` /zg edit → cuboid mode (left-click = pos 1, right-click = pos 2) /zg edit any → polygon mode (right-click = add point, left-click = close) ``` ### 2. Create the zone ``` /zg define ``` ### 3. Protect it ``` /zg flag block-break deny /zg flag block-place deny /zg flag pvp deny ``` That's it. Your zone is live. ✅ --- ## 🏳️ All Available Flags | Flag | What it controls | |---|---| | `block-break` | Block destruction | | `block-place` | Block placement | | `interact` | Interactions with blocks & entities | | `sign` | Editing and dyeing signs | | `explosions` | Explosion block damage | | `fire-spread` | Fire ignition and spreading | | `monster-spawn` | Monster spawning | | `animal-spawn` | Animal spawning | | `hunger` | Player hunger loss | | `damage` | All general damage | | `fall-damage` | Fall damage | | `pve` | Entity damage against players | | `pvp` | Player vs. player combat | Each flag accepts: **`allow`** · **`deny`** · **`unset`** --- ## 🌍 World-Wide Rules (Global Flags) Apply flags to an entire world without creating a region: ``` /zg flag global pvp deny → applies to the world you're in /zg flag global:survival monster-spawn deny → applies to any world by name ``` **Priority:** Region flags always override global world flags. --- ## 📋 All Commands | Command | Description | |---|---| | `/zg edit [any]` | Start a cuboid or polygon selection | | `/zg define ` | Create a zone from your selection | | `/zg list` | List all zones | | `/zg info ` | Show zone details and active flags | | `/zg see ` | Preview a zone with particles | | `/zg flag ` | Set a flag | | `/zg flaglist` | List all flags and descriptions | | `/zg delete ` | Delete a zone | | `/zg reload` | Reload zones from disk | | `/zg save` | Trigger an async save | **Permission:** `zoneguard.admin` (default: OP) > Admins in **Creative mode** automatically bypass all protections. --- ## 📦 Requirements - **Paper or Folia 1.21+** - **Java 21+** - No other plugins required --- ## 📄 License ZoneGuard is free and open source under the **GNU GPL-3.0** license. Any derivative work must also be released under the same license. → [View source on GitHub](https://github.com/NicolasLasch/ZoneGuard)