Package dev.rollczi.litecommands

Interface LiteCommandsBuilder<SENDER,SETTINGS extends dev.rollczi.litecommands.platform.PlatformSettings,B extends LiteCommandsBuilder<SENDER,SETTINGS,B>>

Type Parameters:
SENDER - type of sender
SETTINGS - type of platform settings
B - self type for builder
All Known Implementing Classes:
LiteCommandsBaseBuilder
public interface LiteCommandsBuilder<SENDER,SETTINGS extends dev.rollczi.litecommands.platform.PlatformSettings,B extends LiteCommandsBuilder<SENDER,SETTINGS,B>>
Builder for LiteCommands. Use LiteCommandsFactory.builder(Class, Platform) to create new instance of builder.

  • Method Summary

    Modifier and Type
    Method
    Description
    B
    annotations(LiteConfigurator<AnnotationsExtension<SENDER>> configurator)
    [Experimental] Register extension for annotations processing/ Please note that this method is experimental and may be deprecated or removed in the future.
    <T> B
    argument(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)
     
    <T> B
    argument(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)
     
    <T> B
    argument(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)
    [Keyed Argument Parser and Suggester] Register argument parser and suggester for a given type and key.
    <T> B
    argument(Class<T> type, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)
    [Argument Parser and Suggester] Register argument parser and suggester for given type.
    <T> B
    argumentParser(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.parser.Parser<SENDER,T> parser)
     
    <T> B
    argumentParser(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.parser.Parser<SENDER,T> parser)
     
    <T> B
    argumentParser(Class<T> type, dev.rollczi.litecommands.argument.parser.Parser<SENDER,T> parser)
     
    <T> B
    argumentSuggester(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.suggester.Suggester<SENDER,T> suggester)
     
    <T> B
    argumentSuggester(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.suggester.Suggester<SENDER,T> suggester)
     
    default <T> B
    argumentSuggester(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
    Deprecated.
    <T> B
    argumentSuggester(Class<T> type, dev.rollczi.litecommands.argument.suggester.Suggester<SENDER,T> suggester)
     
    default <T> B
    argumentSuggester(Class<T> type, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
    Deprecated.
    <T> B
    argumentSuggestion(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
     
    <T> B
    argumentSuggestion(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
     
    <T> B
    argumentSuggestion(Class<T> type, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
     
    <T> B
    bind(Class<T> on, dev.rollczi.litecommands.bind.BindProvider<T> bindProvider)
     
    <T> B
    bind(Class<T> on, Supplier<T> bind)
     
    B
    bindUnsafe(Class<?> on, Supplier<?> bind)
     
    dev.rollczi.litecommands.LiteCommands<SENDER>
    build()
     
    dev.rollczi.litecommands.LiteCommands<SENDER>
    build(boolean register)
     
    B
    commands(dev.rollczi.litecommands.LiteCommandsProvider<SENDER> commandsProvider)
    Register commands from given provider.
    B
    commands(Object... commands)
    This method is used to register additional commands.
    <T> B
    context(Class<T> on, dev.rollczi.litecommands.context.ContextProvider<SENDER,T> bind)
     
    B
    editor(dev.rollczi.litecommands.scope.Scope scope, dev.rollczi.litecommands.editor.Editor<SENDER> editor)
     
    B
    editorGlobal(dev.rollczi.litecommands.editor.Editor<SENDER> editor)
     
    <E extends Throwable>
    B
    exception(Class<E> exceptionType, dev.rollczi.litecommands.handler.exception.ExceptionHandler<SENDER,? extends E> handler)
     
    B
    exceptionUnexpected(dev.rollczi.litecommands.handler.exception.ExceptionHandler<SENDER,Throwable> handler)
     
    <CONFIGURATION>
    B
    extension(LiteExtension<SENDER,CONFIGURATION> extension)
    Register extension for this builder.
    <CONFIGURATION, E extends LiteExtension<SENDER, CONFIGURATION>>
    B
    extension(E extension, LiteConfigurator<CONFIGURATION> configurator)
    Register extension for this builder with configurator.
    B
    invalidUsage(dev.rollczi.litecommands.invalidusage.InvalidUsageHandler<SENDER> handler)
     
    <T, CONTEXT>
    B
    message(dev.rollczi.litecommands.message.MessageKey<CONTEXT> key, dev.rollczi.litecommands.message.InvokedMessage<SENDER,T,CONTEXT> message)
     
    <T, CONTEXT>
    B
    message(dev.rollczi.litecommands.message.MessageKey<CONTEXT> key, dev.rollczi.litecommands.message.Message<T,CONTEXT> message)
     
    <T, CONTEXT>
    B
    message(dev.rollczi.litecommands.message.MessageKey<CONTEXT> key, T message)
     
    B
    missingPermission(dev.rollczi.litecommands.permission.MissingPermissionsHandler<SENDER> handler)
     
    B
    postProcessor(LiteBuilderProcessor<SENDER,SETTINGS> postProcessor)
     
    B
    preProcessor(LiteBuilderProcessor<SENDER,SETTINGS> preProcessor)
     
    <T> B
    result(Class<T> resultType, dev.rollczi.litecommands.handler.result.ResultHandler<SENDER,? extends T> handler)
     
    B
    resultUnexpected(dev.rollczi.litecommands.handler.result.ResultHandler<SENDER,Object> handler)
     
    B
    scheduler(dev.rollczi.litecommands.scheduler.Scheduler scheduler)
     
    B
    schematicGenerator(dev.rollczi.litecommands.schematic.SchematicFormat format)
     
    B
    schematicGenerator(dev.rollczi.litecommands.schematic.SchematicGenerator<SENDER> schematicGenerator)
     
    B
    selfProcessor(LiteBuilderProcessor<SENDER,SETTINGS> processor)
     
    B
    settings(dev.rollczi.litecommands.platform.PlatformSettingsConfigurator<SETTINGS> configurator)
    Configure platform settings.
    B
    validator(dev.rollczi.litecommands.scope.Scope scope, dev.rollczi.litecommands.validator.Validator<SENDER> validator)
     
    B
    validatorGlobal(dev.rollczi.litecommands.validator.Validator<SENDER> validator)
     
    default B
    validatorMarked(dev.rollczi.litecommands.validator.Validator<SENDER> validator)
     
    B
    wrapper(dev.rollczi.litecommands.wrapper.Wrapper wrapper)
     

  • Method Details

    • settings

      B settings(dev.rollczi.litecommands.platform.PlatformSettingsConfigurator<SETTINGS> configurator)
      Configure platform settings.
      Parameters:
      configurator - configurator for platform settings
      Returns:
      this builder
      See Also:
      • PlatformSettings

    • commands

      B commands(dev.rollczi.litecommands.LiteCommandsProvider<SENDER> commandsProvider)
      Register commands from given provider.
      Parameters:
      commandsProvider - provider of commands
      Returns:
      this builder
      See Also:

    • commands

      @Experimental B commands(Object... commands)
      This method is used to register additional commands. There are several types of objects that can be registered: Using annotations:
      • An instance annotated with Command
      • An instance annotated with RootCommand
      • A class annotated with Command
      • A class annotated with RootCommand
      Programmatically:
      • An instance of LiteCommand
      Please note that this method is experimental and may be deprecated or removed in the future.
      Parameters:
      commands - commands to register
      Returns:
      This method returns the current LiteCommand builder instance This allows you to chain multiple calls together, using the builder design pattern.
      See Also:

    • argumentParser

      <T> B argumentParser(Class<T> type, dev.rollczi.litecommands.argument.parser.Parser<SENDER,T> parser)

    • argumentParser

      <T> B argumentParser(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.parser.Parser<SENDER,T> parser)

    • argumentParser

      <T> B argumentParser(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.parser.Parser<SENDER,T> parser)

    • argumentSuggestion

      <T> B argumentSuggestion(Class<T> type, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)

    • argumentSuggestion

      <T> B argumentSuggestion(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)

    • argumentSuggestion

      <T> B argumentSuggestion(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)

    • argumentSuggester

      @Deprecated @ScheduledForRemoval(inVersion="3.5.0") default <T> B argumentSuggester(Class<T> type, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
      Deprecated.

    • argumentSuggester

      @Deprecated @ScheduledForRemoval(inVersion="3.5.0") default <T> B argumentSuggester(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.suggestion.SuggestionResult suggestion)
      Deprecated.

    • argumentSuggester

      <T> B argumentSuggester(Class<T> type, dev.rollczi.litecommands.argument.suggester.Suggester<SENDER,T> suggester)

    • argumentSuggester

      <T> B argumentSuggester(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.suggester.Suggester<SENDER,T> suggester)

    • argumentSuggester

      <T> B argumentSuggester(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.suggester.Suggester<SENDER,T> suggester)

    • argument

      <T> B argument(Class<T> type, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)
      [Argument Parser and Suggester] Register argument parser and suggester for given type.
      Parameters:
      type - type of argument
      resolver - parser and suggester for a given type
      Returns:
      this builder

    • argument

      <T> B argument(Class<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)
      [Keyed Argument Parser and Suggester] Register argument parser and suggester for a given type and key. Key is used to define namespace for given parser. It is used to identify which parsers with same type should be used. Argument type is used to define what type is compatible with given parser.
      Parameters:
      type - type of argument
      key - key of argument
      resolver - parser and suggester for a given type
      Returns:
      this builder

    • argument

      <T> B argument(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)

    • argument

      <T> B argument(dev.rollczi.litecommands.reflect.type.TypeRange<T> type, dev.rollczi.litecommands.argument.ArgumentKey key, dev.rollczi.litecommands.argument.resolver.ArgumentResolverBase<SENDER,T> resolver)

    • context

      <T> B context(Class<T> on, dev.rollczi.litecommands.context.ContextProvider<SENDER,T> bind)

    • bind

      <T> B bind(Class<T> on, dev.rollczi.litecommands.bind.BindProvider<T> bindProvider)

    • bind

      <T> B bind(Class<T> on, Supplier<T> bind)

    • bindUnsafe

      B bindUnsafe(Class<?> on, Supplier<?> bind)

    • scheduler

      B scheduler(dev.rollczi.litecommands.scheduler.Scheduler scheduler)

    • message

      <T, CONTEXT> B message(dev.rollczi.litecommands.message.MessageKey<CONTEXT> key, dev.rollczi.litecommands.message.Message<T,CONTEXT> message)

    • message

      <T, CONTEXT> B message(dev.rollczi.litecommands.message.MessageKey<CONTEXT> key, dev.rollczi.litecommands.message.InvokedMessage<SENDER,T,CONTEXT> message)

    • message

      <T, CONTEXT> B message(dev.rollczi.litecommands.message.MessageKey<CONTEXT> key, T message)

    • editorGlobal

      B editorGlobal(dev.rollczi.litecommands.editor.Editor<SENDER> editor)

    • editor

      B editor(dev.rollczi.litecommands.scope.Scope scope, dev.rollczi.litecommands.editor.Editor<SENDER> editor)

    • validatorGlobal

      B validatorGlobal(dev.rollczi.litecommands.validator.Validator<SENDER> validator)

    • validator

      B validator(dev.rollczi.litecommands.scope.Scope scope, dev.rollczi.litecommands.validator.Validator<SENDER> validator)

    • validatorMarked

      default B validatorMarked(dev.rollczi.litecommands.validator.Validator<SENDER> validator)

    • result

      <T> B result(Class<T> resultType, dev.rollczi.litecommands.handler.result.ResultHandler<SENDER,? extends T> handler)

    • resultUnexpected

      B resultUnexpected(dev.rollczi.litecommands.handler.result.ResultHandler<SENDER,Object> handler)

    • exception

      <E extends Throwable> B exception(Class<E> exceptionType, dev.rollczi.litecommands.handler.exception.ExceptionHandler<SENDER,? extends E> handler)

    • exceptionUnexpected

      B exceptionUnexpected(dev.rollczi.litecommands.handler.exception.ExceptionHandler<SENDER,Throwable> handler)

    • missingPermission

      B missingPermission(dev.rollczi.litecommands.permission.MissingPermissionsHandler<SENDER> handler)

    • invalidUsage

      B invalidUsage(dev.rollczi.litecommands.invalidusage.InvalidUsageHandler<SENDER> handler)

    • wrapper

      B wrapper(dev.rollczi.litecommands.wrapper.Wrapper wrapper)

    • schematicGenerator

      B schematicGenerator(dev.rollczi.litecommands.schematic.SchematicGenerator<SENDER> schematicGenerator)

    • schematicGenerator

      B schematicGenerator(dev.rollczi.litecommands.schematic.SchematicFormat format)

    • selfProcessor

      B selfProcessor(LiteBuilderProcessor<SENDER,SETTINGS> processor)

    • preProcessor

      B preProcessor(LiteBuilderProcessor<SENDER,SETTINGS> preProcessor)

    • postProcessor

      B postProcessor(LiteBuilderProcessor<SENDER,SETTINGS> postProcessor)

    • extension

      <CONFIGURATION> B extension(LiteExtension<SENDER,CONFIGURATION> extension)
      Register extension for this builder.
      Type Parameters:
      CONFIGURATION - type of configuration
      Parameters:
      extension - extension to register Example: 
        
  .extension(new LiteAdventureExtension<>())
      Returns:
      this builder

    • extension

      <CONFIGURATION, E extends LiteExtension<SENDER, CONFIGURATION>> B extension(E extension, LiteConfigurator<CONFIGURATION> configurator)
      Register extension for this builder with configurator.
      Type Parameters:
      CONFIGURATION - type of configuration
      Parameters:
      extension - extension to register
      configurator - configurator for extension Example: 
        
  .extension(new LiteAdventureExtension<>(), configuration -> configuration
    .colorizeArgument(true)
    .miniMessage(true)
    .legacyColor(true)
    .serializer(ComponentSerializer.miniMessage())
  )
      Returns:
      this builder

    • annotations

      @Experimental B annotations(LiteConfigurator<AnnotationsExtension<SENDER>> configurator)
      [Experimental] Register extension for annotations processing/ Please note that this method is experimental and may be deprecated or removed in the future.
      Parameters:
      configurator - configurator for extension
      • processor - register new annotation processor
      • validator - register new validator for requirement
      Example: 
       
 .extensionAnnotation(extension -> extension
     .processor(new MyAnnotationProcessor())
     .validator(String.class, IsValid.class, new StringValidator())
 )
      Returns:
      this builder

    • build

      dev.rollczi.litecommands.LiteCommands<SENDER> build()

    • build

      dev.rollczi.litecommands.LiteCommands<SENDER> build(boolean register)