Package dev.oumaimaa.kawaiiapi.command

Class CommandManager

java.lang.Object

dev.oumaimaa.kawaiiapi.command.CommandManager

public final class CommandManager
extends Object

Advanced command management system for Paper plugins. Provides reflection-based command registration with subcommand support, tab completion, and permission handling.

Features:

• Automatic subcommand registration
• Smart tab completion
• Command caching for performance
• Error recovery and logging
• Thread-safe command storage

Version:

1.0

Author:

KawaiiDevelopment

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	CommandManager.CommandBuilder	Builder class for creating commands with a fluent API.

Method Summary

Modifier and Type	Method	Description
static void	createCoreCommand(@NotNull org.bukkit.plugin.java.JavaPlugin plugin, @NotNull String commandName, @NotNull String commandDescription, @NotNull String commandUsage, @Nullable CommandList commandList, @NotNull Class<? extends SubCommand>... subcommands)	Creates and registers a core command without aliases.
static void	createCoreCommand(@NotNull org.bukkit.plugin.java.JavaPlugin plugin, @NotNull String commandName, @NotNull String commandDescription, @NotNull String commandUsage, @Nullable CommandList commandList, @NotNull List<String> aliases, @NotNull Class<? extends SubCommand>... subcommands)	Creates and registers a core command with subcommands using modern Paper command system.
static @Nullable dev.oumaimaa.kawaiiapi.command.CoreCommand	getCommand(@NotNull String commandName)	Retrieves a registered core command by name.
static @NotNull @Unmodifiable List<String>	getRegisteredCommands()	Gets all currently registered command names.
static boolean	isCommandRegistered(@NotNull String commandName)	Checks if a command is currently registered.
static boolean	unregisterCommand(@NotNull String commandName)	Unregisters a previously registered command.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

createCoreCommand

@SafeVarargs
public static void createCoreCommand(@NotNull
 @NotNull org.bukkit.plugin.java.JavaPlugin plugin,
 @NotNull
 @NotNull String commandName,
 @NotNull
 @NotNull String commandDescription,
 @NotNull
 @NotNull String commandUsage,
 @Nullable
 @Nullable CommandList commandList,
 @NotNull
 @NotNull List<String> aliases,
 @NotNull
 @NotNull Class<? extends SubCommand>... subcommands)

Creates and registers a core command with subcommands using modern Paper command system. This method uses reflection to access the server's CommandMap for registration.

Parameters:

plugin - The plugin instance that owns this command

commandName - The name of the command to register

commandDescription - Description of the command's functionality

commandUsage - Usage syntax for the command (e.g., "/command ")

commandList - Optional custom display handler for command listing

aliases - List of command aliases (can be empty)

subcommands - Class references to SubCommand implementations

Throws:

IllegalStateException - if command registration fails

createCoreCommand

@SafeVarargs
public static void createCoreCommand(@NotNull
 @NotNull org.bukkit.plugin.java.JavaPlugin plugin,
 @NotNull
 @NotNull String commandName,
 @NotNull
 @NotNull String commandDescription,
 @NotNull
 @NotNull String commandUsage,
 @Nullable
 @Nullable CommandList commandList,
 @NotNull
 @NotNull Class<? extends SubCommand>... subcommands)

Creates and registers a core command without aliases. Convenience method that calls the full registration method with an empty alias list.

Parameters:

plugin - The plugin instance that owns this command

commandName - The name of the command to register

commandDescription - Description of the command

commandUsage - Usage syntax for the command

commandList - Optional custom display handler

subcommands - Class references to SubCommand implementations

unregisterCommand

public static boolean unregisterCommand(@NotNull
 @NotNull String commandName)

Unregisters a previously registered command. Useful for plugin reloading or dynamic command management.

Parameters:

commandName - The name of the command to unregister

Returns:

true if the command was found and unregistered

getCommand

@Nullable
public static @Nullable dev.oumaimaa.kawaiiapi.command.CoreCommand getCommand(@NotNull
 @NotNull String commandName)

Retrieves a registered core command by name.

Parameters:

commandName - The command name to look up

Returns:

The CoreCommand instance, or null if not found

isCommandRegistered

public static boolean isCommandRegistered(@NotNull
 @NotNull String commandName)

Checks if a command is currently registered.

Parameters:

commandName - The command name to check

Returns:

true if the command is registered

getRegisteredCommands

@NotNull
public static @NotNull @Unmodifiable List<String> getRegisteredCommands()

Gets all currently registered command names.

Returns:

Immutable list of registered command names