From 3bd69f2e5699230894963252bed2d168fc3b8247 Mon Sep 17 00:00:00 2001
From: David <54660361+NonSwag@users.noreply.github.com>
Date: Mon, 10 Feb 2025 23:07:46 +0100
Subject: [PATCH] [ci skip] Enhance javadoc for World#setAutoSave method
 (#12088)

Clarify that disabling auto-save does not stop all saving operations. This addition explicitly mentions that the world will still save on shutdown and explains the intended purpose of the method.
---
 paper-api/src/main/java/org/bukkit/World.java | 2 ++
 1 file changed, 2 insertions(+)

diff --git a/paper-api/src/main/java/org/bukkit/World.java b/paper-api/src/main/java/org/bukkit/World.java
index 8784842d1..2729f71ac 100644
--- a/paper-api/src/main/java/org/bukkit/World.java
+++ b/paper-api/src/main/java/org/bukkit/World.java
@@ -2781,6 +2781,8 @@ public interface World extends RegionAccessor, WorldInfo, PluginMessageRecipient
      *
      * @param value true if the world should automatically save, otherwise
      *     false
+     * @apiNote This does not disable saving entirely, the world will still be saved on shutdown.<br>
+     * The intended use of this method is to disable the periodical autosave by the game.
      */
     public void setAutoSave(boolean value);