2022-09-24 07:19:05 +02:00
|
|
|
From 0000000000000000000000000000000000000000 Mon Sep 17 00:00:00 2001
|
|
|
|
From: BuildTools <46540330+willkroboth@users.noreply.github.com>
|
|
|
|
Date: Fri, 19 Aug 2022 16:11:51 -0400
|
|
|
|
Subject: [PATCH] Add method isTickingWorlds() to Bukkit.
|
|
|
|
|
|
|
|
|
|
|
|
diff --git a/src/main/java/org/bukkit/Bukkit.java b/src/main/java/org/bukkit/Bukkit.java
|
2024-05-16 02:06:59 +02:00
|
|
|
index 84d43e24a69352e2715935fd7ce3fd05aaca8601..49c027f2c78660594caa51341291b1bcd35b8993 100644
|
2022-09-24 07:19:05 +02:00
|
|
|
--- a/src/main/java/org/bukkit/Bukkit.java
|
|
|
|
+++ b/src/main/java/org/bukkit/Bukkit.java
|
2024-05-16 02:06:59 +02:00
|
|
|
@@ -805,12 +805,26 @@ public final class Bukkit {
|
2022-09-24 07:19:05 +02:00
|
|
|
return server.getWorlds();
|
|
|
|
}
|
|
|
|
|
|
|
|
+ // Paper start
|
|
|
|
+ /**
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * Gets whether the worlds are being ticked right now.
|
2022-09-24 07:19:05 +02:00
|
|
|
+ *
|
|
|
|
+ * @return true if the worlds are being ticked, false otherwise.
|
|
|
|
+ */
|
|
|
|
+ public static boolean isTickingWorlds(){
|
|
|
|
+ return server.isTickingWorlds();
|
|
|
|
+ }
|
|
|
|
+ // Paper end
|
|
|
|
+
|
|
|
|
/**
|
|
|
|
* Creates or loads a world with the given name using the specified
|
|
|
|
* options.
|
|
|
|
* <p>
|
|
|
|
* If the world is already loaded, it will just return the equivalent of
|
|
|
|
* getWorld(creator.name()).
|
|
|
|
+ * <p>
|
|
|
|
+ * Do note that un/loading worlds mid-tick may have potential side effects, we strongly recommend
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * ensuring that you're not un/loading worlds midtick by checking {@link Bukkit#isTickingWorlds()}
|
2022-09-24 07:19:05 +02:00
|
|
|
*
|
|
|
|
* @param creator the options to use when creating the world
|
|
|
|
* @return newly created or loaded world
|
2024-05-16 02:06:59 +02:00
|
|
|
@@ -822,6 +836,9 @@ public final class Bukkit {
|
2022-09-24 07:19:05 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Unloads a world with the given name.
|
|
|
|
+ * <p>
|
|
|
|
+ * Do note that un/loading worlds mid-tick may have potential side effects, we strongly recommend
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * ensuring that you're not un/loading worlds midtick by checking {@link Bukkit#isTickingWorlds()}
|
2022-09-24 07:19:05 +02:00
|
|
|
*
|
|
|
|
* @param name Name of the world to unload
|
|
|
|
* @param save whether to save the chunks before unloading
|
2024-05-16 02:06:59 +02:00
|
|
|
@@ -833,6 +850,9 @@ public final class Bukkit {
|
2022-09-24 07:19:05 +02:00
|
|
|
|
|
|
|
/**
|
|
|
|
* Unloads the given world.
|
|
|
|
+ * <p>
|
|
|
|
+ * Do note that un/loading worlds mid-tick may have potential side effects, we strongly recommend
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * ensuring that you're not un/loading worlds midtick by checking {@link Bukkit#isTickingWorlds()}
|
2022-09-24 07:19:05 +02:00
|
|
|
*
|
|
|
|
* @param world the world to unload
|
|
|
|
* @param save whether to save the chunks before unloading
|
|
|
|
diff --git a/src/main/java/org/bukkit/Server.java b/src/main/java/org/bukkit/Server.java
|
2024-05-11 23:48:37 +02:00
|
|
|
index 88ad9e596f801c2c137fe2d31653a841b9c01683..c1a46d13e61140c851f73f2ee7c6cec24ba8b3fa 100644
|
2022-09-24 07:19:05 +02:00
|
|
|
--- a/src/main/java/org/bukkit/Server.java
|
|
|
|
+++ b/src/main/java/org/bukkit/Server.java
|
2024-04-23 19:02:08 +02:00
|
|
|
@@ -675,34 +675,55 @@ public interface Server extends PluginMessageRecipient, net.kyori.adventure.audi
|
2022-09-24 07:19:05 +02:00
|
|
|
@NotNull
|
|
|
|
public List<World> getWorlds();
|
|
|
|
|
|
|
|
+ // Paper start
|
|
|
|
+ /**
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * Gets whether the worlds are being ticked right now.
|
2022-09-24 07:19:05 +02:00
|
|
|
+ *
|
|
|
|
+ * @return true if the worlds are being ticked, false otherwise.
|
|
|
|
+ */
|
|
|
|
+ public boolean isTickingWorlds();
|
|
|
|
+ // Paper end
|
|
|
|
+
|
|
|
|
/**
|
|
|
|
* Creates or loads a world with the given name using the specified
|
|
|
|
* options.
|
|
|
|
* <p>
|
|
|
|
* If the world is already loaded, it will just return the equivalent of
|
|
|
|
* getWorld(creator.name()).
|
|
|
|
+ * <p>
|
|
|
|
+ * Do note that un/loading worlds mid-tick may have potential side effects, we strongly recommend
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * ensuring that you're not un/loading worlds midtick by checking {@link Bukkit#isTickingWorlds()}
|
2022-09-24 07:19:05 +02:00
|
|
|
*
|
|
|
|
* @param creator the options to use when creating the world
|
|
|
|
* @return newly created or loaded world
|
|
|
|
+ * @throws IllegalStateException when {@link #isTickingWorlds() isTickingWorlds} is true
|
|
|
|
*/
|
|
|
|
@Nullable
|
|
|
|
public World createWorld(@NotNull WorldCreator creator);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Unloads a world with the given name.
|
|
|
|
+ * <p>
|
|
|
|
+ * Do note that un/loading worlds mid-tick may have potential side effects, we strongly recommend
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * ensuring that you're not un/loading worlds midtick by checking {@link Bukkit#isTickingWorlds()}
|
2022-09-24 07:19:05 +02:00
|
|
|
*
|
|
|
|
* @param name Name of the world to unload
|
|
|
|
* @param save whether to save the chunks before unloading
|
|
|
|
* @return true if successful, false otherwise
|
|
|
|
+ * @throws IllegalStateException when {@link #isTickingWorlds() isTickingWorlds} is true
|
|
|
|
*/
|
|
|
|
public boolean unloadWorld(@NotNull String name, boolean save);
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Unloads the given world.
|
|
|
|
+ * <p>
|
|
|
|
+ * Do note that un/loading worlds mid-tick may have potential side effects, we strongly recommend
|
2022-09-25 02:01:17 +02:00
|
|
|
+ * ensuring that you're not un/loading worlds midtick by checking {@link Bukkit#isTickingWorlds()}
|
2022-09-24 07:19:05 +02:00
|
|
|
*
|
|
|
|
* @param world the world to unload
|
|
|
|
* @param save whether to save the chunks before unloading
|
|
|
|
* @return true if successful, false otherwise
|
|
|
|
+ * @throws IllegalStateException when {@link #isTickingWorlds() isTickingWorlds} is true
|
|
|
|
*/
|
|
|
|
public boolean unloadWorld(@NotNull World world, boolean save);
|
|
|
|
|