diff --git a/Plan/api/src/main/java/com/djrapitops/plan/extension/annotation/DoubleProvider.java b/Plan/api/src/main/java/com/djrapitops/plan/extension/annotation/DoubleProvider.java new file mode 100644 index 000000000..86aa49020 --- /dev/null +++ b/Plan/api/src/main/java/com/djrapitops/plan/extension/annotation/DoubleProvider.java @@ -0,0 +1,78 @@ +/* + * This file is part of Player Analytics (Plan). + * + * Plan is free software: you can redistribute it and/or modify + * it under the terms of the GNU Lesser General Public License v3 as published by + * the Free Software Foundation, either version 3 of the License, or + * (at your option) any later version. + * + * Plan is distributed in the hope that it will be useful, + * but WITHOUT ANY WARRANTY; without even the implied warranty of + * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the + * GNU Lesser General Public License for more details. + * + * You should have received a copy of the GNU Lesser General Public License + * along with Plan. If not, see . + */ +package com.djrapitops.plan.extension.annotation; + +import com.djrapitops.plan.extension.icon.Color; +import com.djrapitops.plan.extension.icon.Family; + +/** + * Method annotation to provide a double value about a Player. + *

+ * Usage: {@code @DoubleProvider double method(UUID playerUUID)} + * + * @author Rsl1122 + */ +public @interface DoubleProvider { + + /** + * Text displayed before the value, limited to 50 characters. + *

+ * Should inform the user what the value represents, for example + * "Distance from spawn", "Balance" + * + * @return String of max 50 characters, remainder will be clipped. + */ + String text(); + + /** + * 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: "Balance", description: "Economy balance of the player" + * + * @return String of max 150 characters, remainder will be clipped. + */ + String description() default ""; + + /** + * Name of Font Awesome icon. + *

+ * See https://fontawesome.com/icons?d=gallery&m=free for icons and their {@link Family}. + * + * @return Name of the icon, if name is not valid no icon is shown. + */ + String iconName() default "question"; + + /** + * Family of Font Awesome icon. + *

+ * See https://fontawesome.com/icons?d=gallery&m=free for icons and their {@link Family}. + * + * @return Family that matches an icon, if there is no icon for this family no icon is shown. + */ + Family iconFamily() default Family.SOLID; + + /** + * Color preference of the plugin. + *

+ * This color will be set as the default color to use for plugin's elements. + * + * @return Preferred color. If none are specified defaults are used. + */ + Color iconColor() default Color.NONE; + +}