AegisGuard

# AegisGuard 1.2.7  ### *Protect your world. Empower your players. Ascend.* **Folia Supported** | **Living Territory Systems** | **Built for Modern Servers** [Read the Wiki](https://github.com/snazzyatoms/AegisGuard/wiki) | [Source Code and Issues](https://github.com/snazzyatoms/AegisGuard) --- ## A Living Territory System AegisGuard is more than basic land protection. It is a complete territory system for modern Minecraft communities. Players can claim land, build communities, progress through plot levels, manage sub-zones, rent property, operate local markets, trade, discover public destinations, and grow long-term territory value. Server owners receive protection tools, recovery systems, migration support, world controls, activity history, and administration workflows designed for public servers. --- ## What's Included in 1.2.7 ### Ascension Hall and Plot Progression Plots can progress through **30 Ascension levels** with clear reward previews, payment confirmation, and the Guardian's Ascension Guide. At higher levels, plots can specialize in one balanced discipline: - **Stonewright**: Supports builders and larger construction projects. - **Verdant Keeper**: Supports cultivated land, farms, and protected agriculture. - **Wayfinder**: Supports movement and exploration inside developed territory. Existing flight permissions and external potion effects are preserved safely. Plot flight is an earned final Ascension milestone, not a manual claim toggle. ### Expansion Horizons After Level 30, territory progression continues through **Expansion Horizons**: - Renown progression and five named ranks - Bound Sigils and advanced plot abilities - Guarded territory radius growth - Overlap checks, world limits, snapshots, and ownership validation ### Rental Contracts 2.0 Turn plots and sub-zones into apartments, hotel rooms, businesses, shops, market spaces, and managed community areas. - Fixed rental terms and deposits - Renewals and reminders - Tenant controls and hotel-style guest access - Full-plot and sub-zone rental support - Durable offline settlement handling ### Discovery, Travel, and Territory Life Public claims can become real destinations through the redesigned **Travel Atlas**. - Public territory discovery - Categories and featured listings - Favorites and likes - Visit tracking - Owned and trusted destinations - Server waypoints - Territory activity history ### ClaimBlocks, Markets, and Trade AegisGuard connects territory ownership with a configurable economy. - ClaimBlocks and ClaimBlock Exchange - Vault economy support - Plot listings and auctions - Local Markets and TradeStalls - Rental listings - Group plots and shared treasury tools - In-game economy and progression guidance --- ## Administration, Safety, and Recovery ### Territory Doctor Use /agadmin doctor to inspect territory health and safely address supported deterministic issues. - Diagnostics for plots, rentals, marketplaces, overlaps, and pending settlements - Confirmation-gated repair actions - Automatic snapshots before supported plot repairs - Clear reports for issues requiring manual staff review - No guessing on overlaps, unavailable worlds, duplicate IDs, or missing owners ### Safer Updates AegisGuard 1.2.7 includes stronger protection for existing server configurations. - Timestamped backups before configuration migration - Missing defaults added without overwriting custom settings - Migration reports for review - Language updates that preserve custom translations - Updates stop safely if required backups cannot be created ### Staff Controls - Server-zone creation and management - ClaimBlock administration - Server-zone merging - Territory snapshots and restoration - Rental administration - Discovery moderation and featured territories - Territory activity inspection - Per-world claim and protection defaults - World controls for daylight, weather, keep-inventory, mob spawning, and mob griefing - Migration previews, diagnostics, and bypass tools --- ## Quick Commands ### Players /ag wand Get the Aegis Scepter /ag claim Claim selected land /ag unclaim Remove the current plot /ag menu Open the territory dashboard /ag cost Preview claim cost /ag setspawn Set the plot home point /ag home Travel to the plot home /ag visit Open the Travel Atlas /ag discover Browse public territories /ag favorite Favorite the current plot /ag activity View territory activity /ag level Open the Ascension Hall /ag zone Manage sub-zones and rentals /ag subplot [name] Create a sub-zone from the selection /ag rent List the current plot for rental /ag unrent Remove a rental listing /ag rental Manage rental contracts /ag market Open market options /ag market local Open the Local Market /ag sell List the current plot for sale /ag unsell Remove a sale listing /ag auction Open the auction browser /ag blocks Open ClaimBlocks tools /ag ledger View ClaimBlocks ledger /ag group Open group plot and treasury tools ### Staff /agadmin menu Open the Staff Command Center /agadmin reload Reload supported settings and languages /agadmin bypass Toggle protection bypass mode /agadmin wand server Receive the server-zone wand /agadmin claim Create a server-owned protected zone /agadmin doctor Open diagnostics and repair tools /agadmin snapshot Create a territory recovery snapshot /agadmin restore Restore a supported territory snapshot /agadmin migrate Open migration tools /agadmin blocks View or manage ClaimBlocks /agadmin merge Merge eligible server zones /agadmin rentals Manage rental contracts /agadmin discover Moderate public discovery listings /agadmin activity Inspect territory activity history ### Server-Zone Workflow 1. Run /agadmin wand server. 2. Right-click the first selection corner. 3. Left-click the second selection corner. 4. Run /agadmin claim. --- ## Permissions ### Recommended Bundles aegis.user Recommended base permissions for regular players aegis.admin Recommended administrative permission bundle aegis.* Full AegisGuard access; best reserved for owners ### Key Player Permissions aegis.use aegis.menu aegis.wand aegis.claim aegis.notify aegis.rent aegis.discovery aegis.activity aegis.earn.blocks ### ClaimBlocks Permissions aegis.claimblocks.exchange aegis.claimblocks.buy aegis.claimblocks.sell aegis.claimblocks.exchange.bypass aegis.claimblocks.selllock.bypass ### Key Staff Permissions aegis.admin.manage aegis.admin.world aegis.admin.bypass aegis.serverzone.manage aegis.admin.bypass-limits aegis.reload aegis.admin.wand aegis.admin.migrate aegis.admin.blocks.view aegis.admin.blocks.manage aegis.admin.merge aegis.admin.doctor.repair aegis.admin.rentals aegis.admin.discovery aegis.admin.activity --- ## Installation and Updating 1. Stop the server completely. 2. Back up the plugins/AegisGuard folder and your world data. 3. Place AegisGuard-1.2.7.jar in the server's plugins folder. 4. Install Vault and a supported economy provider if money-based features are required. 5. Start the server and allow AegisGuard to complete its safety checks. 6. Review plugins/AegisGuard/config.yml and the language files. 7. Run /agadmin doctor before reopening the server to players. > Do not use Bukkit's global /reload command. Use /agadmin reload for supported configuration and language reloads. Restart the server after changing storage or integrations. --- ## Compatibility | Requirement | Support | | --- | --- | | Minecraft | 1.20+ | | Java | 17+ | | Platforms | Paper, Purpur, Spigot, Folia, and compatible Bukkit forks | | Economy | Vault with a supported economy provider | | Maps | Dynmap, BlueMap, and Pl3xMap integration paths | | Extensions | PlaceholderAPI and the public AegisGuard API | | Languages | English, Old English, Spanish (Mexico), and Spanish (Argentina) | Test new Minecraft and server-software versions on a staging server before deploying them to a live community. --- ## Developer API The public API is available for developers creating AegisGuard integrations and add-ons. - **Server owners:** Install only AegisGuard-1.2.7.jar in the server's plugins folder. - **Developers:** Use AegisGuard-1.2.7-api.jar as a compile-time dependency. - **Important:** API JAR files do **not** belong in a Minecraft server's plugins folder. --- ## Support For setup help, configuration guidance, and full command details, see the [AegisGuard Wiki](https://github.com/snazzyatoms/AegisGuard/wiki). Report bugs, unexpected behavior, GUI issues, language problems, or compatibility concerns through the [GitHub repository](https://github.com/snazzyatoms/AegisGuard). ### *Forged by Aegis Divine - Simple. Steadfast. Eternal.*