Commands
Every /protections and /protectionsadmin subcommand, the permission and role right each one asks for, and what it does.
Two roots: /protections for players, also answering to /ps and /claims, and /protectionsadmin for
staff, also answering to /psadmin and /padmin. Almost everything a player does happens in the menus
/protections opens; the subcommands are shortcuts for what is done standing in your own land.
How the land is picked#
Every subcommand that acts on a protection acts on the one you are standing in. Outside every protection it answers "there is no protection here" and does nothing.
Four checks run before anything happens, in this order:
- The command permission.
exyliaprotections.usefor every player subcommand,exyliaprotections.adminfor/protectionsadminand theadminones. - The feature. A subcommand belonging to a feature turned off under
submodulesinconfig.ymlsays the feature is disabled. See Configuration. - The feature node. The column Node below names the
exyliaprotections.*node that subcommand asks for, held by everybody unless a server takes it away from a rank. Without it the player is told their rank does not include that feature. See Permissions. - Who you are there. The column Who below says what you need on that protection: a role
permission such as
manage-bans(held through your role or your clan's), Owner, or Any member. The owner always passes.
exyliaprotections.admin counts as the owner and as holding every role permission on every protection, so
staff can run all of these anywhere. See Permissions.
Player commands#
Every command here needs exyliaprotections.use, which everybody has by default, and runs for players only, except help. The column Permission names the feature node a rank can lose; see Permissions.
| Command | What it does | Permission |
|---|---|---|
/protections | Open your protections menu. | exyliaprotections.use |
/protections help | List the commands in chat. | exyliaprotections.use |
/protections home [name] | Teleport to the home of your only protection, or of the one you name. With several protections and no name it opens the list. | exyliaprotections.home |
/protections info | Say who owns the protection you stand in, your role there, its size and how many members it has. | exyliaprotections.use |
/protections show | Draw the border of the protection you stand in. | exyliaprotections.show |
/protections upgrade | Upgrade the protection you stand in to its next level, after asking you to confirm. | exyliaprotections.upgrade |
Members and access#
| Command | What it does | Permission |
|---|---|---|
/protections add <player> [role] | Add a player who has played here to the protection you stand in, with the role you name or the first role you may hand out. | exyliaprotections.members.add |
/protections remove <player> | Remove a member from the protection you stand in. | exyliaprotections.use |
/protections ban <player> [duration] [reason] | Ban a player from the protection you stand in, for a while or for good. | exyliaprotections.ban |
/protections unban <player> | Lift a ban in the protection you stand in. | exyliaprotections.use |
/protections lock | Lock or unlock the protection you stand in. | exyliaprotections.lock |
/protections logs | Open the activity log of the protection you stand in. | exyliaprotections.logs |
Selling, giving and the bank#
| Command | What it does | Permission |
|---|---|---|
/protections market | Open every protection for sale. | exyliaprotections.market.buy |
/protections sell <price> | List the protection you stand in for sale. | exyliaprotections.market.sell |
/protections unsell | Take the protection you stand in off the market. | exyliaprotections.use |
/protections transfer <player> | Give the protection you stand in to another online player. | exyliaprotections.transfer |
| Command | What it does | Permission |
|---|---|---|
/protections bank | Show the balance of the bank of the protection you stand in. | exyliaprotections.use |
/protections bank deposit <amount> | Put money into the protection's bank. | exyliaprotections.bank.deposit |
/protections bank withdraw <amount> | Take money out of the protection's bank. | exyliaprotections.use |
/protections upkeep | Show the upkeep state, cost, period and debt of the protection you stand in. | exyliaprotections.use |
/protections upkeep pay | Pay what the protection owes in upkeep. | exyliaprotections.use |
Plots and rent#
| Command | What it does | Permission |
|---|---|---|
/protections subregion create | Get a selector to mark a new plot inside the protection you stand in. | exyliaprotections.subregions |
/protections subregion delete <plot> | Delete a plot, after asking you to confirm. | exyliaprotections.subregions |
/protections subregion info | Say what the plot you stand in is: size, members, private or shared, rent. | exyliaprotections.use |
/protections rent | Open your rents and everything offered for rent. | exyliaprotections.use |
/protections rent offer <price> <period> | Offer the plot you stand in, or the whole protection outside every plot, for rent. The period is a duration such as 7d. | exyliaprotections.rent.offer |
/protections rent cancel | Withdraw the rent offer of the plot you stand in or of the whole protection. | exyliaprotections.use |
Warps#
| Command | What it does | Permission |
|---|---|---|
/protections warps | Open the public warps. | exyliaprotections.warp.visit |
/protections warp <name> | Visit a public warp by name. | exyliaprotections.warp.visit |
Role permission each command asks for
After the feature node, a subcommand asks what you are in that protection. The owner always passes.
ban,unban:manage-bans.add,remove:manage-members.lock:toggle-lock.logs:view-logs.bank deposit:bank-deposit.bank withdraw:bank-withdraw.bankshows the balance to anybody holding one of the two.subregion createanddelete:manage-subregions.rent offerandrent cancel:manage-rent.sell,unsell,transfer: owner only.upgrade: owner only.upkeepandshow: any member.- A feature turned off under
submodulesinconfig.ymlanswers "That feature is turned off."
There is no wipe or reset subcommand: ExyliaLib's /exylialib wipe and /exylialib resetplayer cover the plugin's tables. See Administration.
Staff commands#
Everything below needs exyliaprotections.admin (operators by default). Subcommands that act on land act
on the protection you stand in, and answer "there is no protection here" outside one.
| Command | What it does | Permission |
|---|---|---|
/protectionsadmin | Open the admin hub: Protections, Tiers, Cleanup, Settings and Reload. | exyliaprotections.admin |
/protectionsadmin give <player> <tier> [amount] | Give a player protection cores of a tier. The amount goes from 1 to 64. | exyliaprotections.admin |
/protectionsadmin list [owner] | Open every protection on the network, or only one owner's. | exyliaprotections.admin |
/protectionsadmin here | Open the admin screen of the protection you stand in. | exyliaprotections.admin |
/protectionsadmin delete | Delete the protection you stand in, after you confirm. | exyliaprotections.admin |
/protectionsadmin transfer <player> | Hand the protection you stand in to another player, whatever their limits say. | exyliaprotections.admin |
/protectionsadmin level <level> | Set the upgrade level of the protection you stand in. | exyliaprotections.admin |
/protectionsadmin lives <lives> | Set the raid lives of the protection you stand in. | exyliaprotections.admin |
/protectionsadmin flag <flag> <allow|deny|default> | Force a flag on every protection and plot, or give it back to each owner with default. | exyliaprotections.admin |
/protectionsadmin feature <feature> <on|off> | Turn a whole feature on or off. It is written into config.yml. | exyliaprotections.admin |
/protectionsadmin settings | Open the settings screens. | exyliaprotections.admin |
/protectionsadmin tiers | Open the tier editor. | exyliaprotections.admin |
/protectionsadmin replays | Open the raid replays of the protection you stand in. | exyliaprotections.admin |
/protectionsadmin replays leave | Stop watching a raid replay. | exyliaprotections.admin |
/protectionsadmin migrate <INTERNAL|WORLDGUARD> | Switch between the two backends and move every region over. WORLDGUARD needs WorldGuard. | exyliaprotections.admin |
/protectionsadmin reload | Reload config.yml, the messages and the menus. | exyliaprotections.admin |
/protectionsadmin import protectionstones [--dry-run] | Turn ProtectionStones regions into protections. With --dry-run it only reports what it would do. | exyliaprotections.admin |
/protectionsadmin cleanup <days> [preview|confirm] [--include-unknown] | Remove protections nobody has played in for that many days. Players get a screen; the console previews, or removes with confirm. | exyliaprotections.admin |
/protections admin <give|migrate|reload|import|cleanup> | The older spelling of the admin subcommands; /protections admin alone opens the hub. | exyliaprotections.admin |
flagandfeaturewriteconfig.ymlon the spot, underforced-flagsandsubmodules, and apply at once; with the WORLDGUARD backend the mirrored regions are updated too. A value the file does not take is refused with the reason. See Configuration.migratereports the backend it ended on and how many protections it moved. See Backends.import protectionstonesreports how many regions were imported, already imported, overlapping and skipped, then lists the first ten problems. A dry run also warns whenimport.remove-source-regionsis on. See Migration.cleanupfrom the console withoutconfirmis a preview: how many would go, how many were kept for having no record of their players, a tenant or money in the bank, and the first ten.--include-unknownalso removes those without a record. Days below 1 count as 1. See Administration.
The old /protections admin#
/protections admin still answers the subcommands it had before /protectionsadmin existed, and runs the
same code: /protections admin (the hub), give, migrate, reload, import protectionstones and
cleanup. Every other staff subcommand is only under /protectionsadmin.
ProtectionStones also registers /ps, and only one of the two can answer to it while both are installed.
/protections and /claims always reach this one. Remove ProtectionStones once its regions are imported.
Something missing on this page? Tell us on Discord