Add a greedy "list argument"

From #275.

Please describe your suggestion Allowing users to enter a list of values is very useful. WorldEdit has a nice implementation of a list argument, where users can provide a list of materials to manipulate blocks:

Implementing this “properly” is outside of the basic scope of the CommandAPI for now (see regex argument mod), however we can “simulate” a list argument by using an underlying GreedyStringArgument with a powerful suggestion provider.

Work for this has already begun on the dev/listargument branch.

Formally, we need to support:

• Providing a list of values for the list
• Ensuring that the inputs to the argument don’t accept values outside of the provided list (e.g. a list [apple, banana, cat] can’t (or won’t) accept dirt as a value)
• Allowing users to provide tooltips to entries
• Allowing users to specify a delimiter (e.g. a comma vs a space)
• The casting type should be a Collection parameterized over some type T which is provided by the users

Please supply examples of the desired inputs and outputs Example: Input: Using the following code:

List<String> list = List.of("apple", "banana", "cat", "dog", "elephant");
new CommandAPICommand("blah")
    .withArguments(new ListArgumentBuilder<String>("node", " ").withList(list).withStringMapper().build())
    .executes((sender, args) -> {
        Collection<String> myList = (Collection<String>) args[0];
        sender.sendMessage("Provided: " + myList);
    })
    .register();

new CommandAPICommand("blahcomma")
.withArguments(new ListArgumentBuilder<String>("node", ",").withList(list).withStringMapper().build())
.executes((sender, args) -> {
    Collection<String> myList = (Collection<String>) args[0];
    sender.sendMessage("Provided: " + myList);
})
.register();

Output: Typing a command can accept a list of arguments:

[SNWCreations]

I’m looking forward to this update. 😃 👍

[SNWCreations]

Implemented in 8.2.0.

@SNWCreations Yes, dynamic lists are supported, you can read all about it in the 8.2.0 documentation for list arguments here: https://commandapi.jorel.dev/8.2.0/listarguments.html

Thank you! I will upgrade my project in future. (I am too busy now.)