Interface CommandServiceGrpc.AsyncService

All Known Implementing Classes:
CommandServiceGrpc.CommandServiceImplBase, CommandServiceImpl
Enclosing class:
CommandServiceGrpc

public static interface CommandServiceGrpc.AsyncService
Service for executing server commands and retrieving tab-completion suggestions.
Commands are executed using the Brigadier command framework and support various
operations including bot control, pathfinding, inventory management, and administration.
All operations require appropriate permissions based on the specified command scope.
  • Method Details

    • executeCommand

      default void executeCommand(CommandRequest request, io.grpc.stub.StreamObserver<CommandResponse> responseObserver)
      Executes a command string within the specified scope.
      The command is parsed and executed using the Brigadier command dispatcher.
      Permission requirements depend on the scope:
      - Global scope: Requires GLOBAL_COMMAND_EXECUTION permission
      - Instance scope: Requires INSTANCE_COMMAND_EXECUTION for the instance
      - Bot scope: Requires INSTANCE_COMMAND_EXECUTION for the parent instance
      Returns:
      - CommandResponse with the command's exit code
      Errors:
      - INVALID_ARGUMENT: If the scope is not set
      - PERMISSION_DENIED: If the user lacks required permissions
      - INTERNAL: If an unexpected error occurs during execution
      
    • tabCompleteCommand

      default void tabCompleteCommand(CommandCompletionRequest request, io.grpc.stub.StreamObserver<CommandCompletionResponse> responseObserver)
      Retrieves tab-completion suggestions for a partial command.
      Uses Brigadier's completion system to generate context-aware suggestions
      based on the command structure and current cursor position.
      Permission requirements depend on the scope (same as ExecuteCommand).
      Returns:
      - CommandCompletionResponse with a list of possible completions
      Errors:
      - INVALID_ARGUMENT: If the scope is not set
      - PERMISSION_DENIED: If the user lacks required permissions
      - INTERNAL: If an unexpected error occurs during completion