Commands
Every /protections subcommand, the permission and role right each one asks for, and what it does.
One root, /protections, also answering to /ps and /claims. Almost everything a player does happens in
the menus it 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.
Three checks run before anything happens, in this order:
- The command permission.
exyliaprotections.usefor every player subcommand,exyliaprotections.adminfor theadminones. - The feature. A subcommand belonging to a feature turned off under
submodulesinconfig.ymlsays the feature is disabled. See Configuration. - 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.
| Command | Feature | Who | What it does |
|---|---|---|---|
/protections | Opens the protections hub. | ||
/protections help | Lists the main commands. Also works from the console. | ||
/protections home [name] | Teleports to a protection's home. Without a name: straight there if you have exactly one, otherwise opens your list. Suggests the protections you own or belong to. | ||
/protections info | Name, owner, your role, size and member count of the protection you stand in. | ||
/protections ban <player> [duration] [reason] | bans | manage-bans | Bans a player. |
/protections unban <player> | bans | manage-bans | Lifts a ban. Suggests the names banned there. |
/protections lock | lock | toggle-lock | Locks the protection to members, or unlocks it. |
/protections logs | logs | view-logs | Opens its log. |
/protections market | market | Opens every protection for sale. Works anywhere. | |
/protections sell <price> | market | Owner | Lists it for sale. |
/protections unsell | market | Owner | Takes it off sale. |
/protections transfer <player> | market | Owner | Gives it to another player, who must be online on this server. |
/protections bank | bank | bank-deposit or bank-withdraw | Says what its bank holds. |
/protections bank deposit <amount> | bank | bank-deposit | Pays into its bank. |
/protections bank withdraw <amount> | bank | bank-withdraw | Takes money out of its bank. |
/protections upkeep | upkeep | Any member | Its upkeep state, cost per period, period, time until the next payment, and debt. |
/protections upkeep pay | upkeep | Any member | Pays what it owes. |
/protections subregion create | subregions | manage-subregions | Hands you the selector to mark a new plot. |
/protections subregion delete <name> | subregions | manage-subregions | Deletes a plot after a confirmation. Suggests its plots. |
/protections subregion info | subregions | The plot you stand in: name, size, members, private or shared, rent state. Anybody may ask. | |
/protections rent | rent | Opens your rents and everything offered for rent. Works anywhere. | |
/protections rent offer <price> <period> | rent | manage-rent | Offers the plot you stand in for rent, or the whole protection when you stand outside every plot. |
/protections rent cancel | rent | manage-rent | Withdraws that offer. |
/protections upgrade | upgrades | Owner | Buys the next level, after a confirmation. |
/protections warps | warps | Opens the public warps, most visited first. Works anywhere. | |
/protections warp <name> | warps | Visits a public warp. Suggests the warps you may visit. | |
/protections show | visualization | Any member | Draws its border. |
/protections merge | merge | Owner | Opens the protections that can be merged into this one; says so when there are none. |
Arguments
<price>and<amount>are read the way players type money:500,2.5k,1m.<period>is a duration:30m,12h,1d,1w. A bare number is seconds.[duration]of a ban is a duration as above, orpermanent(alsoperm,forever). Leaving it out bans for good. Anything after it is the reason, spaces included, cut tobans.reason-max-lengthcharacters.<player>forbanandtransfersuggests the players online.
When subregions is off, rent offer and rent cancel always act on the whole protection. Whether a whole
protection may be rented at all is rent.whole-protection. See
Economy for sales, transfers, banks, upkeep and rent, and
Land tools for plots, levels and merging.
Staff commands
Everything below needs exyliaprotections.admin (operators by default).
| Command | What it does |
|---|---|
/protections admin | Opens the admin menu: every protection on the network, tiers, cleanup. Players only. |
/protections admin give <player> <tier> [amount] | Gives an online player protection cores of a tier, 1 to 64 (1 when left out). Suggests every tier. What does not fit in their inventory is kept and handed over later. |
/protections admin migrate <INTERNAL|WORLDGUARD> | Switches the backend and moves every protection over. Refused when WorldGuard is not installed. |
/protections admin import protectionstones [--dry-run] | Turns ProtectionStones regions into protections. --dry-run only reports what it would do. Needs WorldGuard. |
/protections admin cleanup <days> [preview|confirm] [--include-unknown] | Lists the protections whose owner and members have not played for that many days; with confirm, removes them. |
Every one but the bare /protections admin also runs from the console.
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.cleanupwithoutconfirmis 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 plugin declares no reload subcommand. Changes to config.yml and messages.yml take effect on the
next restart. /exylialib reload only recompiles the menus, and /exylialib updates reloads the plugin's
files after applying a new default to them.
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