🛡️ RaidGuard

RaidGuard is a modern, action-packed base claim and raid plugin for Minecraft (Paper / Purpur / Spigot 1.20 – 26.3).

Unlike traditional claim plugins with static, indestructible borders, RaidGuard turns base building into an engaging siege experience: each plot is powered by a Plot Core Block protected by an energy Shield, which can be upgraded, allied, defended, or raided!

---

✨ Key Features

• 💎 Instant Core Claiming: Simply place down a Plot Core Block to claim your land.
• ⚡ Shield & Core Mechanics:
  • Every base has a Shield HP and separate Core HP.
  • While the shield is active, all blocks, chests, and entities are completely protected.
  • Raiders can weaken the shield by mining hard building blocks or blasting the perimeter with TNT cannons!
  • Once the shield drops to 0 HP, the base is breached and the Core is vulnerable.
• 🧱 Complete Grief Protection: Prevents griefing from fire, explosions outside borders, pistons, liquid overflows, and hostile mobs.
• 💰 Dual Upgrade Currency (Crystals or Vault Economy): Choose whether players upgrade their bases using Upgrade Crystals or Server Money (Vault / EssentialsX).
• 🛠️ Configurable In-Game Crafting: Craft both the Plot Core Block and Upgrade Crystal with custom 3x3 recipes customizable directly in config.yml.
• 📈 Interactive Upgrade GUI: Upgrade base stats (Shield HP, Radius, Height, Depth, HP Regeneration) directly from the Core.
• 👥 Allies & Granular Permissions GUI: Manage your team and toggle specific permissions (Break, Place, Interact, Damage Entities, Manage Upgrades) per ally.
• 🔔 Built-in Modrinth Update Checker: Automatically checks for new plugin releases and alerts the console and server operators (OP) only on join.
• 🌐 Per-Player Multi-Language: Built-in English (en_us) and Polish (pl_pl) support — players can toggle their own language on the fly (/plot lang).
• 🔮 DecentHolograms & PlaceholderAPI Support: Displays dynamic holograms above the core translated into each viewing player's chosen language.

---

🎥 Showcase & Mechanics

🔴 Dynamic Border Visualization

Borders are rendered with sleek particle walls that automatically hide along shared borders between allied plots.

!Border visualization

---

💧 Water & Lava Overflow Protection

Liquids cannot flow across borders into active plots from outside or above ceiling boundaries.

!Water/Lava overflow protection

---

🐾 Animal & Entity Protection

Tamed pets, farm animals, villagers, and armor stands are completely safe from intruders while the shield is active.

!Animal protection

---

🔨 Raiding & Attacking Bases

Enemies can attack base shields by mining hard building blocks (stone, bricks, obsidian, wood planks) with a raid cooldown.

!Atacking the base mechanics

---

💣 TNT Cannon Sieges

TNT explosions deal direct damage to the shield (-20 HP per blast) without destroying the core until the shield falls!

!Simple TNT canon

---

⚙️ Upgrades & Core GUI

Right-click your Core Block to open the upgrade tree:

• Max Shield HP: Increase total base shield health.
• Horizontal Radius (X/Z): Expand plot borders outwards.
• Vertical Expansion (+Y / -Y): Expand ceiling height and bedrock depth.
• Regeneration Rate: Regenerate shield and core HP over time when no enemies are nearby.
• Allies Management: View and configure ally permissions. !Simple upgrading system

---

📋 Commands & Permissions

Player Commands (/plot, aliases: /p, /plots)

Command	Description
/plot	Shows the help menu in your 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	Shows plot stats, coordinates, borders, and allies
/plot list	Lists all your claimed plots and their HP
/plot lang <code>	Switches your personal language (e.g. en_us, pl_pl)

Admin Commands (/plotadmin, alias: /padmin)

Permission: plots.admin

Command	Description
/plotadmin give [player]	Gives 1x Plot Core Block and 64x Upgrade Crystals
/plotadmin reload	Reloads config.yml, language files, recipes, and plot data

---

🔌 Integrations (Optional)

• [Vault] + Economy Provider (e.g. EssentialsX): Allows buying plot upgrades using in-game server economy/money instead of Upgrade Crystals.
• [DecentHolograms] + [PlaceholderAPI]: Highly recommended for dynamic, per-player translated holograms floating above plot cores. (Plugin includes automatic ArmorStand fallback if not present).
• [WorldGuard]: Prevents claiming or expanding plots into server regions (e.g., Spawn / Warzone).