Skip to content

feat(paper): document world config for chunk unloads #769

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
Rothes wants to merge 2 commits into
base: main
Choose a base branch
from
+17 −0
Open

feat(paper): document world config for chunk unloads #769

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
566cbe1
feat(paper): document world config for chunk unloads
Rothes Jun 4, 2026
63e0e9b
chore(paper): fix typo in world config for chunk unloads
Rothes Jun 4, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
17 changes: 17 additions & 0 deletions src/config/paper/paper-world-defaults.yml
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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 eligible chunks to unload each tick.

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"
description: >-
Expand Down