PlotsNRaids

# ️ PlotsNRaids [1.20.4 - 1.21.x]
### Next-Gen Base Claims, Core Shields, Interactive Upgrades & Siege Raids

**PlotsNRaids** is an advanced base protection and siege plugin designed for modern survival, factions, and RPG servers.

Unlike traditional claim plugins with static, indestructible borders, **PlotsNRaids** turns base building into an engaging tactical gameplay experience: each plot is anchored by a **Plot Core Block** protected by an energy **Shield**, which can be upgraded, allied, defended, or besieged by raiders!

---

### ✨ Features

* **Instant Core Claiming:** Simply place down a **Plot Core Block** to establish your plot.
* ⚡ **Two-Tier Health System (Shield & Core):**
* Every base has a **Shield HP** and separate **Core HP**.
* While the shield is active, all blocks, chests, and entities within the base are 100% protected.
* Attackers can weaken the shield by mining hard building blocks (obsidian, stone, bricks, planks) or firing TNT cannons!
* When the shield drops to `0 HP`, the base is breached and the Core is exposed to attacks.
* **TNT Cannon Sieges:** TNT blasts damage active shields (-20 HP per explosion) without destroying the core until the shield falls.
* **Comprehensive Grief Prevention:**
* Complete protection against fire spread, ignition, and piston pushing across borders.
* Water and lava cannot overflow into active plots from outside or ceiling boundaries.
* Tamed pets, farm animals, villagers, and armor stands cannot be harmed by intruders.
* Blocks certain teleportation and home commands (`/sethome`, `/tpahere`, `/tpaccept`) on foreign plots.
* **Interactive Upgrade Tree GUI:** Right-click the Core Block to purchase upgrades using **Upgrade Crystals**:
* **Max Shield HP:** Increase total base shield health.
* **Horizontal Radius (X/Z):** Expand plot borders outwards.
* **Vertical Expansion (+Y / -Y):** Expand upward build height and downward depth.
* **HP Regeneration:** Passive healing for shield and core when no enemies are nearby.
* **Allies & Granular Permissions GUI:**
* Open with `/plot allies` or via the Core GUI.
* Toggle 5 separate permissions per ally: *Break Blocks*, *Place Blocks*, *Interact (Chests/Doors/Buckets)*, *Damage Entities*, and *Manage Core Upgrades*.
* Add online players with a single click from the player head menu.
* **Per-Player Multi-Language System:**
* Fully configurable `lang/` folder with built-in **English (`en_us.yml`)** and **Polish (`pl_pl.yml`)**.
* Each player can toggle their own language on the fly (`/plot lang <code>` or via the GUI).
* Items automatically synchronize in the player's inventory to always stack properly.
* **DecentHolograms & PlaceholderAPI Support:**
* Displays floating holograms above plot cores translated into each viewing player's chosen language.
* Automatically falls back to lightweight Bukkit ArmorStands if DecentHolograms is not installed.
* ️ **WorldGuard Integration:** Automatically detects WorldGuard to prevent claiming or expanding plots into server-protected regions (e.g., Spawn / Warzone).

---

### Commands & Permissions

#### Player Commands (`/plot`, aliases: `/p`, `/plots`)
* `/plot` – Displays the help menu in the player's chosen language.
* `/plot allies` – Opens the Allies & Permissions management GUI.
* `/plot add <player>` – Adds an ally to the plot you are standing on.
* `/plot remove <player>` – Removes an ally from the plot you are standing on.
* `/plot info` – Displays plot coordinates, borders, HP status, and allies.
* `/plot list` – Lists all your claimed plots and their current HP.
* `/plot lang <code>` – Switches personal language (`en_us`, `pl_pl`, etc.).

#### Administrator Commands (`/plotadmin`, alias: `/padmin`)
*Permission: `plots.admin`*
* `/plotadmin give [player]` – Gives 1x Plot Core Block and 64x Upgrade Crystals.
* `/plotadmin reload` – Reloads `config.yml`, language files in `lang/`, and plot data.

---

### Requirements & Compatibility

* **Server Software:** Paper, Purpur, or Spigot (Minecraft 1.20.4 – 26.3)
* **Java Version:** Java 21+
* **Optional Integrations:**
* **DecentHolograms** & **PlaceholderAPI** *(Recommended for per-player translated holograms)*
* **WorldGuard** *(Recommended for spawn/warzone conflict protection)*
```