7.19.15

Author: Angeschossen

build.gradle.kts

@@ -1,5 +1,5 @@
 group = "com.github.angeschossen"
-version = "7.19.1"
+version = "7.19.15"
 description = "LandsAPI"
 
 plugins {

src/main/java/me/angeschossen/lands/api/levels/requirement/Requirement.java

@@ -51,6 +51,7 @@ public Requirement(@NotNull Plugin plugin, @NotNull String name, @NotNull String
 
     /**
      * Get the plugin that provides this requirement.
+     *
      * @return plugin that provides this requirement
      */
     @Override
@@ -60,6 +61,7 @@ public Requirement(@NotNull Plugin plugin, @NotNull String name, @NotNull String
 
     /**
      * Get the required value.
+     *
      * @return example: 4 hoppers placed
      */
     @Override
@@ -69,6 +71,7 @@ public final float getRequired() {
 
     /**
      * Get the progress percentage.
+     *
      * @param memberHolder land or nation
      * @return example: 50 because 2/4 required hoppers placed
      */
@@ -80,6 +83,7 @@ public String getProgressDisplay(@NotNull MemberHolder memberHolder) {
 
     /**
      * Get the progress in a numerical value.
+     *
      * @param memberHolder land or nation
      * @return numerical progress
      */
@@ -88,8 +92,17 @@ public final float getProgress(@NotNull MemberHolder memberHolder) {
         return (getValue(memberHolder) / required) * 100;
     }
 
+    public final boolean shouldRecalculateLevel(float previousValue, float currentValue) {
+        if (previousValue < required) {
+            return currentValue >= required;
+        } else {
+            return currentValue < required;
+        }
+    }
+
     /**
      * Check if this land or nation already fullfills this requirement.
+     *
      * @param memberHolder land or nation
      * @return true, if the land or nation already fullfills this requirement
      */
@@ -100,6 +113,7 @@ public boolean matches(@NotNull MemberHolder memberHolder) {
 
     /**
      * Get the description of this requirement.
+     *
      * @return used for menus
      */
     @Override
@@ -109,6 +123,7 @@ public boolean matches(@NotNull MemberHolder memberHolder) {
 
     /**
      * Get the unique name of this requirement. For display name, use {@link #getTitle()} instead.
+     *
      * @return unique name
      */
     @Override
@@ -119,6 +134,7 @@ public final String getName() {
 
     /**
      * Get the title of this requirement.
+     *
      * @return might include parsed color
      */
     @Override

src/main/java/me/angeschossen/lands/api/memberholder/MemberHolder.java

@@ -391,13 +391,14 @@ public interface MemberHolder extends BalanceHolder, ExpressionEntity, CMDTarget
     /**
      * Update the progress of a cached level requirement.
      *
-     * @param requirement   The identification of the requirement
-     * @param modify        Can be negative
-     * @param allowNegative Allow the result to be negative?
+     * @param requirement        the identification of the requirement
+     * @param modify             can be negative
+     * @param allowNegative      allow the result to be negative?
+     * @param levelRecalculation should the level be recalculated, if the requirement is met or no longer met
      * @return The result / progress value
      */
     @NotNull
-    CompletableFuture<@Nullable Float> modifyRequirementCache(@NotNull String requirement, float modify, boolean allowNegative);
+    CompletableFuture<@Nullable Float> modifyRequirementCache(@NotNull String requirement, float modify, boolean allowNegative, boolean levelRecalculation);
 
     /**
      * Remove an inbox message from the inbox.
@@ -448,6 +449,5 @@ public interface MemberHolder extends BalanceHolder, ExpressionEntity, CMDTarget
      * @param levelCalc   If the level should be recalculated after updating this requirement
      * @throws IllegalArgumentException If this requirement doesn't exist
      */
-    @Deprecated
     void updateRequirementCache(@NotNull String requirement, float val, boolean levelCalc) throws IllegalArgumentException;
 }