fix: correct HTML entity references in JavaDoc comments

Author: ptthanh02

src/main/java/io/github/pluginlangcore/language/LanguageManager.java

@@ -21,6 +21,7 @@
  * Main language management system for Minecraft plugins.
  * <p>
  * This class provides comprehensive internationalization (i18n) support with features including:
+ * </p>
  * <ul>
  *   <li>Multiple language file types (messages, GUI, formatting, items)</li>
  *   <li>Automatic file creation and merging with defaults</li>
@@ -30,17 +31,11 @@
  *   <li>Entity and material name formatting</li>
  *   <li>Number formatting with locale-specific patterns</li>
  * </ul>
- * </p>
  * <p>
  * The LanguageManager supports multiple language file types through the {@link LanguageFileType} enum,
  * allowing for organized separation of different types of translatable content.
  * </p>
- *
- * @author PluginLangCore Team
- * @version 1.0.0
- * @since 1.0.0
- *
- * @example
+ * <b>Usage Example:</b>
  * <pre>{@code
  * // Basic initialization
  * LanguageManager langManager = new LanguageManager(plugin);
@@ -54,6 +49,10 @@
  * // Reload language files
  * langManager.reloadLanguages();
  * }</pre>
+ *
+ * @author PluginLangCore Team
+ * @version 1.0.0
+ * @since 1.0.0
  */
 public class LanguageManager {
     private final JavaPlugin plugin;
@@ -91,15 +90,13 @@ public class LanguageManager {
 
     /**
      * Enum representing the different language file types supported by the language manager.
-     * <p>
      * Each file type serves a specific purpose:
      * <ul>
      *   <li><b>MESSAGES</b> - Contains player messages, notifications, and command responses</li>
      *   <li><b>GUI</b> - Contains GUI titles, item names and lore for inventory interfaces</li>
      *   <li><b>FORMATTING</b> - Contains formatting rules for numbers, entity names, etc.</li>
      *   <li><b>ITEMS</b> - Contains vanilla and custom item names and lore</li>
      * </ul>
-     * </p>
      */
     @Getter
     public enum LanguageFileType {
@@ -132,15 +129,13 @@ public enum LanguageFileType {
 
     /**
      * Constructs a LanguageManager with all file types enabled.
-     * <p>
      * This constructor:
      * <ul>
      *   <li>Reads the default locale from plugin config (defaults to "en_US")</li>
      *   <li>Enables all language file types</li>
      *   <li>Initializes all caches with default capacities</li>
      *   <li>Loads and caches the default locale</li>
      * </ul>
-     * </p>
      *
      * @param plugin The JavaPlugin instance using this language manager
      */
@@ -158,7 +153,6 @@ public LanguageManager(JavaPlugin plugin) {
      * @param plugin    The JavaPlugin instance using this language manager
      * @param fileTypes Specific file types to load (e.g., only MESSAGES and GUI)
      *
-     * @example
      * <pre>{@code
      * // Only load messages and GUI files
      * LanguageManager langManager = new LanguageManager(
@@ -196,14 +190,12 @@ public LanguageManager(JavaPlugin plugin, LanguageFileType... fileTypes) {
 
     /**
      * Loads language files for the default locale.
-     * <p>
      * This method:
      * <ul>
      *   <li>Creates the language directory if it doesn't exist</li>
      *   <li>Loads all active file types for the default locale</li>
      *   <li>Merges default values with user configuration</li>
      * </ul>
-     * </p>
      */
     public void loadLanguages() {
         loadLanguages(activeFileTypes.toArray(new LanguageFileType[0]));
@@ -258,7 +250,6 @@ private void cacheDefaultLocaleData() {
      *   <li>Re-caches the default locale</li>
      * </ul>
      * Call this method after changing language files or the default locale.
-     * </p>
      */
     public void reloadLanguages() {
         // Clear all caches first to avoid using stale data
@@ -1053,7 +1044,6 @@ public List<String> getItemLoreWithMultilinePlaceholders(String key, Map<String,
      *   <li>1,000,000,000 → 1B</li>
      *   <li>1,000,000,000,000 → 1T</li>
      * </ul>
-     * </p>
      *
      * @param number The number to format
      * @return The formatted number string

src/main/java/io/github/pluginlangcore/language/LocaleData.java

@@ -13,22 +13,11 @@
  *   <li><b>formatting</b> - Number formatting, entity names, and text transformations</li>
  *   <li><b>items</b> - Vanilla and custom item names and lore</li>
  * </ul>
- * </p>
  * <p>
  * Being a record, this class is immutable and provides automatic implementations
  * of equals(), hashCode(), and toString() methods.
- * </p>
- *
- * @param messages   Configuration containing player messages and system notifications
- * @param gui        Configuration containing GUI-related text (titles, item names, lore)
- * @param formatting Configuration containing formatting rules for numbers, names, etc.
- * @param items      Configuration containing item names and lore definitions
- *
- * @author PluginLangCore Team
- * @version 1.0.0
- * @since 1.0.0
- *
- * @example
+ * <p>
+ * Example usage:
  * <pre>{@code
  * YamlConfiguration messages = YamlConfiguration.loadConfiguration(new File("messages.yml"));
  * YamlConfiguration gui = YamlConfiguration.loadConfiguration(new File("gui.yml"));
@@ -38,6 +27,15 @@
  * LocaleData localeData = new LocaleData(messages, gui, formatting, items);
  * String prefix = localeData.messages().getString("prefix");
  * }</pre>
+ *
+ * @param messages   Configuration containing player messages and system notifications
+ * @param gui        Configuration containing GUI-related text (titles, item names, lore)
+ * @param formatting Configuration containing formatting rules for numbers, names, etc.
+ * @param items      Configuration containing item names and lore definitions
+ *
+ * @author PluginLangCore Team
+ * @version 1.0.0
+ * @since 1.0.0
  */
 public record LocaleData(
         YamlConfiguration messages,

src/main/java/io/github/pluginlangcore/language/MessageService.java

@@ -25,17 +25,11 @@
  *   <li>Console logging with color stripping</li>
  *   <li>Placeholder replacement</li>
  * </ul>
- * </p>
  * <p>
  * The service caches key existence checks to improve performance and provides
  * methods for both player and console message delivery.
- * </p>
- *
- * @author PluginLangCore Team
- * @version 1.0.0
- * @since 1.0.0
- *
- * @example
+ * <p>
+ * Example usage:
  * <pre>{@code
  * LanguageManager langManager = new LanguageManager(plugin);
  * MessageService messageService = new MessageService(plugin, langManager);
@@ -51,6 +45,10 @@
  * // Send a console message
  * messageService.sendConsoleMessage("server_started");
  * }</pre>
+ *
+ * @author PluginLangCore Team
+ * @version 1.0.0
+ * @since 1.0.0
  */
 @RequiredArgsConstructor
 public class MessageService {
@@ -101,15 +99,13 @@ public void sendMessage(Player player, String key) {
 
     /**
      * Sends a message to a Player with placeholders.
-     * <p>
      * Automatically handles player-specific features:
      * <ul>
      *   <li>Chat messages</li>
      *   <li>Titles and subtitles</li>
      *   <li>Action bar messages</li>
      *   <li>Sound effects</li>
      * </ul>
-     * </p>
      *
      * @param player       The player to receive the message
      * @param key          The message key from the language files
@@ -131,7 +127,6 @@ public void sendMessage(Player player, String key, Map<String, String> placehold
      * @param key          The message key from the language files
      * @param placeholders Map of placeholders to replace in the message
      *
-     * @example
      * <pre>{@code
      * Map<String, String> placeholders = new HashMap<>();
      * placeholders.put("amount", "100");
@@ -203,18 +198,17 @@ public void sendConsoleMessage(String key) {
      * This method retrieves the message, applies placeholders, strips all
      * color codes, and logs it to the console. Useful for server logging
      * and administrative notifications.
-     * </p>
-     *
-     * @param key          The message key from the language files
-     * @param placeholders Map of placeholders to replace in the message
-     *
-     * @example
+     * <p>
+     * Example usage:
      * <pre>{@code
      * Map<String, String> placeholders = new HashMap<>();
      * placeholders.put("player", "Steve");
      * placeholders.put("reason", "Flying");
      * messageService.sendConsoleMessage("player_kicked", placeholders);
      * }</pre>
+     *
+     * @param key          The message key from the language files
+     * @param placeholders Map of placeholders to replace in the message
      */
     public void sendConsoleMessage(String key, Map<String, String> placeholders) {
         // Validate the message key exists

src/main/java/io/github/pluginlangcore/language/package-info.java

@@ -8,7 +8,6 @@
  *   <li>Player message delivery with titles, sounds, and action bars</li>
  *   <li>Console logging with color code stripping</li>
  * </ul>
- * </p>
  *
  * @see io.github.pluginlangcore.language.LanguageManager
  * @see io.github.pluginlangcore.language.MessageService

src/main/java/io/github/pluginlangcore/updater/LanguageUpdater.java

@@ -26,18 +26,12 @@
  *   <li>Support for multiple languages</li>
  *   <li>Smart detection of meaningful changes</li>
  * </ul>
- * </p>
  * <p>
  * The updater adds a {@code language_version} key to each language file to track versions.
  * When the plugin version increases, it automatically merges new keys while preserving
  * user modifications.
- * </p>
- *
- * @author PluginLangCore Team
- * @version 1.0.0
- * @since 1.0.0
- *
- * @example
+ * <p>
+ * Example usage:
  * <pre>{@code
  * public class MyPlugin extends JavaPlugin {
  *     @Override
@@ -55,6 +49,10 @@
  *     }
  * }
  * }</pre>
+ *
+ * @author PluginLangCore Team
+ * @version 1.0.0
+ * @since 1.0.0
  */
 public class LanguageUpdater {
     private final String currentVersion;
@@ -111,7 +109,6 @@ public enum LanguageFileType {
      * @param plugin             The JavaPlugin instance
      * @param supportedLanguages List of language codes to support (e.g., "en_US", "vi_VN")
      *
-     * @example
      * <pre>{@code
      * // Update all file types for English and Vietnamese
      * new LanguageUpdater(this, Arrays.asList("en_US", "vi_VN"));
@@ -126,13 +123,8 @@ public LanguageUpdater(JavaPlugin plugin, List<String> supportedLanguages) {
      * <p>
      * Use this constructor when you only want to update certain file types,
      * which can improve performance and reduce unnecessary file operations.
-     * </p>
-     *
-     * @param plugin             The JavaPlugin instance
-     * @param supportedLanguages List of language codes to support
-     * @param fileTypes          Specific file types to update
-     *
-     * @example
+     * <p>
+     * Example usage:
      * <pre>{@code
      * // Only update messages and GUI files
      * new LanguageUpdater(
@@ -142,6 +134,10 @@ public LanguageUpdater(JavaPlugin plugin, List<String> supportedLanguages) {
      *     LanguageFileType.GUI
      * );
      * }</pre>
+     *
+     * @param plugin             The JavaPlugin instance
+     * @param supportedLanguages List of language codes to support
+     * @param fileTypes          Specific file types to update
      */
     public LanguageUpdater(JavaPlugin plugin, List<String> supportedLanguages, LanguageFileType... fileTypes) {
         this.plugin = plugin;
@@ -153,7 +149,6 @@ public LanguageUpdater(JavaPlugin plugin, List<String> supportedLanguages, Langu
 
     /**
      * Checks and updates all language files for all supported languages.
-     * <p>
      * This method:
      * <ul>
      *   <li>Creates language directories if they don't exist</li>
@@ -162,11 +157,8 @@ public LanguageUpdater(JavaPlugin plugin, List<String> supportedLanguages, Langu
      *   <li>Preserves user customizations</li>
      *   <li>Creates backups when necessary</li>
      * </ul>
-     * </p>
-     * <p>
      * This method is called automatically in the constructor but can be called
      * manually to force a re-check and update.
-     * </p>
      */
     public void checkAndUpdateLanguageFiles() {
         for (String language : supportedLanguages) {
@@ -196,7 +188,6 @@ public void checkAndUpdateLanguageFiles() {
      *   <li>Merges new keys with user values</li>
      *   <li>Saves updated file</li>
      * </ol>
-     * </p>
      *
      * @param language     The language code (e.g., "en_US")
      * @param languageFile The file to update
@@ -366,12 +357,8 @@ private boolean hasConfigDifferences(Map<String, Object> userValues, FileConfigu
      * <p>
      * This method converts a nested YAML structure into a flat map where
      * keys are dot-separated paths and values are the leaf values.
-     * </p>
-     *
-     * @param config The configuration section to flatten
-     * @return A map of path to value
-     *
-     * @example
+     * <p>
+     * Example usage:
      * <pre>{@code
      * // YAML:
      * // player:
@@ -384,6 +371,9 @@ private boolean hasConfigDifferences(Map<String, Object> userValues, FileConfigu
      * //   "player.level": 5
      * // }
      * }</pre>
+     *
+     * @param config The configuration section to flatten
+     * @return A map of path to value
      */
     private Map<String, Object> flattenConfig(ConfigurationSection config) {
         Map<String, Object> result = new HashMap<>();