DeltaZern/zernmc-config/README.md

ZernMC configs

Тюнинг под профиль: 4 vCPU / 8 GB RAM, 15–25 игроков постоянно, пик 34, боевой сервер с плагином, который спавнит много Display/Marker сущностей и частиц (BlackKnife как референс).

Все файлы парциальные — Paper/Spigot дополняет недостающие ключи дефолтами, поэтому их можно копировать поверх существующих конфигов.

Куда класть

Файл	Путь на сервере
spigot.yml	<сервер>/spigot.yml
paper-world.yml	<сервер>/<мир>/paper-world.yml — у каждого мира свой
paper-global.yml	<сервер>/config/paper-global.yml
server.properties.patch	ключи из него в <сервер>/server.properties

Что где меняем и зачем

spigot.yml

• view-distance 8 / simulation-distance 5 — на 4 ядрах это самый ощутимый рычаг: симуляция шириной 10 стоит в разы дороже 5.
• entity-tracking-range.display 128 → 48 — главный фикс. Display, ItemDisplay, TextDisplay, Marker шлются игрокам пачками; при спаме боеспособностей 128 это десятки пакетов на тик.
• misc 96 → 48, other 64 → 32, animals/monsters 96 → 64, players 128 → 96 — то же, но по остальным типам.
• entity-activation-range — сужаем радиусы, в которых сущности вообще тикают; tick-inactive-villagers: false — самый частый выигрыш.
• ticks-per.hopper-check 1 → 8 — хопперы по умолчанию проверяются каждый тик, 8 экономит заметно и не ломает фермы.
• merge-radius.item 0.5 → 2.5 — меньше сущностей-дропа на земле.
• item-despawn-rate 6000 → 3000, arrow-despawn-rate 1200 → 300.
• mob-spawn-range 8 → 6, max-tnt-per-tick 100 → 30.

paper-world.yml

• misc.redstone-implementation: ALTERNATE_CURRENT — быстрее распространение редстоуна. Ломает 0-tick и двери-контры, предупредить игроков перед включением.
• tick-rates — рост травы, обновление контейнеров, спавнеры в 3 тика.
• collisions.max-entity-collisions 8 → 5.
• environment.disable-thunder, optimize-explosions, max-block-ticks/max-fluid-ticks пополам.
• hopper.disable-move-event: true — ломает плагины, слушающие InventoryMoveItemEvent (авто-сортировки, economy-логики).
• entities.spawning.spawn-limits — потолок мобов на чанк.

paper-global.yml

• chunk-system.worker-threads: 2 — самый недооценённый рычаг. auto (-1) на 4 ядрах даёт 1 воркер, и генерация чанков идёт последовательно: Moonrise делит availableProcessors пополам, а на результате 2 опускается до 1, оставляя место главному треду. Замерено: холодный старт 38.5 → 24.9 с, тёплый 16.4 → 12.2 с. Значение 3 — только с профилем, главному треду на 4 ядрах нужно дышать.
• chunk-system.io-threads: 2, gen-parallelism: true.
• chunk-loading.advanced.player-max-concurrent-chunk-loads/generates — защита от флуда генерацией при скоростном облёте. При ускорении генерации этот потолок надо поднимать, иначе движер быстрее, а ограничитель остался прежним.

Что НЕ трогаем

• Moonrise (чанковая система) — уже многопоточный, отдельный патч не нужен.
• wake-up-inactive.* — баланс, не перф.

JVM-флаги кучи (живут в start.sh, не в конфигах)

Эти флаги не переносятся копированием конфигов — они в скрипте запуска. Потеряются при переезде, поэтому дублируются здесь.

-XX:MaxHeapFreeRatio=30 -XX:MinHeapFreeRatio=10

Замер на сервере с миром 18 МБ, 0 игроков, после 100 с простоя:

	коммит	живые	RSS
без флагов	630 МБ	278 МБ	0.99 ГБ
с флагами	389 МБ	274 МБ	0.69 ГБ

Минус 300 МБ RSS на пустом сервере, без единого вызова GC вручную.

Почему работает. G1PeriodicGC гоняет Mixed/Remark каждые 15 с, но кучу почти никогда не сжимает: G1 сжимает только когда доля свободной памяти выше MaxHeapFreeRatio, а он по умолчанию 70. При 630 МБ коммита и 278 МБ живых свободно было 56% — ниже порога, поэтому 350 МБ коммита держались вечно и в RSS, и в физической памяти.

Отдельно проверено, что принудительный Full GC сам по себе не помогает: jcmd GC.run отработал, живые упали 289 → 248 МБ, а коммит остался на 725 МБ. То есть дело не в отсутствии Full GC, а именно в пороге.

Паузы при этом не ухудшились — то, что реально ест кадр в рантайме:

Pause Young (Mixed)	без флагов	с флагами
median	11.0 мс	9.8 мс
p95	28.3 мс	28.1 мс
max	38.1 мс	28.7 мс

Оговорка: concurrent-циклов стало больше (11 → 18), потому что куча меньше и G1 переполняет её чаще. Каждый такой цикл начинается с STW-паузы, и общий p95 по всем паузам в одном прогоне вырос (126 → 270 мс). Это замер на сервере без игроков, один прогон — под нагрузкой это надо перемерить, прежде чем считать флаг безопасным.

-XX:+DisableExplicitGC

Оставлен намеренно: System.gc() отключён, чтобы ни плагин, ни сторонний код не могли вызвать stop-the-world сборку в неподходящий момент. Именно поэтому освобождение кучи сделано флагом, а не вызовом GC.

Что будет, когда мир вырастет до 2–4 ГБ

Флаг этого не ломает. Он разрешает сжимать кучу, когда свободно больше 30%, и не мешает расти: при -Xmx4G G1 расширится сам, как только живых данных станет больше. Экономия в 300 МБ в основном на простое и при малом мире.

Порядок применения

1. Остановить сервер.
2. Скопировать файлы.
3. paper-world.yml положить в каждый мир: world/, world_nether/, world_the_end/.
4. Флаги кучи из раздела выше — в start.sh, вручную.
5. Старт → в логе не должно быть Error occurred while loading по этим файлам.
6. Проверить: /paper entity (tracking ranges), spark для TPS/MSPT.