LiteCommands v3.9.1

What's Changed

• GH-478 Add description support for programmatic API. Fix type resolving by @huanmeng-qwq in #478
• GH-483 Respect JDA choices limit. by @Rollczi in #483
• dependency: Update dependency net.dv8tion:JDA to v5.2.1 by @renovate in #479
• dependency: Update dependency shadow and jpenilla run plugins for examples by @Rollczi in #481

Update dependencies

implementation("dev.rollczi:{artifact}:3.9.1")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.9.1</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.9.0...v3.9.1

LiteCommands v3.9.0

What's Changed

• GH-460 Remove experimental state from priority domain. by @Rollczi in #460
• dependency: Update fabricmc dependencies by @renovate in #464
• dependency: Update all minor and patch dependencies by @renovate in #462
• dependency: Update dependency net.fabricmc:fabric-loader to v0.16.8 by @renovate in #467
• GH-474 Suggestion tooltip by @huanmeng-qwq in #461
• dependency: Update fabricmc by @renovate in #472
• GH-471 Fix jda number suggestions by @Rollczi in #475
• GH-476 Support type wrappers for native JDA option types. by @Rollczi in #476
• dependency: Update plugin fabric-loom to v1.8.12 by @renovate in #466

Thanks you @huanmeng-qwq for the tooltips feature. 😻
Also thanks to @Knerio for helping me find the bug on JDA platform. ❤️

Update dependencies

implementation("dev.rollczi:{artifact}:3.9.0")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.9.0</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.8.0...v3.9.0

LiteCommands v3.8.0

What's Changed

• GH-452 Update all minor and patch dependencies by @renovate in #452
• dependency: Update all major dependencies (major) by @renovate in #453
• GH-455 Update CI build, Fix sponge CI compilation by @Rollczi in #455
• GH-456 Improve Fabric by @huanmeng-qwq in #456
• GH-457 Add priority for fail results. by @Rollczi in #457
• GH-378 GH-459 Support literal arguments. Support collections types for OptionalArg by @Rollczi in #458

Update dependencies

implementation("dev.rollczi:{artifact}:3.8.0")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.8.0</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.7.1...v3.8.0

LiteCommands v3.7.1

What's Changed

• GH-448 Update README links to new documentation by @TheDarkW3b in #450
• GH-444 Improve parsers caches by @Rollczi in #451

Thanks @TheDarkW3b ❤️ 📃

Update dependencies

implementation("dev.rollczi:{artifact}:3.7.1")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.7.1</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

New Contributors

• @TheDarkW3b made their first contribution in #450

Full Changelog: v3.7.0...v3.7.1

LiteCommands v3.7.0

What's Changed

• GH-440 Add Hacktoberfest 11 benner to README.md by @Rollczi in #440
• GH-441 Update README.md by @Rollczi in #441
• GH-427 Support async parse result. by @Rollczi in #435
• GH-442 Change default nativeMap of BiHashMap to ConcurrentHashMap by @OOP-778 in #443
• GH-445 Factories Unification by @SfenKer in #445
• GH-446 Hot fix offline player NPE. by @Rollczi in #447

Thanks @OOP-778 for the important bug fix ❤️

🟢 Add alias for @Context annotation

@Command(name = "hello")
public class HelloCommand {
    @Execute
    void command(@Sender CommandSender sender, @Arg String name) {
        // ...
    }
}

🟢 Add an option to create Annotation aliases like as @Sender

You can implement your annotation:

@Retention(RetentionPolicy.RUNTIME)
@Target(ElementType.PARAMETER)
@RequirementDefinition(type = RequirementDefinition.Type.CONTEXT)
public @interface MySender {
}

And use it in your commands:

    @Execute
    void command(@MySender CommandSender sender, @Arg String name) {
        // ...
    }

🟢 Support completableFuture/async parse/context result:

public class UserArgumentResolver extends ArgumentResolver<CommandSender, User> {

    private final Pattern VALID_USER_PATTERN = Pattern.compile("^[a-zA-Z0-9_]{3,16}$");
    private final UserService userService;

    public UserArgumentResolver(UserService userService) {
        this.userService = userService;
    }

    @Override
    protected ParseResult<User> parse(Invocation<CommandSender> invocation, Argument<User> context, String argument) {
        CompletableFuture<ParseResult<User>> userNotFound = userService.getUser(argument)
            .thenApply(user -> user != null ? ParseResult.success(user) : ParseResult.failure("User not found"));

        return ParseResult.completableFuture(userNotFound);
    }

    @Override
    public boolean match(Invocation<CommandSender> invocation, Argument<User> context, String argument) {
        return VALID_USER_PATTERN.matcher(argument).matches();
    }
}

🟢 when you call blocking methods you can use ParseResult.async()

    @Override
    protected ParseResult<User> parse(Invocation<CommandSender> invocation, Argument<User> context, String argument) {
        return ParseResult.async(() -> userDatabase.getUser(argument));
    }

⚠️ When you return async/completableFuture result then you must also implement match method for correct suggestion validation

🟢 See also same API for ContextResult

ContextResult.completableFuture()

ContextResult.async()

🔴 Removed wrapper API

🔴 Breaking changes (Internal API)

See more #435

Update dependencies

implementation("dev.rollczi:{artifact}:3.7.0")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.7.0</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

New Contributors

• @OOP-778 made their first contribution in #443
• @SfenKer made their first contribution in #445

Full Changelog: v3.6.1...v3.7.0

LiteCommands v3.6.1

What's Changed

• GH-438 Bukkit OfflinePlayer argument by @BlackBaroness in #438

Thanks for @BlackBaroness

Update dependencies

implementation("dev.rollczi:{artifact}:3.6.1")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.6.1</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.6.0...v3.6.1

LiteCommands v3.6.0

What's Changed

• GH-357 Add priority api, strict mode, event api and @DefaultExecute. Snapshot 3.6.0-SNAPSHOT by @Rollczi in #366
• GH-412 Remove panda sdk and expiringmap by @Rollczi in #430
• GH-431 Use Versions.kt object to centralize versions. by @vLuckyyy in #433
• GH-434 Hot fix BukkitScheduler by @Rollczi in #434

Thanks @vLuckyyy

🟢 Add an option to disable strict mode.
If you disable strict mode for a command, then users will be able to add unexpected arguments e.g.
/help first asdfioaosdf asodfn asodimf <- this will work!

@Command(name = "help", strict = StrictMode.DISABLED)
class HelpCommand {

    @Execute
    void helpCommand(@Arg String arg) {
        
    }

}

You can also disable strict mode by calling:

.strictMode(StrictMode.DISABLED);

on builder.

⚠️ Experimental @ExecuteDefault

@Command(name = "kick")
public class KickCommand {
    @ExecuteDefault
    void commandHelp(@Context SENDER sender) {
        // /kick incorrect input
    }

    @Execute(name = "-all")
    void kickAll() {
        // /kick -all
    }
}

⚠️ Experimental @Priority

@Command(name = "test")
public class TestCommand {
    @Execute
    @Priority(PriorityValue.HIGH)
    void execute(int number) {
        // ...
    }

    @Execute
    @Priority(PriorityValue.LOW)
    void execute(String text) {
        // ...
    }
}

⚠️ Experimental Event system
Available events:

• CandidateExecutorFoundEvent
• CandidateExecutorMatchEvent
• CommandPreExecutionEvent
• CommandPostExecutionEvent

Simple example, how to block the execution of a command:

public class TellCommandController<SENDER> implements EventListener {
    
    @Subscriber
    public void onEvent(CommandPreExecutionEvent<SENDER> event) {
        SENDER sender = event.getInvocation().sender();

        if (event.getInvocation().name().equals("tell") && sender.isMuted()) {
            event.stopFlow(FailedReason.of("&cYou are muted!"));
        }
    }
}

Update dependencies

implementation("dev.rollczi:{artifact}:3.6.0")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.6.0</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.5.0...v3.6.0

LiteCommands v3.5.0

What's Changed

• GH-415 Add chained contexts by @Rollczi in #415
• GH-386 Add Varargs annotation and processor. by @Rollczi in #386
• GH-418 Add BukkitCommand#getCommandRoute by @Rollczi in #418
• GH-419 Fix Suggestion#of and number formatting. by @Rollczi in #419
• GH-420 Add an option to define permission, which allows bypassing cooldown by @rchomczyk in #420
• GH-421 Add missing api. Remove useless method. by @Rollczi in #421
• GH-423 Lazy load jakarta validator by @Rollczi in #423
• GH-424 Update example. Fix also legacy simple schematic generator. by @Rollczi in #424
• GH-425 Fix @OptionalArg annotation for the jda platform. by @Rollczi in #425

Thanks @rchomczyk ❤️

🟢 Added bypass for @Cooldown

@Command(name = "test")
@Cooldown(key = "key", count = 1, unit = SECONDS, bypass = "your.bypass")
public class TestCommand {
   // ...
}

🟢 Added JakartaSettings#violationMessage for value type

Example usage:

.violationMessage(Max.class, Integer.class, (invocation, violation) -> "Invalid value: " + violation.getInvalidValue() + " for " + violation.getParameterName())

⚠️ Experimental @Varargs annotation

/numbers <numbers...>

@Command(name = "numbers")
public class NumbersCommand {

    @Execute
    void numbers(@Varargs(delimiter = ",") List<Double> numbers) {
        // ...
    }

}

Example input: /numbers 15,40.5,-1

⚠️ Experimental ContextChainedProvider, ArgumentResolverChained, BindChainedProvider

This can be helpful when you want to create a context/argument resolver/bind that is dependent on another.

Example for context:

public class GuildContextProvider<SENDER> implements ContextChainedProvider<SENDER, Guild> {

    @Override
    public ContextResult<LiteTestGuild> provide(Invocation<SENDER> invocation, ContextChainAccessor<SENDER> accessor) {
        return accessor.provideContext(User.class, invocation)
            .flatMap(user -> user.getGuild() == null
                ? ContextResult.error("User is not in a guild")
                : ContextResult.ok(() -> user.getGuild())
            );
    }
}

🔴 Removed JakartaSettings#constraintViolationsMessage

Use JakartaSettings#violationMessage instead.
Now If you want to join all violations into one message, then implement your ResultHandler for JakartaRawResult type.

Update dependencies

implementation("dev.rollczi:{artifact}:3.5.0")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.5.0</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.4.3...v3.5.0

LiteCommands v3.4.3

What's Changed

• GH-404 Add currency example with multi file command. by @Rollczi in #404
• GH-407 Add platform receiver. Fix rcon bukkit adventure platform bug. by @Rollczi in #407
• Add build-in context providers and argument resolvers for the velocity platform. by @Rollczi in #413

Update dependencies

implementation("dev.rollczi:{artifact}:3.4.3")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.4.3</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.4.2...v3.4.3

LiteCommands v3.4.2

What's Changed

• GH-396 Add result handler for arrays by @rchomczyk in #396
• GH-400 Add UUID argument resolver by @BlackBaroness in #400
• GH-401 Support inherited methods. by @Rollczi in #401

Thanks @rchomczyk @BlackBaroness @RyanTheTechMan ❤️

Update dependencies

implementation("dev.rollczi:{artifact}:3.4.2")

<dependency>
    <groupId>dev.rollczi</groupId>
    <artifactId>{artifact}</artifactId>
    <version>3.4.2</version>
</dependency>

⚠️ Replace {artifact} with platform artifact

Full Changelog: v3.4.1...v3.4.2