⚡ Folia Supported • Player-Owned Territories • Economy & Progression
Read the Wiki | Source Code | Releases
THE LIVING REALM UPDATE
AegisGuard 1.4.0 is the biggest release yet — protected land is no longer just safe, it's alive. Host events on your claim, run party dungeons, name an heir to your realm, chat on private plot frequencies, and travel across entire BungeeCord/Velocity networks.
It runs on Paper, Spigot, Purpur, and Folia with Java 21+ and Minecraft 1.20+. Existing 1.2.7 and 1.3.x data and configuration remain valid through automatic schema migration — upgrading is a JAR swap followed by /agadmin transition.
HEADLINE FEATURES
🏰 Arena Dungeons
Turn any map into a PvE/PvP arena run. Define bounds with the Aegis Scepter, party up, gather in staging areas, launch together, and return safely when the run ends.
/ag arena — browse, join, and party for runs- PvE waves, boss finales, and opt-in PvP (FFA / duels)
- Custom floors and WorldEdit/FAWE schematics with instanced pastes
- Matchmaking queues, sealed runs, and a ready-made
lava_dungeon preset
- Steward and admin roles for arena management
🐫 Trade Caravans
Dispatch charge-then-deliver caravans between linked Teleport Beacon pads — with insurance, weighted route events, Folia-safe travel, and resume-after-restart. Hire an online player as escort to halve ambush risk for a configurable cut. /ag caravan
🏠 Gatherings & Open Houses
Host timed open-house events on plots you manage, or browse what the community is running. Arrivals can receive a visitor Guest Pass that expires when the event ends. /ag gathering • /ag openhouse
👑 Realm Succession
Name an heir, manage the handover, or transfer ownership outright — your realm outlives you.
/ag heir — name a successor/ag succession — inactivity assume, transfer cooldown, rollback window/ag transfer — pass ownership to another player
📻 Plot Chat Frequencies
Per-plot chat channels plus alliance, group, and staff radios — one channel per player, pulled cleanly out of public chat. No client mod needed; Java and Bedrock players use the same commands.
/ag chat — plot frequency (alliance and group channels included)/ag staff — staff radio
💱 ClaimBlocks Exchange
Buy and sell ClaimBlocks with configurable rates, cooldowns, and sell locks — plus a full transaction ledger.
/ag blocks buy|sell <amount> • /ag ledger • /ag giftblocks
🌐 Cross-Server Travel — The Flagship
Everything above was built for this. With one shared database, AegisGuard links every backend behind your BungeeCord/Velocity proxy into a single territory network — no proxy jar required. The Atlas lists remote plots, alliance and staff radios carry across backends, players keep their ClaimBlocks and preferences wherever they log in, and a player on one server can /ag arena join a dungeon hosted on another — then get routed home when it ends.
/ag hub • /ag lobby • /ag servers — cross-server travel and a live server picker- Remote arenas, beacons, discovery, rosters, and broadcasts — all fail closed when the network is offline
- Proven on a live Velocity + two-backend + MariaDB rig before release
ALSO NEW IN 1.4.0
- Realm noticeboards, plot profiles (
/ag profile), and subplots
- Visitor arrival styles — classic teleport or public beacon pad (
/ag arrival)
- Per-plot biome picker with optional Vault fee (
/ag biome)
- New protection wards: Mob Griefing (endermen, tramples, falling blocks) and Interactables (bells, jukeboxes, lecterns, beehives, and more) — plus cross-border liquid/sponge/dispenser fixes
- Server sanctuary flags — Keep Health, Hunger, XP, and Inventory on server zones
- Plot flight unlocked through Ascension progression; staff flight grants via
/agadmin skill
- Claim presets and staff-curated seasons (
/agadmin season)
- Discord integration — account linking and event webhooks
- Settlements inbox for rental and market payouts
- Nine language packs — every player-facing message translated,
{KEY} placeholders resolved on translations, plain-English console logs
- Full
/ag help coverage — every command documented in-game
SEE AEGISGUARD IN ACTION
🏡 CLAIM YOUR TERRITORY
Select two corners with the Aegis Scepter, confirm the claim, and protect your land in seconds.
🧭 COMMAND YOUR REALM
Manage territory identity, guidance, members, notices, and everyday actions from a clear player dashboard.
🛡️ PROTECT, SHAPE & EXPAND
Configure protections, create specialized zones, and grow beyond your original borders.
🤝 BUILD A TRUSTED COMMUNITY
Create custom roles, issue temporary Guest Passes, connect alliances, name an heir, and secure territories with Emergency Lockdown.
💰 CREATE A LIVING LAND ECONOMY
Turn territory into opportunity through ClaimBlocks, markets, rentals, progression, and expansion. Extra land is refused if the wallet cannot cover it — ClaimBlocks stay honest.
🌐 CONNECT THE ENTIRE SERVER
Bring territories into the wider world with travel, Teleport Beacons, arenas, caravans, discovery, player preferences, and staff operations. /ag beacon places linked pads on claims you manage. /ag arena launches dungeon runs with your party.
FOR SERVER OWNERS
- Every new system is a module — disable it in
modules: and it vanishes from menus
- Feature-gated permissions actually enforce now (
aegis.wand, aegis.claim, aegis.gathering, and more)
- Documented public API —
AegisGuard-1.4.0-api.jar ships with each release
- Config comments rewritten — every option explains its units, defaults, and dependencies
- Verified on a live multi-region Folia rig: mob purges, claim charges, and stall purchases all behaved correctly under Folia's threaded model — zero scheduling faults
- Fixed: Vault claim charge is now refunded if validation rejects the claim
COMMANDS
✅ Player Commands (essentials)
/ag wand - Receive the Aegis Scepter
/ag claim /ag quickclaim - Claim selected land, or a square around you
/ag menu - Open the territory dashboard
/ag travel /ag visit - Travel Hub and Travel Atlas
/ag beacon /ag arrival - Teleport Beacon pads and visitor arrival rules
/ag arena - Browse, join, and party for arena runs
/ag caravan - Dispatch a trade caravan
/ag gathering - Host or browse open-house gatherings
/ag chat /ag staff - Plot, alliance, group, and staff channels
/ag heir /ag transfer - Succession and ownership transfer
/ag sell /ag market /ag auction - Sell land, browse markets
/ag blocks buy|sell - ClaimBlocks exchange
/ag group /ag alliance - Group plots and alliances
/ag hub /ag servers - Cross-server travel on networks
/ag guide - Replay the first-claim walkthrough
👑 Admin Commands (essentials)
/agadmin menu - Open the Staff Command Center
/agadmin reload - Reload config and language packs
/agadmin transition - Confirm 1.2.7/1.3.x → 1.4.0 upgrade
/agadmin wand server /agadmin claim - Create server-owned zones
/agadmin inspect /agadmin plots - Claim inspection and registry
/agadmin snapshot /agadmin restore - Territory recovery
/agadmin migrate - Import GriefPrevention/GriefDefender/Lands claims
/agadmin audit - Staff Audit Ledger
/agadmin doctor - Diagnostics and repair tools
/agadmin network - Cross-server find and broadcast
The full command and permission reference lives on the Wiki.
PERMISSIONS (QUICK REFERENCE)
aegis.user - Recommended player bundle
aegis.admin - Recommended admin bundle
aegis.use / aegis.menu - /ag command and dashboard
aegis.wand / aegis.claim - Scepter and claiming
aegis.chat / aegis.chat.alliance / aegis.chat.group - Chat channels
aegis.gathering - Host open-house events
aegis.arena.use / aegis.arena.spectate - Arena participation
aegis.arena.steward / aegis.arena.admin - Arena management
aegis.beacon - Teleport Beacon pads
aegis.claimblocks.* - Exchange, buy, sell, gift, bypass nodes
aegis.admin.* - Staff tools (see plugin.yml for the full list)
INSTALLATION
- Stop the server completely.
- Confirm the host runs Java 21 or newer.
- Place AegisGuard-1.4.0.jar in your
/plugins folder.
- Install Vault plus a supported economy provider for money-based features.
- Start the server — config and language merge run automatically; existing plots load as-is.
- Confirm the upgrade with
/agadmin transition.
- Run
/agadmin doctor only if something looks wrong.
Do not use Bukkit's global /reload command. Use /agadmin reload for AegisGuard settings, and fully restart after changing storage or integrations.
Supported: Minecraft 1.20+ • Java 21+ • Spigot, Paper, Purpur, Folia • Vault • BungeeCord/Velocity networks • Dynmap, BlueMap, Pl3xMap • PlaceholderAPI • WorldEdit/FAWE (optional plot backups) • Geyser/Floodgate (Bedrock GUIs) • Simple Voice Chat (optional Hearth rooms)
For developers: use AegisGuard-1.4.0-api.jar as a compile-time dependency — it does not belong in /plugins. Public events and service accessors live under com.aegisguard.api with Javadocs.
FEEDBACK & DOCUMENTATION
Forged by Aegis Divine — Simple. Steadfast. Eternal.
