Improved javadoc and locale description for LIQUIDS_FLOWING_OUT

src/main/java/world/bentobox/bentobox/lists/Flags.java

@@ -273,7 +273,10 @@ public final class Flags {
             .listener(new ObsidianScoopingListener()).defaultSetting(true).build();
 
     /**
-     * Prevents liquids from flowing outside the protection range, in order to avoid cobblestone/stone/obsidian being generated and remaining unbreakable by players.
+     * Toggles whether liquids can flow outside an island's protection range or not.
+     * It is disabled by default in order to avoid cobblestone/stone/obsidian being generated outside an island's protection range and remaining unbreakable by players.
+     * Liquids will still flow vertically, however they won't spread horizontally if they're placed outside an island's protection range.
+     *
      * @since 1.3.0
      * @see LiquidsFlowingOutListener
      */

src/main/java/world/bentobox/bentobox/managers/FlagsManager.java

@@ -25,7 +25,9 @@ public class FlagsManager {
 
     /**
      * Stores the flag listeners that have already been registered into Bukkit's API to avoid duplicates.
-     * Value is true if the listener has been registered already
+     * Value is true if the listener has been registered already.
+     * This helps to make sure each flag listener is loaded correctly.
+     * @see #registerListeners()
      */
     private Map<@NonNull Listener, @NonNull Boolean> registeredListeners = new HashMap<>();
 

src/main/resources/locales/en-US.yml

@@ -661,6 +661,11 @@ protection:
         &aDisabling it helps avoiding lava and water
         &agenerating cobblestone in the area between
         &atwo islands.
+
+        &cNote that liquids will still flow vertically.
+        &cThey will also not spread horizontally if
+        &cthey are placed outside an island's
+        &cprotection range.
     LOCK: 
       description: "Toggle lock"
       name: "Lock island"