Permissions and Commands - snazzyatoms/AegisGuard GitHub Wiki

๐Ÿ” Permissions & Commands

This page lists the main commands and recommended permissions for AegisGuard v1.2.6.

Important notes

  • Claim Status was removed from the main player flow in v1.2.6.
  • Biome Studio was also removed from the active plugin flow.
  • Frontier Expansion is AegisGuardโ€™s upgraded presentation for land expansion. It is still your plot-expansion system, just with a stronger identity and more polished GUI flow.
  • In v1.2.6, the most important permission bundles are:
    • aegis.user for regular players
    • aegis.admin for staff/admins

๐Ÿ  Player Essentials

Basic commands for claiming, travel, and personal plot management.

Command Recommended Permission Description
/ag wand aegis.user Receive the Aegis Scepter for normal claim selection.
/ag claim aegis.user Claim the selected area as your personal plot.
/ag unclaim aegis.user Remove the plot you are standing in.
/ag menu aegis.user Open the main AegisGuard menu.
/ag help aegis.user View the command/help summary.
/ag cost aegis.user Preview claim cost before confirming.
/ag resize <north|south|east|west> <amount> aegis.user Expand or shrink your plot.
/ag setspawn aegis.user Set your plotโ€™s home point.
/ag home aegis.user Teleport to your plotโ€™s home point.
/ag visit aegis.user Open the Travel menu.
/ag stuck aegis.user Escape to a safer nearby location.
/ag rename <name> aegis.user Set a custom plot name.
/ag setdesc <text> aegis.user Set your plot description.
/ag welcome <message> aegis.user Set a plot welcome message. Leave blank to clear it.
/ag farewell <message> aegis.user Set a plot farewell message. Leave blank to clear it.

๐Ÿ”” Notifications

AegisGuard 1.2.6 separates claim greetings from admin updates.

Command Recommended Permission Description
/ag notify aegis.notify Show notification help and current behavior.
/ag notify greetings [on|off] aegis.notify Toggle claim enter/exit notifications.
/ag notify admin [on|off] aegis.notify Toggle admin-style updates sent to eligible players.
/ag notify all [on|off] aegis.notify Toggle both greeting and admin notifications together.

๐Ÿ“Œ Notification Notes

  • If the server uses per-player notification mode, players can manage their own preferences.
  • If the server forces notifications on or off globally, player toggles may be limited.
  • Staff may also use:
    • aegis.notify.bypass
    • aegis.notify.others

๐Ÿ™๏ธ Empire Building

Commands that grow, organize, or improve land.

Command Recommended Permission Description
/ag merge <north|south|east|west> aegis.user Merge your plot with an adjacent plot you own.
/ag zone aegis.user Open the Zone Manager for rentals, rooms, and sub-areas.
/ag subplot [name] aegis.user Create a subplot from your current wand selection inside your plot.
/ag subzone [name] aegis.user Alias for /ag subplot.
/ag level aegis.user Open Plot Ascension.
/ag like aegis.user Like the plot you are currently visiting.

๐Ÿ“Œ Frontier Expansion

Frontier Expansion is the current name for AegisGuardโ€™s land expansion system.

It is still the same core idea:

  • expand your plot
  • request more land
  • grow your territory

The newer name simply gives the system a stronger identity and more polished presentation in the GUI.

๐Ÿ‘ฅ Groups & Shared Plots

Commands for shared progression and group-owned land.

Command Recommended Permission Description
/ag group create <name> aegis.user Create a new plot group.
/ag group invite <player> aegis.user Invite a nearby player to your group.
/ag group accept <name> aegis.user Accept a pending group invite.
/ag group status aegis.user View group treasury and membership details.
/ag group deposit <amount> aegis.user Deposit money into the shared group treasury.
/ag group claim aegis.user Claim the first group plot from your wand selection.
/ag group leave aegis.user Leave your current group.
/ag group kick <player> aegis.user Remove a player from your group if you are the leader.
/ag group disband aegis.user Disband your current group if allowed.

๐Ÿ›ก๏ธ Plot Moderation

Owner-level tools for managing behavior on your land.

Command Recommended Permission Description
/ag kick <player> aegis.user Remove a player from your plot.
/ag ban <player> aegis.user Block a player from entering your plot.
/ag unban <player> aegis.user Remove a player from your ban list.

๐Ÿ’ฐ Economy & Marketplace

Commands for selling, browsing, ClaimBlocks, and market tools.

Command Recommended Permission Description
/ag sell <price> aegis.user List your plot for sale.
/ag unsell aegis.user Remove your plot from sale.
/ag market aegis.user Open the main market menu.
/ag market local aegis.user Open the Local Market for the current plot or area.
/ag market global aegis.user Open the global market view.
/ag auction aegis.user Open the auction browser.

๐Ÿ’ฑ ClaimBlocks

Command Recommended Permission Description
/ag ledger aegis.user View your land ledger / ClaimBlock summary.
/ag blocks aegis.user View ClaimBlock info and help.
/ag blocks buy <amount> aegis.claimblocks.buy Buy ClaimBlocks with Vault money.
/ag blocks sell <amount> aegis.claimblocks.sell Sell ClaimBlocks if enabled by the server.
/ag blocks earnings <on|off|status> aegis.user Manage passive ClaimBlock earnings if the server allows opt-out.

๐Ÿ“Œ ClaimBlocks Notes

  • Exchange access is controlled by:
    • aegis.claimblocks.exchange
    • aegis.claimblocks.buy
    • aegis.claimblocks.sell
  • Playtime earnings are controlled by:
    • aegis.earn.blocks
  • Server owners may also use:
    • aegis.claimblocks.exchange.bypass
    • aegis.claimblocks.selllock.bypass
    • aegisguard.claimblocks.selllock.bypass

๐Ÿ‘‘ Server Administration

High-level commands for admins, owners, and trusted staff.

Command Recommended Permission Description
/agadmin menu aegis.admin Open the admin control panel.
/agadmin reload aegis.admin or aegis.reload Reload config and language files.
/agadmin bypass aegis.admin.bypass Toggle protection bypass mode.
/agadmin wand aegis.admin.wand Give yourself the Sentinelโ€™s Scepter by default.
/agadmin wand server aegis.admin.wand Explicitly receive the Sentinelโ€™s Scepter for server-zone claiming.
/agadmin claim aegis.serverzone.manage or aegis.admin.manage Confirm your current selection as a server zone.
/agadmin wand migration aegis.admin.wand Receive the migration wand.
/agadmin doctor aegis.admin Generate a diagnostics report.
/agadmin snapshot here [reason] aegis.admin Create a manual recovery snapshot for the current plot.
/agadmin restore here aegis.admin Restore the latest snapshot for the current plot.

๐Ÿ“Œ Server Zone Claiming

In v1.2.6, server plots are claimed like this:

  1. /agadmin wand server
  2. Right-click first corner
  3. Left-click second corner
  4. /agadmin claim

That creates a server zone, not a personal player claim.

๐Ÿงณ Migration Tools

Permission: aegis.admin.migrate

Command Recommended Permission Description
/agadmin migrate aegis.admin.migrate Open the migration wizard / GUI.
/agadmin migrate help aegis.admin.migrate Show migration help.
/agadmin migrate list aegis.admin.migrate Show supported detected migration sources.
/agadmin migrate preview <source> aegis.admin.migrate Preview what would be imported.
/agadmin migrate import <source> aegis.admin.migrate Start the import flow for a supported source.
/agadmin migrate import <source> --force aegis.admin.migrate Import with overlap-forcing behavior.
/agadmin migrate import <source> --world=<name> aegis.admin.migrate Import only one world.
/agadmin migrate import <source> --no-trusted aegis.admin.migrate Skip trusted members during import.
/agadmin migrate import <source> --no-flags aegis.admin.migrate Skip flags during import.

โœ… Migration Examples

/agadmin migrate list
/agadmin migrate preview griefprevention
/agadmin migrate import griefprevention
/agadmin migrate import gd --force
/agadmin migrate import lands --world=survival

๐Ÿ“ Migration Notes

  • Preview first on larger servers.
  • Use world filters for gradual migration.
  • Use --force carefully.
  • Supported import sources currently include:
    • griefprevention / gp
    • griefdefender / gd
    • lands

๐Ÿงท Staff Bypass & Utility Permissions

Useful optional nodes for trusted staff or high-level admin roles.

Permission Description
aegis.notify.bypass Receive plot notifications even when normal toggles are restricted.
aegis.notify.others Manage notification preferences for other players.
aegis.claimblocks.exchange.bypass Bypass ClaimBlocks exchange cooldowns and limits.
aegis.claimblocks.selllock.bypass Bypass ClaimBlocks sell-lock restrictions.
aegisguard.claimblocks.selllock.bypass Legacy compatibility bypass node for older setups.
aegis.admin.bypass-limits Ignore normal plot size and limit restrictions.
aegis.admin.manage Manage plots owned by other players.
aegis.serverzone.manage Manage server zones and other staff-owned protected areas.
aegis.market.manage Manage public market or utility plots.
aegis.staff.co_owner Co-owner style staff access for elevated server roles.
aegis.staff.market_steward Market-steward style staff access for managed market areas.

โœ… Recommended LuckPerms Setup

Regular Players

The easiest setup for normal players is:

/lp group default permission set aegis.user true

If your server uses ClaimBlocks exchange and passive earnings, also consider:

/lp group default permission set aegis.claimblocks.exchange true
/lp group default permission set aegis.claimblocks.buy true
/lp group default permission set aegis.claimblocks.sell true
/lp group default permission set aegis.earn.blocks true

Admins / Owners

Recommended full admin bundle:

/lp group admin permission set aegis.admin true

If you want a full โ€œowner/dev testโ€ style setup:

/lp user <name> permission set aegis.* true

Suggested Important Bundles

  • aegis.user
  • aegis.admin

Important Special Nodes

  • aegis.claimblocks.exchange
  • aegis.claimblocks.buy
  • aegis.claimblocks.sell
  • aegis.earn.blocks
  • aegis.admin.migrate
  • aegis.serverzone.manage
  • aegis.admin.wand
โš ๏ธ **GitHub.com Fallback** โš ๏ธ