AegisGuard v1.2.6.1

Protect your world. Empower your players. Ascend.

⚡ Folia Native • Living Territory Systems • Modern Admin Recovery

Read Wiki | Source Code

---

IMPORTANT BUGFIX UPDATE

AegisGuard v1.2.6.1 is an important stability and bugfix release for servers currently running v1.2.6.

This update focuses on fixing overlooked issues that could affect:

• storage reliability
• reload safety
• ClaimBlock exchange consistency
• non-Folia mob barrier behavior
• map hook reload handling
• cross-server compatibility for Bukkit, Paper, Purpur, and Folia-style servers

If you are using v1.2.6, updating to v1.2.6.1 is strongly recommended.

---

THE TERRITORY ENGINE STABILIZES

AegisGuard continues to push beyond old-style claim plugins by turning land protection into a living territory system with progression, economy, rentals, migration, recovery, and polished admin tooling.

With v1.2.6.1, the focus is not on replacing the major features introduced in v1.2.6, but on making them safer, more stable, and more reliable for real public servers.

---

WHAT DEFINES v1.2.6.1

v1.2.6.1 is the production bugfix follow-up to v1.2.6, focused on stability, compatibility, and safer live-server behavior.

🛡️ Stronger Runtime Stability

Several live-server issues were corrected to make AegisGuard more dependable during normal use, server restarts, and reload workflows.

This includes improvements to:

• runtime task safety
• service ownership consistency
• startup behavior
• cross-platform scheduling compatibility

💾 Storage Reliability Improvements

Storage handling has been tightened so backend selection is more consistent and safer across supported setups.

This release improves:

• storage backend resolution
• SQL startup reliability
• SQLite, MySQL, and MariaDB support
• configuration consistency for storage selection

💱 ClaimBlocks Exchange Ownership Fix

ClaimBlock exchange state is now handled more safely so command and GUI behavior remain in sync.

This helps prevent drift between:

• ClaimBlock exchange commands
• ClaimBlock exchange GUI flow
• cooldown tracking
• live exchange state

🔄 Safer Reload Behavior

Reload handling has been improved so important systems behave more predictably when admins refresh the plugin.

This release improves reload behavior for:

• recurring tasks
• map hooks
• language/loading flow
• ClaimBlock exchange state
• general runtime service refreshes

🚫 Mob Barrier Fix

A bug affecting mob barrier behavior on non-Folia servers has been fixed, improving consistency across different server types.

🗺️ Better Map Hook Handling

Map integrations now behave more safely during reloads, especially when admins enable or disable them in configuration.

This improves compatibility with:

• Dynmap
• BlueMap
• Pl3xMap / Squaremap environments

⚙️ Better Cross-Server Compatibility

AegisGuard v1.2.6.1 tightens scheduler behavior and startup compatibility for modern server software, helping reduce platform-specific issues.

☕ Safer Java 17 Build Targeting

The build pipeline has been updated for safer Java 17 compatibility, reducing risk when building on newer JDK versions.

---

CORE FIXES IN v1.2.6.1

• fixed storage backend inconsistencies
• improved SQL driver support and startup handling
• fixed ClaimBlock exchange service ownership so GUI and command state stay synchronized
• fixed non-Folia mob barrier execution behavior
• improved reload safety for services and repeating tasks
• improved map hook reload behavior so integrations can be safely refreshed
• improved Folia-aware scheduling behavior
• improved Java 17 build targeting for safer compatibility
• updated plugin, config, and release versioning to 1.2.6.1

---

IMPORTANT NOTE ABOUT THE LARGER JAR

The v1.2.6.1 JAR is larger than previous versions because this release now bundles important dependencies directly inside the final build.

This was done intentionally to improve compatibility and reduce setup problems, especially for:

• larger servers
• SQL-backed servers
• servers using SQLite, MySQL, or MariaDB
• server owners who want a more plug-and-play installation

Bundled dependencies now include support for:

• SQLite
• MySQL
• MariaDB
• connection pooling and related runtime libraries

This means the final release JAR is larger, but it is also more complete and more reliable for public use.

---

v1.2.6 FEATURE FOUNDATION

All major systems introduced or improved in v1.2.6 remain part of the plugin experience, including:

• stronger protection coverage
• restored Sentinel's Scepter server-zone claiming
• Frontier Expansion improvements
• Plot Ascension progression flow
• TradeStalls and Local Market support
• stronger group plot and treasury systems
• snapshot, rollback, migration, and diagnostics tooling
• improved handbook, GUI, and language synchronization

v1.2.6.1 builds on that foundation by making those systems safer to run live.

---

COMMANDS & MASTERY

Total control at your fingertips.

<details> <summary>✅ Player Commands</summary>

/ag wand                     - Get the Aegis Scepter
/ag claim                    - Claim selected land
/ag unclaim                  - Remove the current plot
/ag menu                     - Open the main AegisGuard menu
/ag help                     - View the help summary
/ag cost                     - Preview claim cost
/ag resize <dir> <amt>       - Resize your plot
/ag merge <dir>              - Merge adjacent plots you own
/ag setspawn                 - Set your plot home point
/ag home                     - Teleport to your plot home
/ag visit                    - Open the Travel menu
/ag rename <name>            - Set a custom plot name
/ag setdesc <text>           - Set a plot description
/ag welcome <msg>            - Set a welcome message
/ag farewell <msg>           - Set a farewell message
/ag notify                   - Notification controls
/ag stuck                    - Escape to a safe nearby location
/ag zone                     - Open Zone Manager
/ag subplot [name]           - Create a subplot from your selection
/ag subzone [name]           - Alias for subplot creation
/ag level                    - Open Plot Ascension
/ag like                     - Like the current plot
/ag market                   - Open the market
/ag market local             - Open Local Market
/ag market global            - Open the global market view
/ag sell <price>             - List your plot for sale
/ag unsell                   - Remove your plot from sale
/ag auction                  - Open the auction browser
/ag ledger                   - View your ClaimBlocks ledger
/ag blocks                   - View ClaimBlocks tools/help
/ag blocks buy <amount>      - Buy ClaimBlocks
/ag blocks sell <amount>     - Sell ClaimBlocks
/ag blocks earnings <...>    - Manage passive ClaimBlock earnings
/ag group create <name>      - Create a group
/ag group invite <player>    - Invite a nearby player
/ag group accept <name>      - Accept a group invite
/ag group status             - View group status
/ag group deposit <amount>   - Deposit into treasury
/ag group claim              - Claim the first group plot
/ag group leave              - Leave your group
/ag group kick <player>      - Kick a member
/ag group disband            - Disband the group

</details>

<details> <summary>👑 Admin Commands</summary>

/agadmin menu                    - Open the Admin GUI
/agadmin reload                  - Reload config + language files
/agadmin bypass                  - Toggle bypass mode
/agadmin wand                    - Receive the Sentinel's Scepter
/agadmin wand server             - Explicit server-zone wand
/agadmin claim                   - Confirm selection as a server zone
/agadmin wand migration          - Receive the migration wand
/agadmin doctor                  - Generate a diagnostics report
/agadmin snapshot here [reason]  - Create a manual snapshot
/agadmin restore here            - Restore the latest snapshot
/agadmin migrate                 - Open the migration flow
/agadmin migrate list            - Show detected migration sources
/agadmin migrate preview <src>   - Preview an import
/agadmin migrate import <src>    - Import from a supported source

</details>

---

INSTALLATION

1. Stop your server.
2. Place AegisGuard-1.2.6.1.jar into your /plugins folder.
3. Install Vault plus a supported economy plugin if you want money-based economy features.
4. Start the server once so AegisGuard can generate its files.
5. Review config.yml and your language files before going live.

Supported Versions: 1.20+
Platforms: Spigot, Paper, Purpur, Folia

---

RECOMMENDED UPGRADE NOTE

If you are currently running v1.2.6, this update is recommended for production use.

AegisGuard v1.2.6.1 is intended to resolve the key stability issues discovered after the v1.2.6 return update and should provide a safer experience for:

• players
• staff
• server owners
• larger and SQL-backed servers

---

FEEDBACK & DOCUMENTATION

If you notice issues, menu inconsistencies, formatting problems, missing text, or anything else that feels off, please report it through the GitHub repository.

For deeper setup information:

• Wiki: https://github.com/snazzyatoms/AegisGuard/wiki
• Source / Issues: https://github.com/snazzyatoms/AegisGuard

Forged by Aegis Divine — Simple. Steadfast. Eternal.