Skip to content

A Small and simple wrapper around picocli as a minecraft command system

License

Notifications You must be signed in to change notification settings

jumanji144/picocli-minecraft

Repository files navigation

Picocli Minecraft

This project is small wrapper around picocli in the use of a command system.

Usage

The command system is highly oriented around the already existing picocli syntax with a few extra added things.
To register commands you must create a class that extends the respective platform base. After that picocli syntax can follow, with the exception that there is an added annotation @Permission that can be added to @Command annotated classes or methods that will check for the given permission before execution.
For execution the Base class requires you to implement the int execute() method. For context related values the respetive Example for bukkit:

@Command(
        name = "teleport",
        description = "Teleport players to a location",
        mixinStandardHelpOptions = true
)
@Permission(permission = "teleport.use")
public class TeleportCommand extends BukkitBase {

    @Option(names = {"-p"}, description="Player to teleport to", required=true)
    private Player p;
    
    public int execute() {
        if(getSender() instanceof Player) {
            ((Player)getSender()).teleport(p);
        }
    }

}

To then register the commands a CommandManager must be created and given a platform respective ICommandRegistrar.

Bukkit

public final class Test extends JavaPlugin {

    @Override
    public void onEnable() {
        CommandManager manager = new CommandManager(new BukkitCommandRegistrar(this));
        manager.register(new TeleportCommand());
    }

    @Override
    public void onDisable() {
        // Plugin shutdown logic
    }
}

BungeeCord

public final class Test extends Plugin {

    @Override
    public void onEnable() {
        CommandManager manager = new CommandManager(new BungeeCommandRegistrar(this));
        manager.register(new TeleportCommand());
    }

    @Override
    public void onDisable() {
        // Plugin shutdown logic
    }
}

CommandManager also allows you to define the help color scheme via setColorScheme

Examples

SpawnCommand

@Command(
        name = "spawn",
        description = "Spawn entities or blocks"
)
public class SpawnCommand extends BukkitBase {

    @Command(
            name = "entity",
            description = "Spawn an entity"
    )
    public int spawnEntity(@Parameters(paramLabel = "type", description = "The entity type to spawn") EntityType type) {
        if(getSender() instanceof Player) {
            Player player = (Player) getSender();
            player.getWorld().spawnEntity(player.getLocation(), type);
            return 0;
        } else {
            getSender().sendMessage("You must be a player to use this command");
            return 1;
        }
    }

    @Command(
            name = "block",
            description = "Spawn a block"
    )
    public int spawnBlock(@Parameters(paramLabel = "type", description = "The block type to spawn") Material material) {
        if(getSender() instanceof Player) {
            Player player = (Player) getSender();
            player.getWorld().getBlockAt(player.getLocation()).setType(material);
            return 0;
        } else {
            getSender().sendMessage("You must be a player to use this command");
            return 1;
        }
    }

    @Override
    public int execute() {
        // make it show the help message
        throw new ParameterException(getCommandLine(), "You must specify a subcommand");
    }
}

TeleportCommand

@Command(
        name = "teleport",
        description = "Teleport players to a location",
        mixinStandardHelpOptions = true
)
public class TeleportCommand extends BukkitBase {

    @Parameters(description = "The x coordinate to teleport to", arity = "0..1", defaultValue = "_NULL_")
    Optional<Double> x;

    @Parameters(description = "The y coordinate to teleport to", arity = "0..1", defaultValue = "_NULL_")
    Optional<Double> y;

    @Parameters(description = "The z coordinate to teleport to", arity = "0..1", defaultValue = "_NULL_")
    Optional<Double> z;

    @Option(names = {"-p", "--player"}, description = "The player to teleport", arity = "0..1", defaultValue = "_NULL_")
    Optional<Player> player;

    @Option(names = {"-w", "--world"}, description = "The world to teleport to", arity = "0..1", defaultValue = "_NULL_")
    Optional<World> world;


    @Override
    public int execute() {
        Player executor = null;
        if(getSender() instanceof Player) {
            executor = (Player) getSender();
        }
        Player target = player.orElse(executor);
        if(target == null) {
            getSender().sendMessage(ChatColor.RED + "You must be a player to use this command");
            return 1;
        }
        World world = this.world.orElseGet(target::getWorld);
        if(x.isPresent() && y.isPresent() && z.isPresent()) {
            target.teleport(new Location(world, x.get(), y.get(), z.get()));
        } else {
            if(target != executor) {
                target.teleport(executor);
            } else {
                if(player.isPresent()) {
                    getSender().sendMessage(ChatColor.RED + "You cannot teleport to yourself!");
                } else {
                    throw new ParameterException(getCommandLine(), "You must specify a location to teleport to");
                }
            }
        }
        return 0;
    }
}

Installation

To use this library in your own project you must add the following based on your platform:

Maven

<repositories>
    <repository>
        <id>jitpack.io</id>
        <url>https://jitpack.io</url>
    </repository>
</repositories>
<dependencies>
    <dependency>
        <groupId>com.github.Nowilltolife</groupId>
        <artifactId>picocli-minecraft</artifactId>
        <version>1.1.1-beta</version>
    </dependency>
</dependencies>

Gradle

repositories {
    maven { url 'https://jitpack.io' }
}
dependencies {
    implementation 'com.github.Nowilltolife:picocli-minecraft:1.1.1-beta'
}

Credits