From 9c8943fa512f54bad4ae91bbc3ae3409a897d5e9 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Matou=C5=A1=20Ku=C4=8Dera?= Date: Sat, 24 Aug 2024 09:00:24 +0200 Subject: [PATCH] fix: wrong worker thread count description (#471) --- config-specs/paper/paper-global.yml | 11 ++++++----- docs/paper/admin/reference/system-properties.md | 4 ++-- 2 files changed, 8 insertions(+), 7 deletions(-) diff --git a/config-specs/paper/paper-global.yml b/config-specs/paper/paper-global.yml index f826f045..a039c28c 100644 --- a/config-specs/paper/paper-global.yml +++ b/config-specs/paper/paper-global.yml @@ -65,11 +65,12 @@ chunk-system: worker-threads: default: "-1" description: >- - Sets the number of threads to be used for parallel chunk generation. If - any value below zero is set, the server will determine the best number - depending on the number of available CPU cores. This is capped at a - quarter of available processors and can be less for systems with very few - processors. _(Note: Hyper-Threaded threads **do not** count)_. + Sets the number of threads to be used for parallel chunk generation. + If a value below zero is set, the server will automatically determine the + optimal number of threads based on the available physical CPU cores + (**not logical cores**). For systems with 3 or fewer physical cores, + only 1 thread will be used. In all other cases, the number of threads + is capped at half of the physical cores. collisions: enable-player-collisions: default: "true" diff --git a/docs/paper/admin/reference/system-properties.md b/docs/paper/admin/reference/system-properties.md index 1eed02e5..6b1f0e8b 100644 --- a/docs/paper/admin/reference/system-properties.md +++ b/docs/paper/admin/reference/system-properties.md @@ -153,8 +153,8 @@ It also remaps plugin CB calls to remove the version information. #### Paper.WorkerThreadCount: -- **default**: `8` or `number of cpus - 2`. Whichever is lower -- **description**: Sets the number of worker threads to use for chunk loading. +- **default**: half of available physical (**not logical**) cores or `1` if 3 or fewer cores are available +- **description**: Sets the number of worker threads to use for chunk loading. See [here](./configuration/global-configuration.mdx#chunk_system_worker_threads) for more info. #### Paper.excessiveTELimit: