Package com.djrapitops.plan.extension.annotation

Annotation Type NumberProvider

  • @Retention(RUNTIME)
@Target(METHOD)
public @interface NumberProvider
    Method annotation to provide a long (64bit number) value.

    If you want to return int values, use this provider with a long as return type of the method.

    Usage: @NumberProvider long method(UUID playerUUID)

    • Required Element Summary

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

    • Optional Element Summary

      Optional Elements 
      Modifier and Type Optional Element Description
      java.lang.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.
      java.lang.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 Detail

      • text

        java.lang.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

        java.lang.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:
        for available formatters.
        Default:
        com.djrapitops.plan.extension.FormatType.NONE

      • iconName

        java.lang.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:
        com.djrapitops.plan.extension.icon.Family.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:
        com.djrapitops.plan.extension.icon.Color.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