com.djrapitops.plan.extension.annotation

Annotation Type NumberProvider

@Retention(value=RUNTIME)
 @Target(value=METHOD)
public @interface NumberProvider

Method annotation to provide a long (64bit number) value about a Player.

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 and Description
java.lang.String	text Text displayed before the value, limited to 50 characters.

Optional Element Summary

Optional Elements

Modifier and Type	Optional Element and 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

public abstract 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

public abstract 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

public abstract 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

public abstract 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

public abstract 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

public abstract 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

public abstract 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

public abstract 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