Package com.velocitypowered.api.command

Interface CommandManager

public interface CommandManager

Handles the registration and execution of commands.

Method Summary

Modifier and Type	Method	Description
CommandMeta.Builder	createMetaBuilder(BrigadierCommand command)	Returns a builder to create a CommandMeta for the given Brigadier command.
CommandMeta.Builder	createMetaBuilder(String alias)	Returns a builder to create a CommandMeta with the given alias.
CompletableFuture<Boolean>	execute(CommandSource source, String cmdLine)	Attempts to asynchronously execute a command from the given cmdLine.
CompletableFuture<Boolean>	executeImmediately(CommandSource source, String cmdLine)	Attempts to asynchronously execute a command from the given cmdLine without firing a CommandExecuteEventImpl.
boolean	hasCommand(String alias)	Returns whether the given alias is registered on this manager.
void	register(BrigadierCommand command)	Registers the specified Brigadier command.
void	register(CommandMeta meta, Command command)	Registers the specified command with the given metadata.
default void	register(String alias, Command command, String... otherAliases)	Registers the specified command with the specified aliases.
void	unregister(String alias)	Unregisters the specified command alias from the manager, if registered.

Method Detail

createMetaBuilder

CommandMeta.Builder createMetaBuilder(String alias)

Returns a builder to create a CommandMeta with the given alias.

Parameters:

alias - the first command alias

Returns:

a CommandMeta builder

createMetaBuilder

CommandMeta.Builder createMetaBuilder(BrigadierCommand command)

Returns a builder to create a CommandMeta for the given Brigadier command.

Parameters:

command - the command

Returns:

a CommandMeta builder

register

default void register(String alias,
                      Command command,
                      String... otherAliases)

Registers the specified command with the specified aliases.

Parameters:

alias - the first command alias

command - the command to register

otherAliases - additional aliases

Throws:

IllegalArgumentException - if one of the given aliases is already registered, or the given command does not implement a registrable Command subinterface

See Also:

for a list of registrable subinterfaces

register

void register(BrigadierCommand command)

Registers the specified Brigadier command.

Parameters:

command - the command to register

Throws:

IllegalArgumentException - if the node alias is already registered

register

void register(CommandMeta meta,
              Command command)

Registers the specified command with the given metadata.

Parameters:

meta - the command metadata

command - the command to register

Throws:

IllegalArgumentException - if one of the given aliases is already registered, or the given command does not implement a registrable Command subinterface

See Also:

for a list of registrable subinterfaces

unregister

void unregister(String alias)

Unregisters the specified command alias from the manager, if registered.

Parameters:

alias - the command alias to unregister

execute

CompletableFuture<Boolean> execute(CommandSource source,
                                   String cmdLine)

Attempts to asynchronously execute a command from the given cmdLine.

Parameters:

source - the source to execute the command for

cmdLine - the command to run

Returns:

a future that may be completed with the result of the command execution. Can be completed exceptionally if an exception is thrown during execution.

executeImmediately

CompletableFuture<Boolean> executeImmediately(CommandSource source,
                                              String cmdLine)

Attempts to asynchronously execute a command from the given cmdLine without firing a CommandExecuteEventImpl.

Parameters:

source - the source to execute the command for

cmdLine - the command to run

Returns:

a future that may be completed with the result of the command execution. Can be completed exceptionally if an exception is thrown during execution.

hasCommand

boolean hasCommand(String alias)

Returns whether the given alias is registered on this manager.

Parameters:

alias - the command alias to check

Returns:

true if the alias is registered