Установка ядра Paper на сервер

Как установить Paper на сервер Minecraft: выбор сборки, переход с vanilla и Spigot, флаги запуска, конфиги paper-global.yml и проверка после старта.

Ванильный сервер от Mojang честно делает своё дело, но на двадцати игроках начинает подтормаживать, а плагины к нему не подключить в принципе. Paper — форк Spigot с сотнями оптимизаций и собственными конфигами; на той же машине он держит заметно больше народа при тех же настройках. Установить Paper на сервер — обычно первое, что делают после запуска ванильного мира.

Ниже — весь путь: от выбора сборки до проверки, что ядро действительно поменялось.

Чем Paper отличается

Коротко по сути:

переписанные алгоритмы поиска пути мобов, света и обновления чанков;
асинхронная загрузка чанков — главный источник прироста TPS;
десятки настроек в своих конфигах, которых нет ни в ванилле, ни в Spigot;
совместимость с Bukkit/Spigot-плагинами почти стопроцентная;
патчи против дюпов и краш-эксплойтов, которые в ванилле живут месяцами.

Что Paper не умеет: запускать моды. Forge и Fabric — отдельная ветка, ставить их поверх Paper нельзя. Гибриды вроде Mohist существуют, но стабильность у них так себе.

Purpur — форк Paper с дополнительными настройками геймплея, ставится точно так же. Сравнение ядер разобрано в статье Paper, Spigot или Purpur.

Как установить Paper на сервер

Выберите сборку. На papermc.io сборки нумеруются: paper-1.21.4-208.jar. Берите последний стабильный билд для нужной версии игры. Экспериментальные сборки помечены явно — на боевом сервере им не место.
Остановите сервер и сделайте бэкап папки целиком, не только мира.
Загрузите .jar в корень сервера рядом с server.properties — через панель или по SFTP.
Укажите новое ядро в команде запуска. В панели хостинга это обычно поле «файл ядра» или выпадающий список версий. При ручном запуске — имя файла в строке java -jar.
Запустите и примите EULA, если сервер поднимается с нуля: в eula.txt поставьте eula=true.

Первый старт занимает дольше обычного: Paper конвертирует конфиги и создаёт свои файлы.

Строка запуска для ручного режима:

код

java -Xms4G -Xmx4G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions -XX:+DisableExplicitGC -XX:G1NewSizePercent=30 -XX:G1MaxNewSizePercent=40 -XX:G1HeapRegionSize=8M -jar paper.jar nogui

Это укороченный набор флагов Aikar — полная строка в документации PaperMC и в статье про флаги JVM. Ключевой момент — -Xms равен -Xmx: JVM не будет постоянно перевыделять память. И не ставьте хип больше, чем есть физической памяти минус пара гигабайт на систему.

Java нужна свежая: Paper 1.20.5+ требует Java 21, 1.18–1.20.4 работают на Java 17.

Переход с ванильного сервера

Мир и server.properties переносятся как есть, ничего конвертировать не нужно — Paper читает ванильный формат. Что изменится:

появятся папки plugins, cache, libraries, config;
в корне возникнут bukkit.yml, spigot.yml, а с 1.19 — config/paper-global.yml и config/paper-world-defaults.yml;
команды /plugins, /version и встроенный профайлер /spark начнут работать (Timings в Paper 1.21 отключён).

Датапаки продолжают работать без изменений, они лежат в world/datapacks — см. установку датапаков.

Обратный переход тоже возможен, но мир, побывавший на Paper, может содержать данные плагинов в NBT. Ванилла их просто проигнорирует.

Переход со Spigot

Здесь ещё проще: Paper — прямой потомок Spigot. Плагины, spigot.yml и bukkit.yml остаются на месте и продолжают действовать. Paper добавляет свои конфиги поверх, не заменяя старые.

Единственное, что стоит сделать после переезда, — пройтись по paper-world-defaults.yml. Там лежат настройки, ради которых всё и затевалось, но по умолчанию многие выставлены консервативно.

Что настроить сразу после установки

config/paper-global.yml — параметры для всего сервера:

код

chunk-loading-advanced:
  auto-config-send-distance: true
proxies:
  velocity:
    enabled: false

Секция proxies понадобится, если сервер работает за Velocity или BungeeCord.

config/paper-world-defaults.yml — то, что реально влияет на производительность:

код

chunks:
  max-auto-save-chunks-per-tick: 8
entities:
  spawning:
    despawn-ranges:
      monster:
        hard: 96
        soft: 28
  behavior:
    disable-chest-cat-detection: true
collisions:
  max-entity-collisions: 2

Уменьшение despawn-ranges и max-entity-collisions даёт самый заметный прирост на серверах с фермами. Полный разбор — в статьях про оптимизацию сервера и лимиты спавна мобов.

Проверка, что ядро сменилось

Команда /version в консоли или в игре должна вернуть что-то вроде:

код

This server is running Paper version 1.21.4-208-master@a1b2c3d (2026-08-14T10:22:31Z)

Если там CraftBukkit или Vanilla — сервер запускается со старым .jar. Проверьте команду старта: частая ошибка на своей машине — скрипт запуска, где имя файла осталось прежним.

Второй признак: наличие папки config и работающая команда /plugins.

Обновление сборок

Paper выпускает билды почти ежедневно. Гнаться за каждым не нужно, разумный ритм — раз в пару недель и обязательно после выхода фикса безопасности.

Порядок обновления в пределах одной версии игры (например, 1.21.4 build 190 → 208): остановить сервер, заменить .jar, запустить. Конфиги и мир не трогаются.

Порядок обновления версии игры (1.21 → 1.21.4): бэкап, замена .jar, проверка плагинов на совместимость, запуск. Мир обновится автоматически при первом старте, обратной дороги не будет. Подробнее — смена версии и ядра.

Частые ошибки

Unsupported class file major version или UnsupportedClassVersionError. Java старая. Ставьте 21 для свежих версий.

Сервер стартует, но плагины не грузятся. Папка plugins создаётся при первом старте Paper; если вы клали .jar до этого в другое место, они просто лежат мимо.

Мир не открывается после смены ядра. Версия Paper ниже версии, в которой мир сохранялся. Ядро должно быть не старше мира.

TPS не вырос. Значит, узкое место не в ядре. Ищите профайлером — Spark показывает, какой плагин или какая ферма съедает тик.

Коротко

Скачать свежий билд → положить в корень → указать в команде запуска → флаги Aikar → пройтись по paper-world-defaults.yml. Проверка одна: /version показывает Paper. После этого можно ставить плагины — начните с общей инструкции.

Если менять ядро хочется в один клик из панели — посмотрите тарифы TeaHost.