commands.yml

With false, help lists them in the order they were registered.

0 or lower suggests no names.

This is the time window between requesting an account clear or deletion (/identica admin clear or /identica admin delete) and confirming it. A later confirmation is refused and nothing is changed.

An alias is a word such as help or a phrase such as admin session list; subcommands of /identica use phrases. An enabled command without any alias is not registered, and the console warns about it on startup.

An empty string lets everyone use it.

usage is both what players read and what the command accepts: Identica takes from it which arguments are required and which are optional.

The syntax:

• <name> means a required argument
• [name] means an optional argument
• <name...> or [name...] means an argument that takes the rest of the line
• {...} placeholders are only shown, never parsed

Built-in usages commonly use placeholders such as:

• {alias} for the currently used alias
• {command} for the root command path

Rules:

• Keep the argument names of the default usage. A name the command does not have stops the command from registering, and the console says so.
• Aliases come only from aliases, never from usage.
• An optional argument can be left out of usage; the command then no longer accepts it, and help and the invalid-syntax message no longer show it.
• Settings never change usage: when a setting makes an optional argument unnecessary, such as Credential's changePassword.requireRepeat, the argument stays in the syntax until you remove it.

Examples:

• "{command} {alias} <target> [provider]" means:

  • shows the root command and the alias the player used
  • target is required
  • provider is optional

• "{alias}" means:

  • the command takes no arguments
  • only the alias is shown

Identica reads these fields but does not apply command cooldowns yet. Leave them as they are.

It only describes arguments; which arguments exist comes from usage.

A hidden command still works.