turns out it already existed and it just didn't have the keywords to come up in my search

Author: sovdeeth

src/main/java/ch/njol/skript/expressions/ExprDustedStage.java

@@ -15,30 +15,39 @@
 import org.jetbrains.annotations.Nullable;
 
 @Name("Dusted Stage")
-@Description({
-	"Represents how far the block has been uncovered.",
-	"The only blocks that can currently be \"dusted\" are Suspicious Gravel and Suspicious Sand."
-})
-@Example("send target block's maximum dusted stage")
-@Example("set {_sand}'s dusted stage to 2")
+@Description("""
+	Represents how far the block has been uncovered.
+	The only blocks that can currently be "dusted" are Suspicious Gravel and Suspicious Sand.
+	0 means the block is untouched, the max (usually 3) means nearly fulled brushed.
+	Resetting this value will set it to 0.
+	""")
+@Example("""
+	# prevent dusting past level 1
+	on player change block:
+		if dusting progress of future event-blockdata > 1:
+			cancel event
+	""")
+@Example("""
+	# draw particles when dusting is complete!
+	on player change block:
+		if dusting progress of event-block is max dusting progress of event-block:
+			draw 20 totem of undying particles at event-block
+	""")
 @Since("2.12")
-@RequiredPlugins("Minecraft 1.20+")
+@Keywords({"brush", "brushing", "dusting"})
 public class ExprDustedStage extends PropertyExpression<Object, Integer> {
 
-	private static final boolean SUPPORTS_DUSTING = Skript.classExists("org.bukkit.block.data.Brushable");
-
 	static {
-		if (SUPPORTS_DUSTING)
-			register(ExprDustedStage.class, Integer.class,
-				"[:max[imum]] dust[ed|ing] (value|stage|progress[ion])",
-				"blocks/blockdatas");
+		register(ExprDustedStage.class, Integer.class,
+			"[:max[imum]] dust[ed|ing] (value|stage|progress[ion])",
+			"blocks/blockdatas");
 	}
 
 	private boolean isMax;
 
 	@Override
 	public boolean init(Expression<?>[] exprs, int matchedPattern, Kleenean isDelayed, ParseResult parseResult) {
-		setExpr((Expression<Block>) exprs[0]);
+		setExpr(exprs[0]);
 		isMax = parseResult.hasTag("max");
 		return true;
 	}
@@ -70,7 +79,7 @@ public boolean init(Expression<?>[] exprs, int matchedPattern, Kleenean isDelaye
 	@Override
 	public void change(Event event, Object @Nullable [] delta, ChangeMode mode) {
 		if (isMax) return;
-		Integer value = (delta != null && delta.length > 0) ? (Integer) delta[0] : null;
+		int value = (delta != null && delta.length > 0) ? (Integer) delta[0] : 0;
 
 		for (Object obj : getExpr().getArray(event)) {
 			Brushable brushable = getBrushable(obj);
@@ -79,35 +88,15 @@ public void change(Event event, Object @Nullable [] delta, ChangeMode mode) {
 
 			int currentValue = brushable.getDusted();
 			int maxValue = brushable.getMaximumDusted();
-			int newValue = currentValue;
-
-			switch (mode) {
-				case SET -> {
-					if (value != null) {
-						newValue = value;
-					}
-				}
-				case ADD -> {
-					if (value != null) {
-						newValue = currentValue + value;
-					}
-				}
-				case REMOVE -> {
-					if (value != null) {
-						newValue = currentValue - value;
-					}
-				}
-				case RESET -> newValue = 0;
-				default -> {
-					return;
-				}
-			}
-
-			newValue = Math.max(0, Math.min(newValue, maxValue));
-
-			brushable.setDusted(newValue);
-			if (obj instanceof Block) {
-				((Block) obj).setBlockData(brushable);
+			int newValue = switch (mode) {
+				case SET, RESET -> value;
+				case ADD -> currentValue + value;
+				case REMOVE -> currentValue - value;
+				default -> throw new IllegalArgumentException("Change mode " + mode + " is not valid for ExprDustedStage!");
+			};
+			brushable.setDusted( Math.clamp(newValue, 0, maxValue));
+			if (obj instanceof Block block) {
+				block.setBlockData(brushable);
 			}
 		}
 	}
@@ -116,15 +105,14 @@ public void change(Event event, Object @Nullable [] delta, ChangeMode mode) {
 	private Brushable getBrushable(Object obj) {
 		if (obj instanceof Block block) {
 			BlockData blockData = block.getBlockData();
-			if (blockData instanceof Brushable)
-				return (Brushable) blockData;
+			if (blockData instanceof Brushable brushable)
+				return brushable;
 		} else if (obj instanceof Brushable brushable) {
 			return brushable;
 		}
 		return null;
 	}
 
-
 	@Override
 	public Class<? extends Integer> getReturnType() {
 		return Integer.class;

src/main/java/org/skriptlang/skript/bukkit/misc/MiscModule.java

@@ -2,7 +2,6 @@
 
 import org.skriptlang.skript.addon.AddonModule;
 import org.skriptlang.skript.addon.SkriptAddon;
-import org.skriptlang.skript.bukkit.misc.expressions.ExprDustingProgress;
 import org.skriptlang.skript.bukkit.misc.expressions.ExprWithYawPitch;
 import org.skriptlang.skript.registration.SyntaxRegistry;
 
@@ -12,7 +11,6 @@ public class MiscModule implements AddonModule {
 	public void load(SkriptAddon addon) {
 		SyntaxRegistry registry = addon.syntaxRegistry();
 		ExprWithYawPitch.register(registry);
-		ExprDustingProgress.register(registry);
 	}
 
 	@Override

src/main/java/org/skriptlang/skript/bukkit/misc/expressions/ExprDustingProgress.java

@@ -43,11 +43,4 @@ test "dusting progress" when running minecraft "1.20":
 	set dusting progress of {_blockdata} to 2
 	assert dusting progress of {_blockdata} is 2 with "Failed to set dusting progress on blockdata"
 
-	# test alternative syntax (excavation)
-	set block at test-block to suspicious sand
-	set {_sand} to block at test-block
-	set excavation progress of {_sand} to 1
-	assert excavation progress of {_sand} is 1 with "Failed to set excavation progress"
-	assert max excavation progress of {_sand} is 3 with "Max excavation progress should be 3"
-
 	set block data of test-block to {_old}