Simple Commands
BaseIO simplifies command creation with the class SimpleCommand
. Instead of implementing ICommand
you extend SimpleCommand
.
If you don't like the simplifications made by this feature just override the original method from ICommand.
This is what SimpleCommand can do for you:
-
Simple command names
getCommandName()
andgetCommandAliases()
are combined incommandNames()
where the first command name is the actual command name and the others are aliases. Example: -
public List<String> commandNames() {
//return Collections.singletonList("name1");
return Arrays.asList("name1", "name2", "name3");
} -
localized/default command usage
Provide a localization key incommandUsage()
and it will be localized as described in Localization. Provide an invalid or no (null) localization key and SimpleCommand creates a default command usage for you based on the arguments. -
redundancy removal
isUsernameIndex
andcompareTo
are removed.
-
Options
You can define command options ingetOptions()
. Options are arguments starting with a hyphen that can be used at any position of the arguments. Additionally options might have arguments attached to themselves. When implemented, getOptions() must return a map with the option string as the key and a string array of potential option arguments, the elements describing the option argument at its index. If found, the options will be cut out of the argument array and added to the option set that will be passed to the run method you have to implement in your command.
Example: -
@Override
public void run(MinecraftServer server, ICommandSender sender, String[] args, Map<String, String[]> options) {
System.out.println("Args: " + String.join(" ", args));
for (Map.Entry<String, String[]> option: options.entrySet()) {
System.out.println("Option " + option.getKey() + ": " + (option.getValue == null ? "null" : String.join(" ", option.getValue())));
}
}
@NotNull
@Override
protected Map<String, String[]> getOptions() {
//return Utils.mapKeys("opt1", "opt2", "opt3");
return Utils.map("opt1", new String[]{"oa1", "oa2"}, "opt2", null, "opt3", null);
}If now a player uses the command
/mycommand arg1 arg2 -opt1 A B arg3 -opt3
the output would be:Args: arg1 arg2 arg3
Option opt1: A B
Option opt3: null -
Tab Completion
Tab completions can be defined by the return string intabCompletions()
. The syntax allowes highly configurable tab completions:- The completions for each argument are seperated by a space.
- The different