From 566cbe108e631725a31276f86c84c63ba7946e48 Mon Sep 17 00:00:00 2001
From: Rothes <449181985@qq.com>
Date: Thu, 4 Jun 2026 08:49:55 +0800
Subject: [PATCH 1/2] feat(paper): document world config for chunk unloads

---
 src/config/paper/paper-world-defaults.yml | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/src/config/paper/paper-world-defaults.yml b/src/config/paper/paper-world-defaults.yml
index fd82ddeec..cf9cb4329 100644
--- a/src/config/paper/paper-world-defaults.yml
+++ b/src/config/paper/paper-world-defaults.yml
@@ -119,6 +119,23 @@ chunks:
     description: >-
       The maximum number of chunks the auto-save system will save in a single
       tick
+  min-chunk-unload-count:
+    vanilla: "2147483647"
+    default: "50"
+    description: >-
+      The minimum number of eligible chunks to unload each tick.
+      The chunks will unload from world chunk map, and save to disk asynchronously.
+
+      See min-chunk-unload-fraction for more.
+      Increasing these takes more tick time on chunk unloading, but may help with
+      memory usage in specific scenarios.
+  min-chunk-unload-fraction:
+    default: "0.05"
+    description: >-
+      The minimum fraction of chunks to unload each tick.
+
+      The final number of chunks unloads per tick is the maximum of
+      min-chunk-unload-count and eligible-chunks * min-chunk-unload-fraction.
   prevent-moving-into-unloaded-chunks:
     default: "false"
     description: >-

From 63e0e9bd64ae6011700506e5885a56ec589c9ece Mon Sep 17 00:00:00 2001
From: Rothes <449181985@qq.com>
Date: Thu, 4 Jun 2026 11:22:18 +0800
Subject: [PATCH 2/2] chore(paper): fix typo in world config for chunk unloads

---
 src/config/paper/paper-world-defaults.yml | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/src/config/paper/paper-world-defaults.yml b/src/config/paper/paper-world-defaults.yml
index cf9cb4329..1119456d5 100644
--- a/src/config/paper/paper-world-defaults.yml
+++ b/src/config/paper/paper-world-defaults.yml
@@ -132,9 +132,9 @@ chunks:
   min-chunk-unload-fraction:
     default: "0.05"
     description: >-
-      The minimum fraction of chunks to unload each tick.
+      The minimum fraction of eligible chunks to unload each tick.
 
-      The final number of chunks unloads per tick is the maximum of
+      The final number of chunk unloads per tick is the maximum of
       min-chunk-unload-count and eligible-chunks * min-chunk-unload-fraction.
   prevent-moving-into-unloaded-chunks:
     default: "false"