LiteCommands

<div align="right">

</div> <div align="center"> <img src="https://github.com/Rollczi/LiteCommands/assets/49173834/4c297b16-eacd-4c89-ba34-2767b114e391" alt="banner" width="65%"/> <br><br>

LiteCommands

Annotation based command framework for Velocity, Bukkit, Paper, BungeeCord, Minestom, Sponge, Fabric, JDA, TelegramBots and future implementations.

</div>

📌 Helpful links

• Support Discord
• Bugs & issues report
• Documentation

✨ Features

• Simple Arguments @Arg & Optional arguments @OptionalArg
• Flags - @Flag
• Joiner - @Join remaining arguments into a string
• Literal arguments - @Literal
• @Quoted arguments for "quoted input!"
• Asynchronous commands, argument parsing and completion. @Async
• Context providers - e.g. @Sender Player, @Context World and more
• Command shortcuts @Shortcut
• Support for basic types: int, double, Duration, LocalDateTime, Location and more!
• Support for collection types: List, Set, TreeSet, Queue, java array T[] and many others!
• IntelliJ Plugin that provides annotation inspections, syntax highlighting and more!
• Custom annotation validators. (example)
• Programmatic API for creating more dynamic commands. (example)
• Jakarta EE annotation validation. (extension)
• ChatGPT suggestions. (extension)
• Adventure Kyori support. (extension)
• and more! ✨

📦 Platforms

• Velocity
• Bukkit, Spigot, Paper
• Folia (extension) (by Kropsk)
• BungeeCord, Waterfall (by rchomczyk)
• Minestom (by Codestech1)
• Sponge (by BlackBaroness)
• Fabric (by huanmeng_qwq)
• JDA
• TelegramBots (by BlackBaroness)

💡 Command Example

This is an example of /hello <name> <amount> command:

javaCopy
@Command(name = "hello")
@Permission("dev.rollczi.helloworld")
public class HelloCommand {

    @Execute
    void command(@Sender CommandSender sender, @Arg String name, @Arg int amount) {
        for (int i = 0; i < amount; i++) {
            sender.sendMessage("Hello " + name);
        }
    }
}

Then we need to register the command in plugin main class: (in this case for Bukkit)

javaCopy
this.liteCommands = LiteBukkitFactory.builder("example-plugin")
    .commands(new HelloCommand())
    .build();

🚀 Get Started

➕ Add Panda Repository ❤️

ktsCopy
maven("https://repo.panda-lang.org/releases")

xmlCopy
<repository>
    <id>panda-repository</id>
    <url>https://repo.panda-lang.org/releases</url>
</repository>

➕ Add LiteCommands to dependencies

ktsCopy
implementation("dev.rollczi:{artifact}:3.11.0")

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

⚠️ Replace {artifact} with platform artifact
Add -parameters flag to your compiler to use all features (read more)

<h2> 💖 GitHub Sponsors</h2>

diffCopy
@@ Special thanks to all sponsors for supporting me and my projects! ❤️ @@

<!-- sponsors --><!-- sponsors -->

🔮 Official IntelliJ Plugin

With LiteCommands plugin, you can easily develop your commands within the IntelliJ IDEA environment.
The plugin provides annotation inspections, tools for creating new command classes, syntax highlighting, code completion,
and other useful features to make your development experience smoother and more efficient. How to install?

🌍 More Examples

➕ Official examples

• Bukkit Example
• Velocity Example
• ChatGPT Example
• Bukkit (with Adventure Platform)

➕ Plugins that use LiteCommands!

• EternalCore
• EternalCombat
• ChatFormatter

<div> <h2>💖 Thanks for our partners!</h2> <a href="https://www.jetbrains.com/idea/"> <img src="https://resources.jetbrains.com/storage/products/company/brand/logos/jetbrains.svg" alt="JetBrains" width="20%"/> </a> <p> <b>JetBrains</b><br> Supports us with a free license for the most intelligent Java IDE - <b><a href="https://www.jetbrains.com/idea/">IntelliJ IDEA Ultimate</a></b> </p> <a href="https://reposilite.com/"> <img src="https://avatars.githubusercontent.com/u/88636591" alt="Reposilite" width="7%"/> </a> <p> <b>Reposilite</b><br> Provides us with a Maven repository for our artifacts - <b><a href="https://repo.panda-lang.org/">Reposilite Repository</a></b> </p> <a href="https://www.yourkit.com/java/profiler/"> <img src="https://www.yourkit.com/images/yklogo.png" alt="YourKit" width="15%"/> </a> <p> <b>YourKit</b><br> Supports us with a innovative and intelligent tools for monitoring and profiling - <b><a href="https://www.yourkit.com/java/profiler/">YourKit Java Profiler</a></b> </p> </div>