Adds support for modifying the tick rate

src/main/java/ch/njol/skript/bukkitutil/ServerUtils.java

@@ -0,0 +1,39 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.bukkitutil;
+
+import ch.njol.skript.Skript;
+import org.bukkit.Bukkit;
+import org.bukkit.ServerTickManager;
+
+public class ServerUtils {
+	private static final ServerTickManager SERVER_TICK_MANAGER;
+
+	static {
+		ServerTickManager STM_VALUE = null;
+		if (Skript.methodExists(Bukkit.class, "getServerTickManager")) {
+			STM_VALUE = Bukkit.getServerTickManager();
+		}
+		SERVER_TICK_MANAGER = STM_VALUE;
+	}
+
+	public static ServerTickManager getServerTickManager() {
+		return SERVER_TICK_MANAGER;
+	}
+}

src/main/java/ch/njol/skript/conditions/CondIsTickFrozen.java

@@ -0,0 +1,55 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.conditions;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.bukkitutil.ServerUtils;
+import ch.njol.skript.conditions.base.PropertyCondition;
+import ch.njol.skript.doc.Description;
+import ch.njol.skript.doc.Examples;
+import ch.njol.skript.doc.Name;
+import ch.njol.skript.doc.RequiredPlugins;
+import ch.njol.skript.doc.Since;
+import org.bukkit.Bukkit;
+import org.bukkit.entity.Entity;
+
+@Name("Is Entity Tick Frozen")
+@Description("Checks if the specified entities are frozen due to the server's ticking state.")
+@Examples({"if target entity is tick frozen:"})
+@Since("INSERT VERSION")
+@RequiredPlugins("Minecraft 1.20.4+")
+public class CondIsTickFrozen extends PropertyCondition<Entity> {
+
+
+	static {
+		if (Skript.methodExists(Bukkit.class, "getServerTickManager"))
+			register(CondIsTickFrozen.class, PropertyType.BE, "tick frozen", "entities");
+	}
+
+	@Override
+	public boolean check(Entity entity) {
+		return ServerUtils.getServerTickManager().isFrozen(entity);
+	}
+
+	@Override
+	protected String getPropertyName() {
+		return "tick frozen";
+	}
+}
+

src/main/java/ch/njol/skript/conditions/CondServerTickState.java

@@ -0,0 +1,91 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.conditions;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.bukkitutil.ServerUtils;
+import ch.njol.skript.doc.Description;
+import ch.njol.skript.doc.Examples;
+import ch.njol.skript.doc.Name;
+import ch.njol.skript.doc.RequiredPlugins;
+import ch.njol.skript.doc.Since;
+import ch.njol.skript.lang.Condition;
+import ch.njol.skript.lang.Expression;
+import ch.njol.skript.lang.SkriptParser.ParseResult;
+import ch.njol.util.Kleenean;
+import org.bukkit.Bukkit;
+import org.bukkit.ServerTickManager;
+import org.bukkit.event.Event;
+import org.eclipse.jdt.annotation.Nullable;
+
+import java.util.Locale;
+
+@Name("Server Tick State")
+@Description("Represents the ticking state of the server, for example, if the server is frozen, or running normally.")
+@Examples({"if server's tick state is currently frozen:", "if server tick state is normal:"})
+@Since("INSERT VERSION")
+@RequiredPlugins("Minecraft 1.20.4+")
+public class CondServerTickState extends Condition {
+	private ServerState state;
+
+	static {
+		if (Skript.methodExists(Bukkit.class, "getServerTickManager"))
+			Skript.registerCondition(CondServerTickState.class,
+				"[the] server['s] tick[ing] state is [currently] (:frozen|:stepping|:sprinting|:normal)",
+				"[the] server['s] tick[ing] state (is[n't| not]) [currently] (:frozen|:stepping|:sprinting|:normal)");
+	}
+
+	public enum ServerState {
+		FROZEN, STEPPING, SPRINTING, NORMAL
+	}
+
+
+	@Override
+	public boolean init(Expression<?>[] exprs, int matchedPattern, Kleenean isDelayed, ParseResult parseResult) {
+		if (!parseResult.tags.isEmpty()) {
+			String tag = parseResult.tags.get(0).toUpperCase(Locale.ENGLISH);
+			state = ServerState.valueOf(tag);
+		}
+		return true;
+	}
+
+
+
+	@Override
+	public boolean check(Event event) {
+		ServerTickManager serverTickManager = ServerUtils.getServerTickManager();
+		switch (state) {
+			case FROZEN:
+				return serverTickManager.isFrozen() != isNegated();
+			case STEPPING:
+				return serverTickManager.isStepping() != isNegated();
+			case SPRINTING:
+				return serverTickManager.isSprinting() != isNegated();
+			case NORMAL:
+				return serverTickManager.isRunningNormally() != isNegated();
+		}
+		return isNegated();
+	}
+
+	@Override
+	public String toString(@Nullable Event event, boolean debug) {
+		return "the server's tick state is " + state;
+	}
+}
+

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

@@ -0,0 +1,67 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.effects;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.bukkitutil.ServerUtils;
+import ch.njol.skript.doc.Description;
+import ch.njol.skript.doc.Examples;
+import ch.njol.skript.doc.Name;
+import ch.njol.skript.doc.RequiredPlugins;
+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;
+import org.bukkit.Bukkit;
+import org.bukkit.event.Event;
+import org.jetbrains.annotations.Nullable;
+@Name("Freeze/Unfreeze Server")
+@Description("Freezes or unfreezes the server.")
+@Examples({"freeze server", "unfreeze server"})
+@Since("INSERT VERSION")
+@RequiredPlugins("Minecraft 1.20.4+")
+public class EffFreezeServer extends Effect {
+
+
+	static {
+		if (Skript.methodExists(Bukkit.class, "getServerTickManager"))
+			Skript.registerEffect(EffFreezeServer.class,
+				"freeze [the] server",
+				"unfreeze [the] server");
+	}
+
+	private boolean freeze;
+
+	@Override
+	public boolean init(Expression<?>[] exprs, int matchedPattern, Kleenean isDelayed, ParseResult parseResult) {
+		freeze = matchedPattern == 0;
+		return true;
+	}
+
+	@Override
+	protected void execute(Event event) {
+		ServerUtils.getServerTickManager().setFrozen(freeze);
+	}
+
+	@Override
+	public String toString(@Nullable Event event, boolean debug) {
+		return freeze ? "freeze server" : "unfreeze server";
+	}
+}

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

@@ -0,0 +1,83 @@
+/**
+ *   This file is part of Skript.
+ *
+ *  Skript is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  Skript is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with Skript.  If not, see <http://www.gnu.org/licenses/>.
+ *
+ * Copyright Peter Güttinger, SkriptLang team and contributors
+ */
+package ch.njol.skript.effects;
+
+import ch.njol.skript.Skript;
+import ch.njol.skript.bukkitutil.ServerUtils;
+import ch.njol.skript.doc.RequiredPlugins;
+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.skript.util.Timespan;
+import ch.njol.skript.doc.Description;
+import ch.njol.skript.doc.Examples;
+import ch.njol.skript.doc.Name;
+import ch.njol.util.Kleenean;
+import org.bukkit.Bukkit;
+import org.bukkit.event.Event;
+import org.jetbrains.annotations.Nullable;
+
+@Name("Sprint Server")
+@Description({
+	"Requests the server to sprint for a certain amount of time, or stops the server from sprinting.",
+	"Sprinting is where the server increases the tick rate depending on the time you input, and resets the tick rate to what it was after it has finished sprinting."
+})
+@Examples({"request server to sprint for 10 seconds", "make server stop sprinting"})
+@Since("INSERT VERSION")
+@RequiredPlugins("Minecraft 1.20.4+")
+public class EffSprintServer extends Effect {
+
+
+	static {
+		if (Skript.methodExists(Bukkit.class, "getServerTickManager"))
+			Skript.registerEffect(EffSprintServer.class,
+				"request [for] [the] server [to] sprint for %timespan%",
+				"make [the] server stop sprinting");
+	}
+
+	private boolean sprint;
+	private Expression<Timespan> timespan;
+
+	@SuppressWarnings("unchecked")
+	@Override
+	public boolean init(Expression<?>[] exprs, int matchedPattern, Kleenean isDelayed, ParseResult parseResult) {
+		sprint = matchedPattern == 0;
+		if (sprint)
+			timespan = (Expression<Timespan>) exprs[0];
+		return true;
+	}
+
+	@Override
+	protected void execute(Event event) {
+		if (sprint) {
+			Timespan timespanInstance = timespan.getSingle(event);
+			long sprintTicks = timespanInstance != null ? timespanInstance.getTicks() : 1;
+			ServerUtils.getServerTickManager().requestGameToSprint((int) sprintTicks);
+		} else {
+			ServerUtils.getServerTickManager().stopSprinting();
+		}
+	}
+
+
+	@Override
+	public String toString(@Nullable Event event, boolean debug) {
+		return sprint ? "request to sprint server for" + timespan.toString(event, debug) : "stop sprinting server";
+	}
+}