✨ What’s New & Improved
This update is a focused polish-and-power pass that brings cleaner menus, clearer protections, and a smoother progression path. Everything should now feel more unified inside the Guardian Codex.

• Sidebar system removed
  • The legacy sidebar fell out of place with the rest of AegisGuard’s design.
  • Key info is now better represented through the integrated Claim Status experience.
• Claim Status is now your main insight hub
  • Cleaner at-a-glance visibility of your land’s active bonuses & effects.
  • Clearer territory size & progression overview.
  • Pairs perfectly with expansion and ascension-based growth.
• Expansion Requests polished
  • Fixed missing keys and messaging consistency issues.
  • Clean return-to-menu flow after selecting an expansion tier.
  • Duplicate approval/denial messages removed.
  • Results now display clearly as approved/denied by Admin.
• Plot Ascension (Level Up GUI) reforged
  • The ascension experience is now more readable, more purposeful, and better connected to claim growth.
  • Config-driven progression paths:
    • Ascension expansion OFF: plot size increases through Expansion Requests.
    • Ascension expansion ON: plot size can grow through leveling based on your economy and funds.
  • Server owners can choose between admin-governed growth or player-driven RPG progression.
• Mob Protection & SafeZone behavior clarified
  • Mob Protection ON: AegisGuard actively protects you inside the claim.
  • Mob Protection OFF: auto mob repel/removal tasks for that plot are disabled.
  • Mobs will spawn and behave like vanilla and can hurt players normally.
  • SafeZone remains the master umbrella: if SafeZone is ON, your land stays protected even with mob protection OFF.
  • Perfect for building mob arenas, PvP plots, or challenge zones with clean rule control.
• Protection settings no longer feel inverted
  • All protections now follow one simple rule:
    • ON means actively protecting.
    • OFF means fully disabled.
  • Thanks to TechNot for helping spotlight the earlier confusion.
• Aegis Scepter tooltip cleanup
  • Removed the extra “Right-click: Open Aegis Menu” text for a cleaner item description.
  • Selection and wand logic remains intact.

Known Issue (Help Wanted)
A small number of servers may still see an occasional movement-related warning/error under specific conditions. It’s been difficult to reproduce consistently, so community reports are extremely helpful.

• If you encounter this issue, please:
  • Join the Discord and submit a bug report, or
  • Open an Issue on GitHub.
• Helpful details:
  • Full server log around the error
  • AegisGuard version + server version
  • Storage type (YML/SQL/etc.)
  • What you were doing in-game when it occurred
  • Any plugins that affect movement, regions, or teleporting

✅ Summary

• Cleaner Codex experience with the sidebar retired
• Claim Status now acts as the better unified info view
• Expansion approvals/denials are consistent and non-duplicated
• Plot Ascension feels sharper and properly tied to growth settings
• Mob protection now behaves like vanilla when you disable it
• All protection toggles are aligned with their labels

️ AegisGuard v1.2.2
Stability & Protection Update

This update focuses on strengthening AegisGuard’s core systems to ensure long-term reliability, data safety, and modern server compatibility.

Improved Plot Protection
• Plots are now fully protected from the sky down to bedrock
• Vertical protection is consistent across all worlds
• Eliminates edge cases involving underground or high-altitude interactions

Storage System Improvements
• Major improvements to both YML and MYSQL data stores
• All core and advanced plot features are now persistently saved
• Includes roles, flags, zoning, biomes, warps, cosmetics, likes, bans, and more
• Data is reliably preserved across restarts and unexpected crashes
• Storage behavior is consistent regardless of chosen backend

⚙️ Folia Compatibility
• AegisGuard now properly supports modern Folia environments
• Improved task handling and data operations on Folia servers
• Ensures compatibility with newer server builds

Feedback & Support
If you experience any issues or notice anything unexpected:
• Join the Discord for support and discussion
• Or submit a bug report or feature issue on GitHub

Every report helps improve AegisGuard and guides future updates.

Thank you for your continued support and for being part of this journey.
AegisGuard is built with care, community feedback, and a shared love for well-protected worlds.

AegisGuard v1.2.2 — Stability & Protection Update
A refined update focused on protection accuracy, storage stability, and Folia compatibility for all servers using the classic AegisGuard engine.

️ Full Vertical Plot Protection

• Plots are now protected from world height to bedrock.
• Prevents bypass attempts from sky-builds or underground tunneling.
• Works across all worlds and dimensions automatically.

⚙️ Improved Folia Detection & Compatibility

• AegisGuard now automatically detects any Folia version.
• Compatible with both the latest updates and older Folia releases.
• Smart scheduler adaptation — no configuration required.

Storage System Reliability Upgrade

• SQL connection handling improved for safer write/read operations.
• Local plot data storage stabilized.
• Plots should no longer disappear on restart.
• Hardening against incomplete or corrupted save states.

Need Help or Found a Bug?

• Join the official Discord for support and suggestions.
• Report issues on the GitHub Issues page.
• Feedback helps ensure stability across the 1.2.x branch and future 1.3 engine.

AegisGuard 1.2.2 reinforces the foundation while staying fully compatible with modern Paper & Folia ecosystems. Thanks for supporting the project!

First, I want to apologize. In the previous version (v1.2.0), a mistake in the internal files caused the Roles Section to fail to generate in your configuration. This resulted in server errors when trying to add members or assign roles to your plots.

This update fixes that missing section internally. However, for the fix to take effect, you need to regenerate your file.

________________________________________________________

1. BACKUP YOUR SETTINGS: If you changed any settings (like prices or messages), please copy them into a text file or Notepad right now so you don't lose them.
2. Stop your server.
3. DELETE the config.yml file in the AegisGuard folder.
4. Delete the old .jar and upload this new v1.2.1 JAR.
5. Start your server.

________________________________________________________

• Fixed an issue where the roles: section was missing from the default configuration.
• Resolved NullPointerException crashes when opening the Role/Member menus.

⚠️ IMPORTANT UPGRADE NOTICE
This update introduces a completely rebuilt dynamic language system.
To ensure proper initialization:

• Back up your `messages.yml` and `config.yml` if you have custom text or settings.
• Delete your old messages.yml.
• Delete your old config.yml as well (recommended for clean initialization).
• Restart to generate fresh configuration files.
• Re-apply your customizations afterward.

Skipping these steps may result in "Missing Key" messages or older settings failing to load properly.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

✨ Overview
AegisGuard v1.2.0 modernizes the entire engine with smoother performance, enhanced progression systems, intelligent protections, synchronized localization, and a far cleaner user experience.
This release focuses on stability, customization, immersion, and player-driven growth.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Expansion Petitions — 5 Tiers
A fully rebuilt expansion request system:

• Five distinct tiers (+5 → +50 block expansions)
• Clear, predictable upgrade paths for players
• Admin Review GUI for instant approvals or denials

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

The Ascension System (30 Levels)
A deep progression tree that expands the capabilities of your land:

• Unlock Haste, Speed, Flight
• Increase plot member capacity
• Gain cosmetic & prestige-based upgrades
• Designed for long-term progression

Fairness Notice: Plot Leveling does NOT expand plot size unless a server owner enables it manually in `config.yml`.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

⚔️ Smarter, Safer Protection
Your land is now a true sanctuary:

• Instant mob disengage when entering trusted land
• Anti-sniping barrier — skeleton arrows cannot reach you
• Reliable safety during building, decorating, or AFK moments

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Clean UI Initiative
A modern, distraction-free interface:

• Plot buffs displayed on a sleek sidebar scoreboard
• Potion particles & shifting icons removed
• Centered inventory with zero clutter
• Toggle anytime with: /ag sidebar

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Unified Map Controller
Your claims automatically render across:

• Dynmap
• BlueMap
• Pl3xMap / Squaremap

Features:

• Live synchronous updates
• 3D markers where supported
• Instant detection — no configuration needed

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

️ Immersion & Localization
Choose your experience:

• Old English — medieval roleplay
• Hybrid English — fantasy-lite
• Modern English — clean and contemporary

Every UI element updates instantly:

• GUIs & menus
• Buttons & icons
• Lore text & tooltips
• Codex entries
• Chat messages

Report language mismatches via GitHub.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Land is more than just a coordinate.

• Rename: Players can now set a custom alias for their plot (e.g., "The Obsidian Spire").
  
  /ag rename <name>​
• Descriptions: Add a lore description to advertise shops or lore.
  
  /ag setdesc <text>​
• Visuals: These names appear in the Travel Menu and the Holographic Entry titles.

• New Flag: shop-interact
  
• The Problem: Protection plugins usually block players from right-clicking signs or chests to buy items from shop plugins (like ChestShop/QuickShop).
  
• The Solution: Enable this flag to allow Safe Interactions (Right-Clicking containers/signs) without giving build/break access.
  
  Configurable Cost: Server owners can charge players to unlock this "Commercial License."​

• Unstuck Command: Trapped in a claim? /ag stuck finds the nearest safe location outside the border and teleports you there after a warmup.
  
• Action Bar Notifications: You can now move Entry/Exit messages from the Chat to the Action Bar for a cleaner experience.

We have introduced a robust Event API. Other plugins can now listen to and cancel AegisGuard actions.

• 
  []Main Menu Polish:
  • 
    []Expanded the GUI to 54 Slots with a glass border frame.
  • Smart Claim Button: The claim button now visually locks (Red Barrier) if you haven't selected corners, preventing accidental menu closures.
  
  []Roles Management:
  • 
    []Owner Safety: The Plot Owner is now hidden from the "Manage Roles" list to prevent accidental self-removal.
  • Navigation: Added Back/Exit buttons to the "Manage Player" menu to prevent getting stuck.
  
  []Admin Tools:
  • 
    []Admins can now open Flags and Roles menus for Server Zones (owned by the server) to manage Spawn/Market settings easily.
• Codex Update: Added a new "Identity & Utility" chapter explaining the new /ag rename, /ag stuck, and /ag setdesc commands.

Stop your server.

Replace the .jar file with v1.1.1.

Start your server.
Note: The Smart Config Updater will automatically inject the new shop-interact and unstuck settings.

Please read before updating permissions.
This update adds a powerful new permission node: aegis.admin.manage.

• Master Key: This acts as a universal override, allowing the user to edit Flags, Roles, and Settings on ANY plot (including Server Zones and other players' land).
• WARNING: Only grant this to trusted Senior Staff. Do not give this to trial moderators.

Admins can now officially claim and manage protected zones (Spawns, Warzones, Jails) without dealing with "Player Ownership" quirks.

• ⚔️ The Sentinel's Scepter: A new Admin Tool (/agadmin wand). Claims made with this wand ignore economy costs/limits and instantly become Server Zones (Protected, PvP-OFF, Build-OFF).
• Conversion: Stand in any player plot and type /agadmin convert to seize it for the server. Perfect for turning a player-built market into an official warp.
• ️ Live Management: Admins with the Master Key can now open the Flags/Roles menu for Server Plots just by standing in them—no commands required.

• ️ Zoning (Sub-Claims): Players can now define specific rooms or shops inside their plot and list them for rent. Tenants get build rights only inside their rented zone.
• Plot Leveling (RPG): Land is no longer static. Players can pay (Money, XP, or Items) to level up their plot, unlocking buffs like Speed, Haste, or Regen for all trusted members.
• Atmospheric Biomes: Players can pay to change the visual biome of their plot (e.g., turn a cold Taiga into a lush Jungle). (Note: Visual packet effect only; does not destroy blocks).

AegisGuard is no longer bound strictly to Vault. You choose the currency for every action.

Example: Make Claiming cost Money, but make Flight cost XP Levels.


⚠️ Major Configuration Changes
1. Stop your server.
2. Delete config.yml and messages.yml (Recommended to generate the new Economy/Leveling sections clean).
3. Replace the .jar file.
4. Start your server.
5. Review Permissions: Ensure aegis.admin.manage is secure.

"Knowledge is the first line of defense."
We have completely rebuilt the in-game information system. The /ag menu "Info" button is no longer just a chat message—it is now a comprehensive 45-slot Encyclopedia.

New Chapters Include:

• The Art of Claiming: Step-by-step guide on using the Scepter.
• Teleportation Arts: How to set homes, spawns, and visit friends.
• Menu Mastery: Explaining Flags, Roles, and Settings.
• Economy & Trade: A guide to the Marketplace and Auctions.
• Security & Banishment: How to Kick/Ban intruders.

• Anti-Sniper Shield: Players inside a protected plot are now immune to projectile damage (Arrows, Potions, Tridents) fired by monsters standing outside the border. No more skeletons sniping you from the wilderness.
• Vaporizer Refined: The active Mob Barrier task has been optimized to catch mobs spawning inside Safe Zones instantly.

• Smart Claiming: Clicking the "Claim Land" button without selecting corners no longer kicks you out of the menu. It now plays a warning sound and explains the requirement.
• Unified Navigation: The Travel System, Admin Tools, and Exit buttons have been reorganized.
  • Admin Panel: Moved to Slot 25 (Only visible to Operators).
  • Exit Button: Now available in Slot 26 for all players, ensuring no one gets stuck in the menu.

To apply this update: Replace the jar and delete messages.yml to let the new Codex text generate.

Stop deleting your files.
This update introduces an intelligent Config Merger. When you install this jar, AegisGuard automatically scans your existing config.yml and messages.yml. If it detects missing options (like the new Flight settings), it injects them automatically without touching your custom values.

Update with confidence. Your hard work is safe.

• The Travel System
  Forget memorizing commands. The new GUI handles everything.
  • Visual Menu: A new "Compass" button in the main menu opens the Travel GUI.
  • Trusted Plots Tab: Instantly see and teleport to plots where you are a member.
  • Server Warps Tab: Admins can now set plots as public warps (Spawn, Market, Arena) using /ag setwarp.
• ️ Flight Flag
  Give your builders wings.
  • Unlockable Flight: Players can now toggle flight inside their own claims via the Flags GUI.
  • Economy Integration: Set a price (e.g., $5000) to unlock this ability.
  • Physics Engine: Flight is automatically and safely stripped if a player leaves the plot boundary.
• ️ Active Mob Barrier
  Keep your spawn clean.
  • The Vaporizer: A new async task scans Safe Zones and Server Zones.
  • Instant Removal: Hostile mobs that wander into protected areas are instantly removed with a smoke effect. No more creepers in the market.

• Private Mode (Lockdown): Added the Entry Flag. If disabled, the plot becomes private—strangers bounce off the border like an invisible wall.
• Kick & Ban: Plot owners can now enforce their own borders using /ag kick and /ag ban.
• Operator Trust: New config option trust_operators. If set to false, OPs cannot edit admin settings without specific permissions.

• ️ Active Mob Barrier (The Vaporizer)
  Hostile mobs that attempt to enter Safe Zones, Server Zones, or plots with the 'mobs' flag disabled are now instantly vaporized with a smoke effect.
  
• ✈️ Flight Flag
  Players can now enable flight within their plots (configurable cost). Flight is automatically stripped upon exit with safe fall damage immunity.
  
• Private Mode (Lockdown)
  Owners can now toggle "Public Access" off. Non-trusted players will be physically bounced back if they try to enter a private plot.
  
• Plot Moderation
  Added commands for owners to police their own land:
  
  /ag kick <player> - Eject an intruder to spawn.
  /ag ban <player> - Permanently block a player from entering.​
• Operator Security
  Added admin.trust_operators to config. If set to false, OPs are treated as normal players unless they have specific permissions.

• **Fixed** a startup crash regarding "Wilderness Revert" on YAML storage (now gracefully disables itself).
• **Fixed** the "Guardian Codex" (Info GUI) back button not working.
• **Fixed** Admin menus not opening for Operators in certain contexts.
• **Fixed** Wand selection issues by implementing strict NBT data checks.
• **Resolved** compilation errors regarding missing economy methods.

Your existing config will function, but we recommend regenerating it or adding the new sections manually to access these features.