Package com.djrapitops.plan.extension.annotation

Annotation Interface ComponentProvider

@Retention(RUNTIME) @Target(METHOD) public @interface ComponentProvider
Method annotation to provide a Minecraft text Component value.

Usage: @ComponentProvider Component method(UUID playerUUID)

  • Required Element Summary

    Required Elements
    Modifier and Type
    Required Element
    Description
    String
    text
    Text displayed before the value, limited to 50 characters.

  • Optional Element Summary

    Optional Elements
    Modifier and Type
    Optional Element
    Description
    String
    description
    Text displayed when hovering over the value, limited to 150 characters.
    FormatType
    format
    Apply special formatting to the value before presentation.
    Color
    iconColor
    Color preference of the plugin.
    Family
    iconFamily
    Family of Font Awesome icon.
    String
    iconName
    Name of Font Awesome icon.
    int
    priority
    Display-priority of the value, highest value is placed top most.
    boolean
    showInPlayerTable
    When the parameter is set to true the value from this Provider is shown on a table alongside players.

  • Element Details

    • text

      String text
      Text displayed before the value, limited to 50 characters.

      Should inform the user what the value represents, for example "Owned Chickens", "Claimed Blocks"

      Returns:
      String of max 50 characters, remainder will be clipped.

    • priority

      int priority
      Display-priority of the value, highest value is placed top most.

      Two values with same priority may appear in a random order.

      Returns:
      Priority between 0 and Integer.MAX_VALUE.
      Default:
      0

    • description

      String description
      Text displayed when hovering over the value, limited to 150 characters.

      Should be used to clarify what the value is if not self evident, for example text: "Fished", description: "How long the player has fished for"

      Returns:
      String of max 150 characters, remainder will be clipped.
      Default:
      ""

    • format

      FormatType format
      Apply special formatting to the value before presentation.
      Returns:
      FormatType that best represents the long value.
      See Also:
      Default:
      NONE

    • iconName

      String iconName
      Name of Font Awesome icon.

      See https://fontawesome.com/icons (select 'free')) for icons and their Family.

      Returns:
      Name of the icon, if name is not valid no icon is shown.
      Default:
      "question"

    • iconFamily

      Family iconFamily
      Family of Font Awesome icon.

      See https://fontawesome.com/icons (select 'free')) for icons and their Family.

      Returns:
      Family that matches an icon, if there is no icon for this family no icon is shown.
      Default:
      SOLID

    • iconColor

      Color iconColor
      Color preference of the plugin.

      This color will be set as the default color to use for plugin's elements.

      Returns:
      Preferred color. If none are specified defaults are used.
      Default:
      NONE

    • showInPlayerTable

      boolean showInPlayerTable
      When the parameter is set to true the value from this Provider is shown on a table alongside players.
      Returns:
      false by default.
      Default:
      false