Package dev.jorel.commandapi.arguments

Class CustomArgument<T,B>

java.lang.Object

dev.jorel.commandapi.AbstractArgumentTree<Argument<T>,Argument<?>,org.bukkit.command.CommandSender>

dev.jorel.commandapi.arguments.AbstractArgument<T,Argument<T>,Argument<?>,org.bukkit.command.CommandSender>

dev.jorel.commandapi.arguments.Argument<T>

dev.jorel.commandapi.arguments.CustomArgument<T,B>

Type Parameters:

T - the return type of this custom argument when it is used

B - the return type of the underlying base argument base. For example, this would be Integer for an IntegerArgument

All Implemented Interfaces:

BukkitExecutable<Argument<T>>, ChainableBuilder<Argument<T>>, PlatformExecutable<Argument<T>,org.bukkit.command.CommandSender>

public class CustomArgument<T,B>
extends Argument<T>

An argument that represents any custom object

Since:

2.0

API Note:

Returns a CustomArgument object

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	CustomArgument.CustomArgumentException	An exception used to create command-related errors for the CustomArgument
static final record	CustomArgument.CustomArgumentInfo<B>	A record which contains information which can be passed to the custom argument's parser.
static interface	CustomArgument.CustomArgumentInfoParser<T,B>	A FunctionalInterface that takes in a CustomArgument.CustomArgumentInfo, returns T and can throw a CustomArgument.CustomArgumentException
static class	CustomArgument.MessageBuilder	MessageBuilder is used to create error messages for invalid argument inputs

Field Summary

Fields

Modifier and Type	Field	Description
protected CommandAPIExecutor<org.bukkit.command.CommandSender,AbstractCommandSender<? extends org.bukkit.command.CommandSender>>	executor

Constructor Summary

Constructors

Constructor	Description
CustomArgument(Argument<B> base, CustomArgument.CustomArgumentInfoParser<T,B> parser)	Creates a CustomArgument with a valid parser, with an underlying base argument as its parsing implementation.

Method Summary

Modifier and Type	Method	Description
Argument<T>	clearExecutors()
CommandAPIArgumentType	getArgumentType()
CommandAPIExecutor<org.bukkit.command.CommandSender,AbstractCommandSender<? extends org.bukkit.command.CommandSender>>	getExecutor()
Class<T>	getPrimitiveType()
<CommandSourceStack> T	parseArgument(com.mojang.brigadier.context.CommandContext<CommandSourceStack> cmdCtx, String key, CommandArguments previousArgs)
void	setExecutor(CommandAPIExecutor<org.bukkit.command.CommandSender,AbstractCommandSender<? extends org.bukkit.command.CommandSender>> arg0)

Methods inherited from class dev.jorel.commandapi.arguments.Argument

instance

Methods inherited from class dev.jorel.commandapi.arguments.AbstractArgument

combineWith, copyPermissionsAndRequirements, getArgumentPermission, getCombinedArguments, getEntityNames, getHelpString, getIncludedSuggestions, getNodeName, getOverriddenSuggestions, getRawType, getRequirements, hasCombinedArguments, includeSuggestions, isListed, isOptional, replaceSuggestions, setListed, setOptional, toString, withPermission, withPermission, withRequirement

Methods inherited from class dev.jorel.commandapi.AbstractArgumentTree

then

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Methods inherited from interface dev.jorel.commandapi.BukkitExecutable

executes, executes, executes, executes, executesCommandBlock, executesCommandBlock, executesCommandBlock, executesCommandBlock, executesConsole, executesConsole, executesConsole, executesConsole, executesEntity, executesEntity, executesEntity, executesEntity, executesFeedbackForwarding, executesFeedbackForwarding, executesFeedbackForwarding, executesFeedbackForwarding, executesNative, executesNative, executesNative, executesNative, executesPlayer, executesPlayer, executesPlayer, executesPlayer, executesProxy, executesProxy, executesProxy, executesProxy, executesRemoteConsole, executesRemoteConsole, executesRemoteConsole, executesRemoteConsole

Methods inherited from interface dev.jorel.commandapi.PlatformExecutable

getExecutor

Field Details

executor

protected CommandAPIExecutor<org.bukkit.command.CommandSender,AbstractCommandSender<? extends org.bukkit.command.CommandSender>> executor

Constructor Details

CustomArgument

public CustomArgument(Argument<B> base,
 CustomArgument.CustomArgumentInfoParser<T,B> parser)

Creates a CustomArgument with a valid parser, with an underlying base argument as its parsing implementation.

Parameters:

base - the base argument to use for this custom argument. This base argument will represent the parsing implementation for client side and server side parsing. This base argument cannot be a LiteralArgument or MultiLiteralArgument

parser - A CustomArgument.CustomArgumentInfo parser object which includes information such as the command sender, previously declared arguments and current input. This parser should return an object of your choice.

<T> the return type of this custom argument when it is used
<B> the return type of the underlying base argument base. For example, this would be Integer for an IntegerArgument

Method Details

getPrimitiveType

public Class<T> getPrimitiveType()

Specified by:

getPrimitiveType in class AbstractArgument<T,Argument<T>,Argument<?>,org.bukkit.command.CommandSender>

getArgumentType

public CommandAPIArgumentType getArgumentType()

Specified by:

getArgumentType in class AbstractArgument<T,Argument<T>,Argument<?>,org.bukkit.command.CommandSender>

parseArgument

public <CommandSourceStack> T parseArgument(com.mojang.brigadier.context.CommandContext<CommandSourceStack> cmdCtx,
 String key,
 CommandArguments previousArgs)
                                     throws com.mojang.brigadier.exceptions.CommandSyntaxException

Specified by:

parseArgument in class AbstractArgument<T,Argument<T>,Argument<?>,org.bukkit.command.CommandSender>

Throws:

com.mojang.brigadier.exceptions.CommandSyntaxException

getExecutor

public CommandAPIExecutor<org.bukkit.command.CommandSender,AbstractCommandSender<? extends org.bukkit.command.CommandSender>> getExecutor()

setExecutor

public void setExecutor(CommandAPIExecutor<org.bukkit.command.CommandSender,AbstractCommandSender<? extends org.bukkit.command.CommandSender>> arg0)

clearExecutors

public Argument<T> clearExecutors()