Add Detonate effect

src/main/java/ch/njol/skript/effects/EffDetonate.java

@@ -0,0 +1,62 @@
+package ch.njol.skript.effects;
+
+import org.bukkit.entity.*;
+import org.bukkit.entity.minecart.ExplosiveMinecart;
+import org.bukkit.event.Event;
+import org.jetbrains.annotations.Nullable;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.doc.Description;
+import ch.njol.skript.doc.Examples;
+import ch.njol.skript.doc.Name;
+import ch.njol.skript.doc.Since;
+import ch.njol.skript.lang.Effect;
+import ch.njol.skript.lang.Expression;
+import ch.njol.skript.lang.SkriptParser.ParseResult;
+import ch.njol.util.Kleenean;
+
+
+@Name("Detonate Entity")
+@Description("Immediately detonates an entity. Accepted entities are fireworks, TNT minecarts, wind charges and creepers.")
+@Examples("detonate last launched firework")
+@Since("INSERT VERSION")
+public class EffDetonate extends Effect {
+
+	static {
+		Skript.registerEffect(EffDetonate.class, "detonate %entities%");
+	}
+
+	private Expression<Entity> entities;
+
+	private static final boolean HAS_WINDCHARGE = Skript.classExists("org.bukkit.entity.WindCharge");
+
+	@Override
+	@SuppressWarnings("unchecked")
+	public boolean init(Expression<?>[] exprs, int matchedPattern, Kleenean isDelayed, ParseResult parseResult) {
+		this.entities = (Expression<Entity>) exprs[0];
+ 		return true;
+	}
+
+	@Override
+	protected void execute(Event event) {
+		for (Entity entity : entities.getArray(event)) {
+			if (entity instanceof Firework) {
+				((Firework) entity).detonate();
+			}
+			else if (HAS_WINDCHARGE && entity instanceof WindCharge) {
+				((WindCharge) entity).explode();
+			}
+			else if (entity instanceof ExplosiveMinecart) {
+				((ExplosiveMinecart) entity).explode();
+			}
+			else if (entity instanceof Creeper) {
+				((Creeper) entity).explode();
+			}
+		}
+	}
+
+	public String toString(@Nullable Event event, boolean debug) {
+		return "detonate " + entities.toString(event, debug);
+	}
+
+}

src/test/skript/tests/syntaxes/effects/EffDetonate.sk

@@ -0,0 +1,17 @@
+test "detonate entity effect":
+	spawn a creeper at event-location
+	assert last spawned entity is valid with "creepers should not detonate when they are first spawned"
+	detonate last spawned entity
+	assert last spawned entity isn't valid with "creepers should instantly detonate when spawned"
+
+test "detonate explosive minecart" when running minecraft "1.19":
+	spawn a minecart with tnt at event-location
+	assert last spawned entity is valid with "minecarts with tnt should not detonate when they are first spawned"
+	detonate last spawned entity
+	assert last spawned entity isn't valid with "minecarts with tnt should instantly detonate when they are first spawned"
+
+test "detonate wind charge" when running minecraft "1.21":
+	spawn a wind charge at event-location
+	assert last spawned entity is valid with "wind charges should not detonate when they are first spawned"
+	detonate last spawned entity
+	assert last spawned entity isn't valid with "wind charges should instantly detonate when spawned"