silk-commands/net.silkmc.silk.commands/CommandBuilder

CommandBuilder

abstract class CommandBuilder<Source : SharedSuggestionProvider, Builder : ArgumentBuilder<Source, Builder>, Node : CommandNode<Source>>(source)

Inheritors

LiteralCommandBuilder

ArgumentCommandBuilder

Constructors

CommandBuilder

constructor()

Functions

argument

inline fun <T> argument(name: String, builder: SimpleArgumentBuilder<Source, T> = {}): ArgumentCommandBuilder<Source, T>

Adds a new argument to this command. The ArgumentType will be resolved using the reified type T. For a list of supported types, have a look at ArgumentTypeUtils.fromReifiedType, as it is the function used by this builder function.

inline fun <T> argument(name: String, type: ArgumentType<T>, builder: SimpleArgumentBuilder<Source, T> = {}): ArgumentCommandBuilder<Source, T>

Adds a new argument to this command. This variant of the argument function allows you to specify the ArgumentType in the classical Brigadier way.

@JvmName(name = "argumentWithCustomParser")

inline fun <T> argument(name: String, crossinline parser: (StringReader) -> T, builder: SimpleArgumentBuilder<Source, T> = {}): ArgumentCommandBuilder<Source, T>

Adds a new argument to this command. This variant of the argument function you to specifiy the argument parse logic using a Kotlin lambda function (parser).

@JvmName(name = "argumentWithContextualType")

inline fun <T> argument(name: String, noinline typeProvider: (CommandBuildContext) -> ArgumentType<T>, builder: SimpleArgumentBuilder<Source, T> = {}): ArgumentCommandBuilder<Source, T>

Adds a new argument to this command. This variant of the argument function allows you to pass and argument which depends on the CommandBuildContext.

brigadier

fun brigadier(block: Builder.(context: CommandBuildContext) -> Unit): CommandBuilder<Source, Builder, Node>

This function allows you to access the regular Brigadier builder. The type of this in its context will equal the type of Builder.

literal

inline fun literal(name: String, builder: LiteralCommandBuilder<Source>.() -> Unit = {}): LiteralCommandBuilder<Source>

Adds a new subcommand / literal to this command.

requires

fun requires(predicate: (source: Source) -> Boolean): CommandBuilder<Source, Builder, Node>

Specifies that the given predicate must return true for the Source in order for it to be able to execute this part of the command tree. Use this function on the root command node to secure the whole command.

requiresPermissionLevel

fun requiresPermissionLevel(level: Int): CommandBuilder<Source, Builder, Node>

Specifies that the given permission level is required to execute this part of the command tree. A shortcut delegating to requires.

fun requiresPermissionLevel(level: PermissionLevel): CommandBuilder<Source, Builder, Node>

Specifies that the PermissionLevel given as level is required to execute this part of the command tree. A shortcut delegating to requires.

runs

infix inline fun runs(crossinline block: CommandContext<Source>.() -> Unit): CommandBuilder<Source, Builder, Node>

Adds execution logic to this command. The place where this function is called matters, as this defines for which path in the command tree this executor should be called.

runsAsync

infix inline fun runsAsync(crossinline block: suspend CommandContext<Source>.() -> Unit): CommandBuilder<Source, Builder, Node>

Does the same as runs (see its docs for more information), but launches the command logic in an async coroutine.

simpleExecutes

infix inline fun ~~simpleExecutes~~(crossinline executor: CommandContext<Source>.() -> Unit): CommandBuilder<Source, Builder, Node>

Adds custom execution logic to this command. DEPRECATED Use runs instead.

toBrigadier

open fun toBrigadier(context: CommandBuildContext): List<Node>

Converts this Kotlin command builder abstraction to an ArgumentBuilder of Brigadier.