Configuration for server owners

The CommandAPI has a few configuration options to change how it functions. These options can be set in the plugins/CommandAPI/config.yml file, which is generated automatically when the CommandAPI runs for the first time.

Default config.yml file

The default config.yml is shown below:

################################################################################
# Logging                                                                      #
################################################################################

# Verbose outputs (default: false)
# If "true", outputs command registration and unregistration logs in the console
verbose-outputs: false

# Silent logs (default: false)
# If "true", turns off all logging from the CommandAPI, except for errors.
silent-logs: false

################################################################################
# Messages                                                                     #
################################################################################

# Messages
# Controls messages that the CommandAPI displays to players
messages:

  # Missing executor implementation (default: "This command has no implementations for %s")
  # The message to display to senders when a command has no executor. Available
  # parameters are:
  #   %s - the executor class (lowercase)
  #   %S - the executor class (normal case)
  missing-executor-implementation: "This command has no implementations for %s"

################################################################################
# Debugging                                                                    #
################################################################################

# Create dispatcher JSON (default: false)
# If "true", the CommandAPI creates a command_registration.json file showing the
# mapping of registered commands. This is designed to be used by developers -
# setting this to "false" will improve command registration performance.
create-dispatcher-json: false

# Use latest version (default: false)
# If "true", the CommandAPI will use the latest available NMS implementation
# when the CommandAPI is used. This avoids all checks to see if the latest NMS
# implementation is actually compatible with the current Minecraft version.
use-latest-nms-version: false

################################################################################
# Command conversion                                                           #
################################################################################

# Plugins to convert (default: [])
# Controls the list of plugins to process for command conversion.
plugins-to-convert: []

# Other commands to convert (default: [])
# A list of other commands to convert. This should be used for commands which
# are not declared in a plugin.yml file.
other-commands-to-convert: []

# Skip sender proxy (default: [])
# Determines whether the proxy sender should be skipped when converting a
# command. If you are having issues with plugin command conversion, add the
# plugin to this list.
skip-sender-proxy: []

Configuration settings

verbose-outputs

If true, outputs command registration and unregistration logs in the console. This is primarily used for developers to identify issues with command registration.

Default value

verbose-outputs: false

Example value

verbose-outputs: true

silent-logs

If true, turns off all logging from the CommandAPI, except for errors.

Default value

silent-logs: false

Example value

silent-logs: true

messages

Controls messages that the CommandAPI displays to players. Available messages:

• missing-executor-implementation - the message to display to senders when a command has no executor. This message supports format parameters:
  • %s - the executor class (lowercase). For example "craftplayer"
  • %S - the executor class (normal case). For example "CraftPlayer"

Default value

messages:
  missing-executor-implementation: "This command has no implementations for %s"

create-dispatcher-json

Controls whether the CommandAPI should generate a command_registration.json file showing the mapping of registered commands.

This is primarily designed to be used by developers. Setting this to false will slightly improve command registration performance.

The command_registration.json JSON representation of commands is in the same format as Minecraft's Data Generators Commands report. The format is Brigadier's command graph - more information about the JSON format can be found here.

Default value

create-dispatcher-json: false

Example value

create-dispatcher-json: true

use-latest-nms-version

Controls whether the CommandAPI should use the latest NMS implementation for command registration and execution.

This setting can be used to run the CommandAPI on Minecraft versions higher than it can support. For example, if the CommandAPI supports Minecraft 1.18 and Minecraft 1.18.1 comes out, you can use this to enable support for 1.18.1 before an official CommandAPI release comes out that supports 1.18.1.

Default value

use-latest-nms-version: false

Example value

use-latest-nms-version: true

plugins-to-convert

Controls the list of plugins to process for command conversion. See Command conversion for more information.

Default value

plugins-to-convert: []

Example values

plugins-to-convert:
  - Essentials: ~

plugins-to-convert:
  - Essentials:
    - speed
    - hat
  - MyPlugin:
    - mycommand
  - MyOtherPlugin: ~

plugins-to-convert:
  - Essentials:
    - speed <speed>[0..10]
    - speed <target>[minecraft:game_profile]
    - speed (walk|fly) <speed>[0..10]
    - speed (walk|fly) <speed>[0..10] <target>[minecraft:game_profile]

skip-sender-proxy

Determines whether the proxy sender should be skipped when converting a command. See Skipping proxy senders for more information.

Default value

skip-sender-proxy: []

Example value

skip-sender-proxy:
  - SkinsRestorer
  - MyPlugin

other-commands-to-convert

A list of other commands to convert. This should be used for commands which are not declared in a plugin.yml file. See Arbitrary command conversion for more information.

Default value

other-commands-to-convert: []

Example value

other-commands-to-convert:
  - /set
  - mycommand