com.djrapitops.plan.extension.annotation

Annotation Type StringProvider

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

Method annotation to provide a String value about a Player.

Usage: @StringProvider String method(UUID playerUUID)

The returned value is limited to 100 characters, remainder will be clipped.

If the value is a player name, provide value for playerName=true. This will allow linking between pages.

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.
Color	iconColor Color preference of the plugin.
Family	iconFamily Family of Font Awesome icon.
java.lang.String	iconName Name of Font Awesome icon.
boolean	playerName Determine if this value represents a Player name, for example a mayor of a town.
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 "Town Name", "Pet Name"

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: "Power", description: "Faction power, affects ability of faction to perform actions. Regenerates"

Returns:

String of max 150 characters, remainder will be clipped.

Default:

""

playerName

public abstract boolean playerName

Determine if this value represents a Player name, for example a mayor of a town.

Returns:

true if the name can be used as a link to another player's page.

Default:

false

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