Commands and permissions

VersatiaCore adds one command, /versatia, with two subcommands. Like every command of a plugin built on Versatia it exists only while CommandAPI 12.x is installed.

Command	Permission	Default
/versatia reload [plugin]	versatia.core.command.reload	operators
/versatia info [plugin]	versatia.core.command.info	operators

Replies use one set of colours: text gray, labels up to their colon gold, the values the server fills in (plugin names, versions, counts) aqua, a success green and an error red.

/versatia reload

Command	Effect
/versatia reload	reloads every running Versatia plugin, in the order in which they started
/versatia reload <name>	reloads the plugin registered under that name; an unknown name lists the running ones

<name> is the plugin's short name (shop for a plugin called ShopPlugin), which tab completion offers and /versatia info lists first on every line.

A reload re-reads the plugin's files in plugins/<Name>/:

• A file you deleted comes back with its default content.

• A file with a mistake changes nothing: the plugin keeps every previous value, and the reply names the file, the key and what is allowed. Fix the file and reload again.

• Plugins that use the reloaded one follow. When shop uses prices from economy, /versatia reload economy reloads shop right after it, so shop sees the new prices:

  Reloaded economy; then shop, which uses beans of economy.

• What a plugin decides at start needs a restart: its commands, and the optional plugins it found next to it (a plugin that integrates with Vault only when Vault is installed checks that once).

/versatia info

/versatia info changes nothing; it shows what the runtime keeps. Without an argument it lists the running Versatia plugins with their short name, version and descriptor format, and their plugin.yml name when it differs from the short name:

VersatiaCore 0.0.1 (descriptor format 1.0)
economy 1.2.0 (Economy, descriptor format 1.0)
shop 0.4.0 (Shop, descriptor format 1.0)

With a plugin's short name it adds what that plugin consists of: its beans (the objects the plugin is built from) grouped by scope, the beans other plugins use, the plugins its reloads cascade to and the files it reads values from:

economy 1.2.0 (Economy, descriptor format 1.0)
Beans (3):
  local (1):
    "plugin" com.example.economy.EconomyPlugin
  exposed singleton (1):
    "clock" com.example.economy.Clock
  exposed prototype (1):
    "priceList" com.example.economy.PriceList
Exposed beans used by others: "priceList" by shop
Reloads cascade to: shop
@Value files: config.yml

@Value files are the files in plugins/Economy/ that /versatia reload economy re-reads.

Permissions

Every command of every plugin built on Versatia is guarded by a permission of one pattern:

versatia.<plugin>.command.<command>

<plugin> is the plugin's short name, <command> the command or subcommand:

Plugin	Command	Permission
VersatiaCore	/versatia reload	versatia.core.command.reload
ShopPlugin, short name shop	/shop price <item>	versatia.shop.command.price

Grant them with your permission plugin, for example with LuckPerms:

/lp group moderator permission set versatia.core.command.info true
/lp group default permission set versatia.shop.command.price true