paper-global.yml

Где лежит

В папке config сервера. Файл появляется сам после первого запуска сервера; если его нет — запустите сервер один раз и остановите. Полное описание — в документации PaperMC.

Главное

Ключ	По умолчанию	Что делает
velocity.enabled	`false`	Принимать ли игроков от прокси Velocity по современной пересылке.
velocity.secret	`пусто`	Общий секрет с Velocity — тот же, что в его файле forwarding.secret.
player-max-chunk-generate-rate	`-1.0`	Сколько чанков в секунду можно сгенерировать для одного игрока; -1 — без предела. Сдерживает тех, кто летит на элитрах в новые земли.
worker-threads	`-1`	Сколько потоков генерируют чанки; меньше нуля — подобрать по числу физических ядер.
max-joins-per-tick	`5`	Сколько игроков может войти за один тик; остальные подождут, их не выгонят.
allow-piston-duplication	`false`	Разрешить дюп динамита, ковров и рельсов поршнями.

Эти ключи меняют чаще всего: от них зависит нагрузка на сервер и то, что видят игроки.

anticheat

Ключ	По умолчанию	Что делает
`obfuscation.items.all-models.also-obfuscate`	`[]`	Какие компоненты всех предметов ещё прятать от других игроков.
`obfuscation.items.all-models.dont-obfuscate`	`[minecraft:lodestone_tracker]`	Какие компоненты всех предметов не прятать: от них зависит, как предмет выглядит.
`obfuscation.items.all-models.sanitize-count`	`true`	Прятать ли от других игроков число в стопке у всех предметов.
`obfuscation.items.enable-item-obfuscation`	`false`	Прятать от других игроков лишние данные предметов (чары, описание), которыми пользуются читы. Может сломать ресурспаки, зависящие от этих данных.
`obfuscation.items.model-overrides.minecraft:elytra.also-obfuscate`	`[]`	Какие компоненты предметов с этой моделью ещё прятать от других игроков.
`obfuscation.items.model-overrides.minecraft:elytra.dont-obfuscate`	`[minecraft:damage]`	Какие компоненты предметов с этой моделью не прятать: от них зависит, как предмет выглядит.
`obfuscation.items.model-overrides.minecraft:elytra.sanitize-count`	`true`	Прятать ли от других игроков число в стопке у предметов с этой моделью.

block-updates

Ключ	По умолчанию	Что делает
`disable-chorus-plant-updates`	`false`	Отключить обновления растений хоруса: они перестают менять вид от соседей. Так хранят в мире «неправильные» состояния — ими пользуются ресурспаки для своих блоков.
`disable-mushroom-block-updates`	`false`	Отключить обновления грибных блоков: они перестают менять вид от соседей. Так хранят в мире «неправильные» состояния — ими пользуются ресурспаки для своих блоков.
`disable-noteblock-updates`	`false`	Отключить обновления нотных блоков: они перестают менять вид от соседей. Так хранят в мире «неправильные» состояния — ими пользуются ресурспаки для своих блоков.
`disable-tripwire-updates`	`false`	Отключить обновления натяжной нити: они перестают менять вид от соседей. Так хранят в мире «неправильные» состояния — ими пользуются ресурспаки для своих блоков.

chunk-loading-advanced

Ключ	По умолчанию	Что делает
`auto-config-send-distance`	`true`	Отправлять игроку не больше чанков, чем стоит у него в настройках прорисовки.
`player-max-concurrent-chunk-generates`	`0`	Сколько чанков одновременно может генерироваться для одного игрока; 0 — подобрать самому, -1 — без предела.
`player-max-concurrent-chunk-loads`	`0`	Сколько чанков одновременно может грузиться для одного игрока; 0 — подобрать самому, -1 — без предела.

chunk-loading-basic

Ключ	По умолчанию	Что делает
`player-max-chunk-generate-rate`	`-1.0`	Сколько чанков в секунду можно сгенерировать для одного игрока; -1 — без предела. Сдерживает тех, кто летит на элитрах в новые земли.
`player-max-chunk-load-rate`	`100`	Сколько чанков в секунду можно загрузить для одного игрока; -1 — без предела.
`player-max-chunk-send-rate`	`75`	Сколько чанков в секунду отправлять одному игроку; -1 — без предела.

chunk-system

Ключ	По умолчанию	Что делает
`io-threads`	`-1`	Сколько потоков читают и пишут чанки на диск; меньше нуля — один поток.
`worker-threads`	`-1`	Сколько потоков генерируют чанки; меньше нуля — подобрать по числу физических ядер.

collisions

Ключ	По умолчанию	Что делает
`enable-player-collisions`	`true`	Толкаются ли игроки друг о друга. Плагины табло иногда это ломают.
`send-full-pos-for-hard-colliding-entities`	`true`	Отправлять точные позиции лодок и вагонеток, чтобы о них не спотыкались из-за рассинхрона.

commands

Ключ	По умолчанию	Что делает
`ride-command-allow-player-as-vehicle`	`false`	Разрешить в /ride сажать существ на игрока.
`suggest-player-names-when-null-tab-completions`	`true`в ванили: false	Подсказывать ники по Tab, если других подсказок нет.

console

Ключ	По умолчанию	Что делает
`enable-brigadier-completions`	`true`	Подсказки команд в консоли сервера.
`enable-brigadier-highlighting`	`true`	Подсветка команд в консоли сервера.
`has-all-permissions`	`false`	Есть ли у консоли все права плагинов.

item-validation

Ключ	По умолчанию	Что делает
`book.author`	`8192`в ванили: 2147483647	Предел длины автора книги в символах: длиннее сервер не примет — защита от предметов-крашеров.
`book.page`	`16384`в ванили: 2147483647	Предел длины страницы книги в символах: длиннее сервер не примет — защита от предметов-крашеров.
`book.title`	`8192`в ванили: 2147483647	Предел длины названия книги в символах: длиннее сервер не примет — защита от предметов-крашеров.
`book-size.page-max`	`2560`в ванили: disabled	Сколько байт может дать одна страница книги в общий предел; disabled — без своего предела Paper.
`book-size.total-multiplier`	`0.98`	Каждая следующая страница книги весит в общем пределе вот столько от предыдущей.
`display-name`	`8192`в ванили: 2147483647	Предел длины имени предмета в символах: длиннее сервер не примет — защита от предметов-крашеров.
`lore-line`	`8192`в ванили: 2147483647	Предел длины строки описания предмета в символах: длиннее сервер не примет — защита от предметов-крашеров.
`resolve-selectors-in-books`	`false`в ванили: true	Подставлять ли селекторы в книгах. Включённое позволяет игроку в творческом режиме уронить сервер.

messages

Ключ	По умолчанию	Что делает
`kick.authentication-servers-down`	`<lang:multiplayer.disconnect.authservers_down>`	Текст, с которым выгоняют когда серверы входа Mojang недоступны; оформление — MiniMessage.
`kick.connection-throttle`	`Connection throttled! Please wait before reconnecting.`	Текст, с которым выгоняют когда игрок переподключается слишком часто; оформление — MiniMessage.
`kick.flying-player`	`<lang:multiplayer.disconnect.flying>`	Текст, с которым выгоняют за полёт; оформление — MiniMessage.
`kick.flying-vehicle`	`<lang:multiplayer.disconnect.flying>`	Текст, с которым выгоняют за полёт на транспорте; оформление — MiniMessage.
`no-permission`	`<red>I'm sorry, but you do not have permission to perform this command. Please contact the server administrators if you believe that this is in error.`	Текст, когда у игрока нет прав на команду; оформление — MiniMessage.
`use-display-name-in-quit-message`	`false`	Писать ли в сообщении о выходе отображаемое имя от плагина, а не ник.

misc

Ключ	По умолчанию	Что делает
`catchup-ticks`	`default`	Сколько тиков сервер может нагнать ускорением после лага; default — 5, 0 — не нагонять.
`chat-threads.chat-executor-core-size`	`-1`	Сколько потоков постоянно обрабатывает чат.
`chat-threads.chat-executor-max-size`	`-1`	Сколько потоков чата может быть всего; 0 и меньше — без предела.
`client-interaction-leniency-distance`	`default`	Запас к дальности рук игрока при проверке взаимодействий — на лаг.
`compression-level`	`default`	Уровень сжатия сетевых пакетов; default — без своего уровня.
`enable-nether`	`true`	Загружать ли Незер.
`load-permissions-yml-before-plugins`	`true`	Загружать permissions.yml раньше плагинов.
`max-joins-per-tick`	`5`в ванили: 2147483647	Сколько игроков может войти за один тик; остальные подождут, их не выгонят.
`max-tracking-combat-entries`	`10240`в ванили: disabled	Сколько записей о бое помнить; старые забываются.
`prevent-negative-villager-demand`	`false`	Не давать спросу у жителей уходить в минус — так цены не падают бесконечно.
`region-file-cache-size`	`256`	Сколько файлов регионов держать открытыми.
`strict-advancement-dimension-check`	`false`	Не приравнивать свои миры к обычному миру, Незеру и Энду при проверке достижений.
`use-alternative-luck-formula`	`false`	Другая формула везения: удача влияет и на добычу без «качества». Сильно меняет рыбалку.
`use-dimension-type-for-custom-spawners`	`false`	Появляются ли фантомы и торговцы в своих мирах, похожих на обычный.
`xp-orb-groups-per-area`	`default`	Сколько групп шаров опыта одного номинала может лежать рядом; default — 40.

packet-limiter

Ключ	По умолчанию	Что делает
`all-packets.action`	`KICK`	Что делать с игроком, превысившим предел всех пакетов: KICK — выгнать, DROP — молча отбросить лишнее.
`all-packets.interval`	`7.0`в ванили: -1	За сколько секунд считается предел всех пакетов.
`all-packets.max-packet-rate`	`500.0`	Сколько всех пакетов игрок может прислать за интервал.
`kick-message`	`<red><lang:disconnect.exceeded_packet_rate>`	Текст, с которым выгоняет за слишком частые пакеты.
`overrides.minecraft:place_recipe.action`	`KICK`	Что делать с игроком, превысившим предел этого вида пакетов: KICK — выгнать, DROP — молча отбросить лишнее.
`overrides.minecraft:place_recipe.interval`	`7.0`в ванили: -1	За сколько секунд считается предел этого вида пакетов.
`overrides.minecraft:place_recipe.max-packet-rate`	`500.0`	Сколько этого вида пакетов игрок может прислать за интервал.

player-auto-save

Ключ	По умолчанию	Что делает
`max-per-tick`	`-1`	Скольких игроков сохранять за тик; -1 — подобрать самому.
`rate`	`-1`	Раз в сколько тиков сохранять игроков; -1 — как ticks-per.autosave в bukkit.yml.

proxies

Ключ	По умолчанию	Что делает
`bungee-cord.online-mode`	`true`	Проверяет ли лицензию прокси BungeeCord перед этим сервером — должно совпадать с настройкой прокси.
`proxy-protocol`	`false`	Принимать ли PROXY protocol — для HAProxy и похожих, к Velocity и BungeeCord отношения не имеет.
`velocity.enabled`	`false`	Принимать ли игроков от прокси Velocity по современной пересылке.
`velocity.online-mode`	`true`	Проверяет ли лицензию прокси Velocity — должно совпадать с настройкой прокси.
`velocity.secret`	`пусто`	Общий секрет с Velocity — тот же, что в его файле forwarding.secret.

scoreboards

Ключ	По умолчанию	Что делает
`save-empty-scoreboard-teams`	`true`	Сохранять ли пустые команды табло. Некоторые плагины плодят их сотнями, и вход замедляется.
`track-plugin-scoreboards`	`false`	Учитывать ли табло плагинов с пустыми счётами.

spam-limiter

Ключ	По умолчанию	Что делает
`incoming-packet-threshold`	`300`в ванили: disabled	После скольких пакетов считать входящий поток спамом и игнорировать.
`recipe-spam-increment`	`1`	На сколько растёт счётчик спама за нажатие на рецепт.
`recipe-spam-limit`	`20`	До скольки растёт счётчик рецептов, прежде чем игрока выгонят.
`tab-spam-increment`	`1`	На сколько растёт счётчик спама за нажатие Tab в чате.
`tab-spam-limit`	`500`	До скольки растёт счётчик Tab, прежде чем игрока выгонят.

spark

Ключ	По умолчанию	Что делает
`enable-immediately`	`false`	Включать встроенный профайлер spark ещё во время запуска сервера.
`enabled`	`true`	Включён ли встроенный профайлер spark.

time

Ключ	По умолчанию	Что делает
`affects-all-worlds`	`false`в ванили: true	Общие ли часы у всех миров: тогда /time меняет время везде, а не только в текущем мире.

unsupported-settings

Ключ	По умолчанию	Что делает
`allow-headless-pistons`	`false`в ванили: true	Разрешить поршни без головки — ими ломают бедрок.
`allow-permanent-block-break-exploits`	`false`в ванили: true	Разрешить ванильные способы ломать неразрушимое: бедрок, рамки портала в Энд.
`allow-piston-duplication`	`false`в ванили: true	Разрешить дюп динамита, ковров и рельсов поршнями.
`allow-unsafe-end-portal-teleportation`	`false`в ванили: true	Разрешить дюпы через портал в Энд, например песка.
`oversized-item-component-sanitizer.dont-sanitize`	`[]`в ванили: [minecraft:container, minecraft:charged_projectiles, minecraft:bundle_contents]	Какие данные предметов не урезать при защите от слишком больших предметов. Каждое исключение возвращает эксплойт.
`perform-username-validation`	`true`в ванили: false	Проверять ли ники на допустимые символы.
`skip-tripwire-hook-placement-validation`	`false`в ванили: true	Разрешить дюп через крюки натяжной нити.
`skip-vanilla-damage-tick-when-shield-blocked`	`false`	Не засчитывать неуязвимость после удара, отбитого щитом.
`update-equipment-on-player-actions`	`true`в ванили: false	Обновлять снаряжение при действиях игрока. false открывает обман атрибутов сменой предмета.

update-checker

Ключ	По умолчанию	Что делает
`enabled`	`true`	Проверять ли новые версии Paper при запуске.

watchdog

Ключ	По умолчанию	Что делает
`early-warning-delay`	`10000`	Через сколько миллисекунд зависания начинать печатать дампы потоков.
`early-warning-every`	`5000`	Как часто, в миллисекундах, печатать дампы, пока сервер висит.

Частые вопросы

Где лежит paper-global.yml?

В папке config сервера. Файл появляется после первого запуска сервера Paper или Paper.

Как применить изменения в paper-global.yml?

Сохраните файл и перезапустите сервер. Команда /reload применяет не всё и ломает плагины — надёжнее перезапуск.

Что в paper-global.yml влияет на нагрузку?

Сильнее всего — ключи из раздела «Главное» на этой странице: от них зависит, сколько мобов и чанков сервер обрабатывает за тик.

Другие файлы сервера

Все конфиги Конфиг server.properties Файл запуска сервера Документация PaperMC

Ключи и значения по умолчанию — из документации PaperMC для Paper 26.3; объяснения — редакции.

Коротко