diff --git a/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/MindustryCommandManager.java b/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/MindustryCommandManager.java index 5c473c98..a306c60a 100644 --- a/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/MindustryCommandManager.java +++ b/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/MindustryCommandManager.java @@ -76,9 +76,9 @@ public class MindustryCommandManager extends CommandManager /** * Constructs a new {@link MindustryCommandManager}. * - * @param plugin the owning plugin - * @param handler the command handler - * @param coordinator the execution coordinator + * @param plugin the owning plugin + * @param handler the command handler + * @param coordinator the execution coordinator * @param senderMapper the sender mapper * @see CommandManager#CommandManager(ExecutionCoordinator, CommandRegistrationHandler) */ diff --git a/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/parser/ContentParser.java b/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/parser/ContentParser.java index 0f229ae9..b04401fa 100644 --- a/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/parser/ContentParser.java +++ b/distributor-command-cloud/src/main/java/com/xpdustry/distributor/api/command/cloud/parser/ContentParser.java @@ -79,8 +79,8 @@ public static final class ContentParseException extends ParserException { /** * Creates a new {@link ContentParseException}. * - * @param input the input string - * @param ctx the command context + * @param input the input string + * @param ctx the command context * @param contentType the content type */ public ContentParseException(final CommandContext ctx, final String input, final CTypeKey contentType) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/DistributorProvider.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/DistributorProvider.java index dcab3405..b3728359 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/DistributorProvider.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/DistributorProvider.java @@ -31,6 +31,7 @@ private DistributorProvider() {} /** * Returns the global {@link Distributor} factory. + * * @throws IllegalStateException if the API hasn't been initialized yet */ public static Distributor get() { @@ -42,6 +43,7 @@ public static Distributor get() { /** * Sets the global {@link Distributor} factory. + * * @throws IllegalStateException if the API has already been initialized */ public static void set(final Distributor distributor) { @@ -53,6 +55,7 @@ public static void set(final Distributor distributor) { /** * Clears the global {@link Distributor} factory. + * * @throws IllegalStateException if the API hasn't been initialized yet */ public static void clear() { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/audience/Audience.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/audience/Audience.java index e339f9de..25dd351d 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/audience/Audience.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/audience/Audience.java @@ -84,9 +84,9 @@ default void sendMessage(final Component component) {} /** * Sends a message to this audience. * - * @param component the message + * @param component the message * @param unformatted the unformatted message - * @param sender the sender + * @param sender the sender */ default void sendMessage(final Component component, final Component unformatted, final Audience sender) {} @@ -113,7 +113,7 @@ default void hideHUDText() {} * Sends a notification to this audience. * * @param component the notification - * @param icon the icon + * @param icon the icon */ default void sendNotification(final Component component, final char icon) {} @@ -134,9 +134,9 @@ default void openURI(final URI uri) {} /** * Shows a label to this audience. * - * @param label the label - * @param x the x position in world coordinates - * @param y the y position in world coordinates + * @param label the label + * @param x the x position in world coordinates + * @param y the y position in world coordinates * @param duration the duration */ default void showLabel(final Component label, final float x, final float y, final Duration duration) {} @@ -144,7 +144,7 @@ default void showLabel(final Component label, final float x, final float y, fina /** * Kicks this audience from the server. * - * @param reason the reason + * @param reason the reason * @param duration the duration */ default void kick(final Component reason, final Duration duration) {} @@ -152,7 +152,7 @@ default void kick(final Component reason, final Duration duration) {} /** * Kicks this audience from the server. * - * @param reason the reason + * @param reason the reason * @param duration the duration */ default void kick(final Packets.KickReason reason, final Duration duration) {} diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandElement.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandElement.java index f4314d11..3c313bc8 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandElement.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandElement.java @@ -54,10 +54,10 @@ non-sealed interface Argument extends CommandElement { /** * Creates a new command argument. * - * @param name the name of the argument + * @param name the name of the argument * @param description the description of the argument - * @param aliases the aliases of the argument - * @param kind the kind of the argument + * @param aliases the aliases of the argument + * @param kind the kind of the argument * @return the created argument */ static Argument of( @@ -94,11 +94,11 @@ non-sealed interface Flag extends CommandElement { /** * Creates a new command flag. * - * @param name the name of the flag + * @param name the name of the flag * @param description the description of the flag - * @param aliases the aliases of the flag - * @param kind the kind of the flag - * @param mode the mode of the flag + * @param aliases the aliases of the flag + * @param kind the kind of the flag + * @param mode the mode of the flag * @return the created flag */ static Flag of( diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandFacade.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandFacade.java index bae3bd17..2611b64b 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandFacade.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandFacade.java @@ -77,7 +77,7 @@ static CommandFacade from(final CommandHandler.Command command) { * The result is affected by the permissions of the sender. * * @param sender the sender to get the help for - * @param query the query to get the help for + * @param query the query to get the help for * @return the help information for this command */ CommandHelp getHelp(final CommandSender sender, final String query); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandHelp.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandHelp.java index ea237081..cc6d6702 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandHelp.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/CommandHelp.java @@ -38,11 +38,11 @@ non-sealed interface Entry extends CommandHelp { /** * Creates a new command entry. * - * @param syntax the syntax of the command - * @param description the description of the command + * @param syntax the syntax of the command + * @param description the description of the command * @param verboseDescription the verbose description of the command - * @param arguments the arguments of the command - * @param flags the flags of the command + * @param arguments the arguments of the command + * @param flags the flags of the command */ static Entry of( final String syntax, @@ -90,7 +90,7 @@ non-sealed interface Suggestion extends CommandHelp { * Creates a new command suggestion. * * @param longestSharedPath the longest shared path of the suggestions - * @param childSuggestions the child suggestions + * @param childSuggestions the child suggestions */ static Suggestion of(final String longestSharedPath, final List childSuggestions) { return SuggestionImpl.of(longestSharedPath, childSuggestions); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionFacade.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionFacade.java index f10f92f7..7ad7c060 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionFacade.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionFacade.java @@ -45,7 +45,7 @@ static DescriptionFacade text(final String text) { * Creates a new translated description. * It uses distributor global translation system to translate the given key with either the input locale or the default locale. * - * @param key the translation key + * @param key the translation key * @param defaultLocale the default locale * @return the created translated description */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionMapper.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionMapper.java index b7d4685f..edfd3f6f 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionMapper.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/command/DescriptionMapper.java @@ -31,7 +31,7 @@ public interface DescriptionMapper { * Maps a describable object to a text description by extracting the text from it. * * @param extractor the function to extract the text from the describable object - * @param the type of the describable object + * @param the type of the describable object * @return the created description mapper */ static DescriptionMapper text(final Function extractor) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/ListComponent.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/ListComponent.java index bcd064e8..20fc9abd 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/ListComponent.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/ListComponent.java @@ -60,7 +60,7 @@ static ListComponent components(final Collection components) { /** * Creates a new list component with the specified text color and components. * - * @param textColor the text color + * @param textColor the text color * @param components the components * @return the list component */ @@ -71,7 +71,7 @@ static ListComponent components(final ComponentColor textColor, final Component. /** * Creates a new list component with the specified text color and components. * - * @param textColor the text color + * @param textColor the text color * @param components the components * @return the list component */ @@ -82,7 +82,7 @@ static ListComponent components(final ComponentColor textColor, final Collection /** * Creates a new list component with the specified text textStyle and components. * - * @param textStyle the text textStyle + * @param textStyle the text textStyle * @param components the components * @return the list component */ @@ -93,7 +93,7 @@ static ListComponent components(final TextStyle textStyle, final Component... co /** * Creates a new list component with the specified text textStyle and components. * - * @param textStyle the text textStyle + * @param textStyle the text textStyle * @param components the components * @return the list component */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/NumberComponent.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/NumberComponent.java index 67ce9f30..d0f77c41 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/NumberComponent.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/NumberComponent.java @@ -46,7 +46,7 @@ static NumberComponent number(final Number number) { /** * Creates a new number component with the specified number and text color. * - * @param number the number + * @param number the number * @param textColor the text color * @return the number component */ @@ -58,7 +58,7 @@ static NumberComponent number(final Number number, final ComponentColor textColo * Creates a new number component with the specified number and text textStyle. * * @param number the number - * @param style the text textStyle + * @param style the text textStyle * @return the number component */ static NumberComponent number(final Number number, final TextStyle style) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TemporalComponent.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TemporalComponent.java index e6656020..a55a2268 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TemporalComponent.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TemporalComponent.java @@ -41,7 +41,7 @@ static TemporalComponent.Builder temporal() { /** * Creates a new temporal component with the specified temporal value and temporal textStyle. * - * @param temporal the temporal value + * @param temporal the temporal value * @param temporalStyle the temporal textStyle * @return the temporal component */ @@ -52,9 +52,9 @@ static TemporalComponent temporal(final Temporal temporal, final TemporalStyle t /** * Creates a new temporal component with the specified temporal value, temporal textStyle, and text color. * - * @param temporal the temporal value + * @param temporal the temporal value * @param temporalStyle the temporal textStyle - * @param textColor the text color + * @param textColor the text color * @return the temporal component */ static TemporalComponent temporal( @@ -65,9 +65,9 @@ static TemporalComponent temporal( /** * Creates a new temporal component with the specified temporal value, temporal textStyle, and text textStyle. * - * @param temporal the temporal value + * @param temporal the temporal value * @param temporalStyle the temporal textStyle - * @param textStyle the text textStyle + * @param textStyle the text textStyle * @return the temporal component */ static TemporalComponent temporal( @@ -88,7 +88,7 @@ static TemporalComponent temporal(final Temporal temporal) { /** * Creates a new temporal component with the specified temporal value and text color. * - * @param temporal the temporal value + * @param temporal the temporal value * @param textColor the text color * @return the temporal component */ @@ -99,7 +99,7 @@ static TemporalComponent temporal(final Temporal temporal, final ComponentColor /** * Creates a new temporal component with the specified temporal value and text textStyle. * - * @param temporal the temporal value + * @param temporal the temporal value * @param textStyle the text textStyle * @return the temporal component */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TextComponent.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TextComponent.java index 0b2b2b29..4ec0c8d4 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TextComponent.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TextComponent.java @@ -46,7 +46,7 @@ static TextComponent text(final String content) { /** * Creates a new text component with the specified content and text color. * - * @param content the content + * @param content the content * @param textColor the text color * @return the text component */ @@ -57,7 +57,7 @@ static TextComponent text(final String content, final ComponentColor textColor) /** * Creates a new text component with the specified content and text textStyle. * - * @param content the content + * @param content the content * @param textStyle the text textStyle * @return the text component */ @@ -78,7 +78,7 @@ static TextComponent text(final char ch) { /** * Creates a new text component with the specified character and text color. * - * @param ch the character + * @param ch the character * @param textColor the text color * @return the text component */ @@ -89,7 +89,7 @@ static TextComponent text(final char ch, final ComponentColor textColor) { /** * Creates a new text component with the specified character and text textStyle. * - * @param ch the character + * @param ch the character * @param textStyle the text textStyle * @return the text component */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TranslatableComponent.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TranslatableComponent.java index efc1f84a..9bb49ec8 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TranslatableComponent.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/TranslatableComponent.java @@ -40,7 +40,7 @@ static TranslatableComponent.Builder translatable() { /** * Creates a new translatable component with the specified key and parameters. * - * @param key the key + * @param key the key * @param parameters the parameters * @return the translatable component */ @@ -51,9 +51,9 @@ static TranslatableComponent translatable(final String key, final TranslationArg /** * Creates a new translatable component with the specified key, parameters, and text color. * - * @param key the key + * @param key the key * @param parameters the parameters - * @param textColor the text color + * @param textColor the text color * @return the translatable component */ static TranslatableComponent translatable( @@ -64,9 +64,9 @@ static TranslatableComponent translatable( /** * Creates a new translatable component with the specified key, parameters, and text textStyle. * - * @param key the key + * @param key the key * @param parameters the parameters - * @param textStyle the text textStyle + * @param textStyle the text textStyle * @return the translatable component */ static TranslatableComponent translatable( @@ -87,7 +87,7 @@ static TranslatableComponent translatable(final String key) { /** * Creates a new translatable component with the specified key and text color. * - * @param key the key + * @param key the key * @param textColor the text color * @return the translatable component */ @@ -98,7 +98,7 @@ static TranslatableComponent translatable(final String key, final ComponentColor /** * Creates a new translatable component with the specified key and text textStyle. * - * @param key the key + * @param key the key * @param textStyle the text textStyle * @return the translatable component */ @@ -119,7 +119,7 @@ static TranslatableComponent translatable(final MappableContent content) { /** * Creates a new translatable component with the specified content and text color. * - * @param content the content + * @param content the content * @param textColor the text color * @return the translatable component */ @@ -130,7 +130,7 @@ static TranslatableComponent translatable(final MappableContent content, final C /** * Creates a new translatable component with the specified content and text textStyle. * - * @param content the content + * @param content the content * @param textStyle the text textStyle * @return the translatable component */ @@ -154,7 +154,7 @@ static TranslatableComponent translatable(final Team team) { /** * Creates a new translatable component with the specified team and text color. * - * @param team the team + * @param team the team * @param textColor the text color * @return the translatable component */ @@ -165,7 +165,7 @@ static TranslatableComponent translatable(final Team team, final ComponentColor /** * Creates a new translatable component with the specified team and text textStyle. * - * @param team the team + * @param team the team * @param textStyle the text textStyle * @return the translatable component */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRenderer.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRenderer.java index b7a297a4..96e10bc4 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRenderer.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRenderer.java @@ -39,7 +39,7 @@ static ComponentRenderer noop() { * Renders the specified component. * * @param component the component - * @param builder the component string builder + * @param builder the component string builder */ void render(final T component, final ComponentStringBuilder builder); } diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRendererProvider.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRendererProvider.java index b73c735a..2a48dd97 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRendererProvider.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentRendererProvider.java @@ -30,7 +30,7 @@ public interface ComponentRendererProvider { * Returns a renderer for the specified component. * * @param component the component - * @param the component type + * @param the component type * @return the renderer or {@code null} if no renderer is available */ @Nullable ComponentRenderer getRenderer(final T component); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentStringBuilder.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentStringBuilder.java index 9d88b0ea..e61e2cd6 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentStringBuilder.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/render/ComponentStringBuilder.java @@ -32,7 +32,7 @@ public interface ComponentStringBuilder extends Appendable { * Returns a plain component string builder. * Will not apply any text styles or colors. * - * @param context the context + * @param context the context * @param provider the component renderer provider * @return the plain component string builder */ @@ -60,7 +60,7 @@ static ComponentStringBuilder plain(final KeyContainer context) { *

* If a valid ANSI escape code is found in an appended text, it will be removed. * - * @param context the context + * @param context the context * @param provider the component renderer provider * @return the ANSI component string builder */ @@ -89,7 +89,7 @@ static ComponentStringBuilder ansi(final KeyContainer context) { *

* If an open square bracket is found in an appended text, it will be replaced with a double square bracket. * - * @param context the context + * @param context the context * @param provider the component renderer provider * @return the Mindustry component string builder */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/style/TextStyle.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/style/TextStyle.java index 221b38fd..8f3bc1a2 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/style/TextStyle.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/component/style/TextStyle.java @@ -41,8 +41,8 @@ static TextStyle of() { /** * Creates a new text style with the given colors and decorations. * - * @param textColor the text color - * @param backColor the background color + * @param textColor the text color + * @param backColor the background color * @param decorations the decorations * @return the text style */ @@ -163,7 +163,7 @@ default TextStyle addDecoration(final TextDecoration decoration) { * Sets a decoration state. If the state is {@link TriState#UNDEFINED}, the decoration is removed. * * @param decoration the decoration - * @param state the state + * @param state the state * @return a new text style with the given decoration state */ default TextStyle setDecoration(final TextDecoration decoration, final TriState state) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/Action.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/Action.java index d2a6a47e..a7e145ee 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/Action.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/Action.java @@ -157,7 +157,7 @@ static Action run(final Runnable runnable) { /** * Returns an action that invoke a command for the viewer. * - * @param name the command name + * @param name the command name * @param arguments the command arguments * @return the action */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/BiAction.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/BiAction.java index 0c52d5de..5a71a9a4 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/BiAction.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/gui/BiAction.java @@ -41,8 +41,8 @@ static BiAction from(final Action action) { /** * Returns a bi-action that sets a state entry with the bi-action input. * - * @param key the key - * @param the type of the value + * @param key the key + * @param the type of the value * @return the bi-action */ static BiAction with(final Key key) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/permission/MutablePermissionTree.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/permission/MutablePermissionTree.java index 55d55fe1..d99eaabd 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/permission/MutablePermissionTree.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/permission/MutablePermissionTree.java @@ -36,7 +36,7 @@ static MutablePermissionTree create() { * Sets the permission with the given state. * * @param permission the permission - * @param state the state + * @param state the state */ default void setPermission(final String permission, final boolean state) { setPermission(permission, state, false); @@ -46,8 +46,8 @@ default void setPermission(final String permission, final boolean state) { * Sets the permission with the given state. * * @param permission the permission - * @param state the state - * @param override whether to override the child permissions with the new state + * @param state the state + * @param override whether to override the child permissions with the new state */ void setPermission(final String permission, final boolean state, final boolean override); @@ -63,7 +63,7 @@ default void setPermissions(final PermissionTree tree) { /** * Sets the permissions from the given permission tree. * - * @param tree the permission tree + * @param tree the permission tree * @param override whether to override the child permissions with the new state */ default void setPermissions(final PermissionTree tree, final boolean override) { @@ -85,7 +85,7 @@ default void removePermission(final String permission) { * Removes the given permission from the tree. Essentially making it {@link TriState#UNDEFINED}. * * @param permission the permission - * @param all whether to remove all child permissions + * @param all whether to remove all child permissions */ void removePermission(final String permission, final boolean all); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/MUUID.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/MUUID.java index 903e3ed6..4775eeb2 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/MUUID.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/MUUID.java @@ -140,6 +140,7 @@ default byte[] getDecodedUsid() { /** * Converts the uuid of this muuid into a real {@link UUID}, version 8. + * * @see UUID v8 spec */ default UUID toRealUUID() { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/PlayerLookup.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/PlayerLookup.java index 53ddef83..e10b8c41 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/PlayerLookup.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/player/PlayerLookup.java @@ -57,7 +57,7 @@ default List findOnlinePlayers(final Query query) { * Finds online players matching the given query. * * @param players the players to search - * @param query the query + * @param query the query * @return the matching players */ List findOnlinePlayers(final Collection players, final Query query); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/service/ServiceManager.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/service/ServiceManager.java index f6997e0c..be9374a4 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/service/ServiceManager.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/service/ServiceManager.java @@ -32,11 +32,11 @@ public interface ServiceManager { /** * Registers the {@code instance} as one of the available implementations for the {@code service}. * - * @param plugin the plugin - * @param service the service + * @param plugin the plugin + * @param service the service * @param instance the instance * @param priority the priority - * @param the type of the service + * @param the type of the service */ default void register( final MindustryPlugin plugin, final Class service, final T instance, final Priority priority) { @@ -46,10 +46,10 @@ default void register( /** * Registers the {@code instance} as one of the available implementations for the {@code service}. * - * @param plugin the plugin - * @param service the service + * @param plugin the plugin + * @param service the service * @param instance the instance - * @param the type of the service + * @param the type of the service */ default void register(final MindustryPlugin plugin, final Class service, final T instance) { this.register(plugin, TypeToken.of(service), instance, Priority.NORMAL); @@ -58,11 +58,11 @@ default void register(final MindustryPlugin plugin, final Class service, /** * Registers the {@code instance} as one of the available implementations for the {@code service}. * - * @param plugin the plugin - * @param service the service + * @param plugin the plugin + * @param service the service * @param instance the instance * @param priority the priority - * @param the type of the service + * @param the type of the service */ void register( final MindustryPlugin plugin, final TypeToken service, final T instance, final Priority priority); @@ -70,10 +70,10 @@ void register( /** * Registers the {@code instance} as one of the available implementations for the {@code service}. * - * @param plugin the plugin - * @param service the service + * @param plugin the plugin + * @param service the service * @param instance the instance - * @param the type of the service + * @param the type of the service */ default void register(final MindustryPlugin plugin, final TypeToken service, final T instance) { this.register(plugin, service, instance, Priority.NORMAL); @@ -83,7 +83,7 @@ default void register(final MindustryPlugin plugin, final TypeToken servi * Provides a service of the given type. * * @param service the service - * @param the type of the service + * @param the type of the service * @return an implementation of the service or an empty optional if no implementation is found */ default Optional provide(final Class service) { @@ -94,7 +94,7 @@ default Optional provide(final Class service) { * Provides an instance of the given {@code service}. * * @param service the service - * @param the type of the service + * @param the type of the service * @return an implementation of the service or an empty optional if no implementation is found */ default Optional provide(final TypeToken service) { @@ -108,7 +108,7 @@ default Optional provide(final TypeToken service) { * Returns all providers of the given service. * * @param service the service - * @param the type of the service + * @param the type of the service * @return the providers */ default List> getProviders(final Class service) { @@ -119,7 +119,7 @@ default List> getProviders(final Class service) { * Returns all providers of the given service. * * @param service the service - * @param the type of the service + * @param the type of the service * @return the providers */ List> getProviders(final TypeToken service); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/BundleTranslationSource.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/BundleTranslationSource.java index ba2bc6a8..1bd06e1b 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/BundleTranslationSource.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/BundleTranslationSource.java @@ -44,7 +44,7 @@ static BundleTranslationSource create(final Locale defaultLocale) { /** * Registers a map of translations. * - * @param locale the locale of the translations + * @param locale the locale of the translations * @param translations the map * @throws IllegalArgumentException if a key is already registered */ @@ -64,7 +64,7 @@ default void registerAll(final ResourceBundle bundle) { /** * Registers the entries of the given resource bundle. * - * @param bundle the resource bundle + * @param bundle the resource bundle * @param extractor the function to extract {@link Translation} */ default void registerAll( @@ -84,8 +84,8 @@ default void registerAll(final Collection bundles) { /** * Registers the entries of the given resource bundles. * - * @param bundles the collection of resource bundles - * @param extractor the function to extract {@link Translation} + * @param bundles the collection of resource bundles + * @param extractor the function to extract {@link Translation} */ default void registerAll( final Collection bundles, final BiFunction extractor) { @@ -95,9 +95,9 @@ default void registerAll( /** * Registers a set of translations by using a mapper function to obtain each translation. * - * @param locale the locale of the translations - * @param keys the set of keys to register - * @param mapper the mapper function to obtain the translation + * @param locale the locale of the translations + * @param keys the set of keys to register + * @param mapper the mapper function to obtain the translation * @throws IllegalArgumentException if the key is already registered */ default void registerAll(final Locale locale, final Set keys, final Function mapper) { @@ -107,8 +107,8 @@ default void registerAll(final Locale locale, final Set keys, final Func /** * Registers a translation. * - * @param key the key of the translation - * @param locale the locale of the translation + * @param key the key of the translation + * @param locale the locale of the translation * @param translation the translation * @throws IllegalArgumentException if the key is already registered */ diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/MessageFormatTranslation.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/MessageFormatTranslation.java index 8e76883c..06932b5f 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/MessageFormatTranslation.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/MessageFormatTranslation.java @@ -30,7 +30,7 @@ public interface MessageFormatTranslation extends Translation { * The implementation returned by this method supports {@link com.xpdustry.distributor.api.component.render.ComponentStringBuilder}. * * @param pattern the pattern - * @param locale the locale + * @param locale the locale * @return the created message format translation */ static Translation of(final String pattern, final Locale locale) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/ResourceBundles.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/ResourceBundles.java index ee989001..e8f2fcee 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/ResourceBundles.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/ResourceBundles.java @@ -56,9 +56,9 @@ public static ResourceBundle fromFile(final Locale locale, final Path file) { /** * Loads resource bundles from a directory in the classpath. * - * @param caller the class of the caller + * @param caller the class of the caller * @param directory the path to the directory - * @param name the name of the bundle + * @param name the name of the bundle * @return the loaded resource bundles */ public static List fromClasspathDirectory( @@ -79,7 +79,7 @@ public static List fromClasspathDirectory( * Loads resource bundles from a directory. * * @param directory the path to the directory - * @param name the name of the bundle + * @param name the name of the bundle * @return the loaded resource bundles */ public static List fromDirectory(final Path directory, final String name) { @@ -94,9 +94,9 @@ public static List fromDirectory(final Path directory, final Str /** * Loads resource bundles from a zip file. * - * @param zip the path to the zip file + * @param zip the path to the zip file * @param directory the path to the directory - * @param name the name of the bundle + * @param name the name of the bundle * @return the loaded resource bundles */ public static List fromZipDirectory(final Path zip, final String directory, final String name) { diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/Translation.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/Translation.java index ed044d4d..a69f3abc 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/Translation.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/Translation.java @@ -37,7 +37,7 @@ public interface Translation { * Formats the translation to the given {@link ComponentStringBuilder}. * * @param parameters the translation parameters - * @param builder the builder + * @param builder the builder */ default void formatTo(final TranslationArguments parameters, final ComponentStringBuilder builder) { builder.append(format(parameters)); diff --git a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/TranslationSource.java b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/TranslationSource.java index b2ef0c74..0d7dd234 100644 --- a/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/TranslationSource.java +++ b/distributor-common-api/src/main/java/com/xpdustry/distributor/api/translation/TranslationSource.java @@ -45,8 +45,8 @@ static TranslationSource router() { /** * Returns a translation for the given key or a default translation if absent. * - * @param key the key - * @param locale the locale + * @param key the key + * @param locale the locale * @param fallback the fallback translation * @return the translation */ @@ -59,7 +59,7 @@ default Translation getTranslationOrDefault( /** * Returns a translation for the given key or a missing translation if absent. * - * @param key the key + * @param key the key * @param locale the locale * @return the translation */ diff --git a/distributor-permission-rank/src/main/java/com/xpdustry/distributor/api/permission/rank/EnumRankNode.java b/distributor-permission-rank/src/main/java/com/xpdustry/distributor/api/permission/rank/EnumRankNode.java index 5ec0264a..a89f4e05 100644 --- a/distributor-permission-rank/src/main/java/com/xpdustry/distributor/api/permission/rank/EnumRankNode.java +++ b/distributor-permission-rank/src/main/java/com/xpdustry/distributor/api/permission/rank/EnumRankNode.java @@ -34,10 +34,10 @@ public interface EnumRankNode> extends RankNode { *

  • descending, where the higher ordinal is the lower rank
  • * * - * @param value the rank value - * @param namespace the rank namespace - * @param ascending whether the enum ranks are in ascending order - * @param the enum type + * @param value the rank value + * @param namespace the rank namespace + * @param ascending whether the enum ranks are in ascending order + * @param the enum type * @return the created enum rank node */ static > RankNode linear(final E value, final String namespace, boolean ascending) { @@ -49,9 +49,9 @@ static > RankNode linear(final E value, final String namespace * This means each rank node is independent of each other. * Ideal for achievements based permissions. * - * @param value the rank value - * @param namespace the rank namespace - * @param the enum type + * @param value the rank value + * @param namespace the rank namespace + * @param the enum type * @return the created enum rank node */ static > RankNode singular(final E value, final String namespace) {