Complex Commands

public class ExampleCommand {
    @Command("example")
    @Description("The description of your command, optional.")
    @Permission("command.permission") // Optional, set to "op" to require OP
    @Hidden // Optional, hides the command from the generated help
    @Async // Optional
    @Quoted // Optional, parses quoted strings into a single argument
    public static void example(
        // Command sender, required:
        @Sender CommandSender sender,
        // Type can be: CommandSender, Player, ConsoleCommandSender
        // Or any custom type if you register a SenderProvider<T>.

        // Regular arguments:
        @Name("player") Player player,
        // You can make the argument optional (will be null if not provided):
        @Name("player") @Opt Player player,
        // or, you can make it default to the sender if not provided:
        @Name("player") @Opt(Opt.Type.SENDER) Player player,
        // Multi-word (combined) string arguments:
        @Name("message") @Greedy String message,
        // Number arguments with a range:
        @Name("amount") @Range(min = 1, max = 64) int amount,

        // You can also use custom providers for just one argument:
        @Provider(MyPlayerProvider.class) Player customPlayer,
        // And you can specify the scope (`BOTH`, `PARSER`, `SUGGESTIONS`), defaults to `BOTH`:
        @Provider(value = MyPlayerProvider.class, scope = Provider.Scope.SUGGESTIONS) Player customPlayer2,

        // Command flags:
        @Flag(value = 's', description = "Optional description") boolean flagSilent,
        // You can also have complex types as flags:
        @Flag('p') Player anotherPlayer
    ) {
        sender.sendMessage("(You -> " + anotherPlayer + ") $" + amount);

        if (!flagSilent) {
            player.sendMessage("(" + sender.getName() + " -> You) +$" + amount);
        } else {
            player.sendMessage("(Anonymous -> You) +$" + amount);
        }
    }
}

public class BroadcastCommand {
    @Command("broadcast")
    @Description("Send a message to all players")
    @Permission("myplugin.broadcast")
    public static void broadcast(
        @Sender CommandSender sender,
        @Name("message") @Greedy String message
    ) {
        // @Greedy captures everything after the command as one string
        // No need for quotes: /broadcast Hello everyone, this is a test!
        
        for (Player player : Bukkit.getOnlinePlayers()) {
            player.sendMessage(ChatColor.GOLD + "[Broadcast] " + ChatColor.RESET + message);
        }
    }
}

public class NickCommand {
    @Command("nick")
    @Description("Set a player's nickname")
    @Quoted // Enables quote parsing for this command
    public static void nick(
        @Sender Player sender,
        @Name("nickname") String nickname
    ) {
        // With @Quoted, players can use:
        // /nick "Cool Name" - Sets nickname to "Cool Name"
        // /nick SimpleName - Sets nickname to "SimpleName"
        
        sender.setDisplayName(nickname);
        sender.sendMessage("Nickname set to: " + nickname);
    }
}

public class GiveCommand {
    @Command("give")
    @Description("Give items to a player")
    @Permission("myplugin.give")
    public static void give(
        @Sender CommandSender sender,
        @Name("player") Player target,
        @Name("item") Material item,
        @Name("amount") @Range(min = 1, max = 64) int amount
    ) {
        // Range is automatically validated - no manual checking needed!
        // Players cannot specify less than 1 or more than 64
        
        ItemStack stack = new ItemStack(item, amount);
        target.getInventory().addItem(stack);
        
        sender.sendMessage("Gave " + amount + " " + item + " to " + target.getName());
    }
}

public class DatabaseCommand {
    @Command("lookup")
    @Description("Look up player data from database")
    @Async // This command runs on a separate thread
    public static void lookup(
        @Sender CommandSender sender,
        @Name("player") String playerName
    ) {
        // This runs asynchronously - safe for database queries!
        PlayerData data = database.getPlayerData(playerName);
        
        if (data == null) {
            sender.sendMessage("Player not found in database");
            return;
        }
        
        sender.sendMessage("Player: " + playerName);
        sender.sendMessage("Playtime: " + data.getPlaytime());
        sender.sendMessage("Last seen: " + data.getLastSeen());
    }
}

public class DebugCommand {
    @Command("debug")
    @Description("Debug command for developers")
    @Hidden // Won't appear in /help
    @Permission("myplugin.debug")
    public static void debug(@Sender CommandSender sender) {
        sender.sendMessage("Debug info: " + getDebugInfo());
    }
}

public class CustomParseCommand {
    @Command("givecustom")
    public static void giveCustom(
        @Sender Player sender,
        // Use default Player provider
        @Name("target") Player normalTarget,
        // Use custom provider that includes offline players
        @Provider(OfflinePlayerProvider.class) Player offlineTarget
    ) {
        sender.sendMessage("Normal: " + normalTarget.getName());
        sender.sendMessage("Offline: " + offlineTarget.getName());
    }
}

public class EconomyCommand {
    @Command("economy pay")
    @Description("Send money to another player")
    @Permission("economy.pay")
    public static void economyPay(
        @Sender Player sender,
        @Name("recipient") Player recipient,
        @Name("amount") @Range(min = 0.01, max = 1000000) double amount,
        @Flag(value = 's', description = "Send anonymously", longName = "silent") boolean silent,
        @Flag(value = 'm', description = "Include a message") @Opt String message
    ) {
        // Validate sender has enough money
        if (economy.getBalance(sender) < amount) {
            sender.sendMessage(ChatColor.RED + "Insufficient funds!");
            return;
        }
        
        // Process transaction
        economy.withdraw(sender, amount);
        economy.deposit(recipient, amount);
        
        // Notify sender
        sender.sendMessage(ChatColor.GREEN + "Sent $" + String.format("%.2f", amount) 
            + " to " + recipient.getName());
        
        // Notify recipient
        String fromName = silent ? "Someone" : sender.getName();
        recipient.sendMessage(ChatColor.GREEN + fromName + " sent you $" 
            + String.format("%.2f", amount));
        
        if (message != null) {
            recipient.sendMessage(ChatColor.GRAY + "Message: " + message);
        }
    }
}