diff --git a/paper-api/src/main/java/org/bukkit/World.java b/paper-api/src/main/java/org/bukkit/World.java index 5ac1be9df..498a0e649 100644 --- a/paper-api/src/main/java/org/bukkit/World.java +++ b/paper-api/src/main/java/org/bukkit/World.java @@ -143,7 +143,11 @@ public interface World extends PluginMessageRecipient, Metadatable { public Chunk[] getLoadedChunks(); /** - * Loads the specified {@link Chunk} + * Loads the specified {@link Chunk}. + *

+ * This method will keep the specified chunk loaded until one of the + * unload methods is manually called. Callers are advised to instead use + * getChunkAt which will only temporarily load the requested chunk. * * @param chunk The chunk to load */ @@ -183,7 +187,11 @@ public interface World extends PluginMessageRecipient, Metadatable { public boolean isChunkInUse(int x, int z); /** - * Loads the {@link Chunk} at the specified coordinates + * Loads the {@link Chunk} at the specified coordinates. + *

+ * This method will keep the specified chunk loaded until one of the + * unload methods is manually called. Callers are advised to instead use + * getChunkAt which will only temporarily load the requested chunk. *

* If the chunk does not exist, it will be generated. *

@@ -196,7 +204,11 @@ public interface World extends PluginMessageRecipient, Metadatable { public void loadChunk(int x, int z); /** - * Loads the {@link Chunk} at the specified coordinates + * Loads the {@link Chunk} at the specified coordinates. + *

+ * This method will keep the specified chunk loaded until one of the + * unload methods is manually called. Callers are advised to instead use + * getChunkAt which will only temporarily load the requested chunk. * * @param x X-coordinate of the chunk * @param z Z-coordinate of the chunk