Ядро Paper: установка и настройка сервера

Коротко: скачайте jar-файл на papermc.io/downloads/paper, поставьте Java нужной версии (21 для Paper 1.20–1.21.11, 25 для 26.1 и новее), запустите java -Xms4G -Xmx4G -jar paper.jar --nogui, примите EULA в eula.txt и запустите снова. Настройки Paper — в папке config/, плагины — в plugins/.

Что такое Paper#

Paper — сервер для Minecraft: Java Edition от команды PaperMC. Он начинался как форк Spigot, а с 1.21.4 развивается самостоятельно и больше не подтягивает изменения Spigot. Файлы bukkit.yml и spigot.yml при этом остались и работают как раньше.

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

Какая Java нужна#

Память в -Xmx не задавайте впритык к лимиту тарифа: Java и системе нужен запас сверху, и документация Paper советует оставлять около 1–1,5 ГБ. Сколько памяти нужно под ваш онлайн — в статье сколько RAM нужно серверу.

Установка Paper по шагам#

1. 1

   Скачайте ядро

   На странице загрузок выберите версию Minecraft и нажмите на номер сборки. Старые сборки — в build explorer, ссылка там же. Качайте Paper только с официального сайта.

2. 2

   Подготовьте папку

   Создайте пустую папку сервера и положите туда jar. Удобно переименовать его в paper.jar, чтобы не менять скрипт запуска при каждом обновлении.

3. 3

   Запустите сервер

   Откройте терминал в этой папке и выполните команду ниже. -Xms и -Xmx задают память, --nogui отключает окно ванильного интерфейса. Готовый скрипт с рекомендованными флагами JVM соберёт генератор от PaperMC.

4. 4

   Примите EULA

   При первом запуске сервер создаст eula.txt и остановится. Прочитайте лицензионное соглашение Minecraft, поставьте eula=true и запустите сервер снова.

5. 5

   Проверьте

   Зайдите на сервер и выполните /version — команда покажет версию и сборку Paper. /plugins покажет плагины: зелёные работают, красные не загрузились.

java -Xms4G -Xmx4G -jar paper.jar --nogui

Если раньше сервер работал на Vanilla, просто замените jar: Paper сам переведёт мир в свой формат. Со Spigot на версиях до 26.1 Paper ставится без изменений, а начиная с 26.1 прямой переход невозможен — сначала мир переводят в формат Vanilla по инструкции Spigot.

Что где лежит#

Где лежит paper-world.yml, зависит от версии. На 1.21.x у каждого измерения своя папка в корне сервера: world/, world_nether/, world_the_end/. С 26.1 Paper хранит миры ближе к Vanilla: измерения лежат в world/dimensions/minecraft/ (overworld, the_nether, the_end), и paper-world.yml — в папке каждого из них.

Как работают настройки миров#

Значения по умолчанию лежат в config/paper-world-defaults.yml и действуют на все миры. Чтобы изменить что-то для одного мира, добавьте в его paper-world.yml только нужную строку. Не копируйте файл целиком: всё, чего в paper-world.yml нет, мир берёт из defaults.

entities:
  spawning:
    spawn-limits:
      monster: 90

Этот пример из документации Paper поднимает лимит монстров только в Незере (путь — для 26.x; на 1.21.x файл лежит в world_nether/). Остальные миры живут по умолчанию.

Настройки, которые стоит знать#

Из коробки Paper настроен разумно. Ниже — параметры, о которых чаще всего спрашивают; значения по умолчанию — из документации Paper. Меняйте по одному и проверяйте результат.

Профилирование: spark уже внутри#

С 1.21 Paper поставляется со встроенным профилировщиком spark. Запускайте его, пока лаги идут: через 10 минут spark пришлёт ссылку на отчёт. Старый Timings с 1.21 выключен по умолчанию, а с 1.21.3 его нельзя включить вовсе.

/spark profiler start --timeout 600

Что обычно оказывается причиной и как читать отчёт — в статье почему лагает сервер.

Как обновлять Paper#

С новыми сборками приходят исправления, поэтому PaperMC советует обновляться не реже раза в неделю. Порядок такой:

1. 1

   Бэкап

   Миры, конфиги сервера, плагины и их конфиги. Это самый важный и самый часто пропускаемый шаг.

2. 2

   Плагины — через папку update

   Создайте plugins/update и положите туда новые версии плагинов. При следующем перезапуске Paper заменит их сам — не нужно трогать jar-файлы на работающем сервере.

3. 3

   Новая сборка Paper

   Скачайте её, остановите сервер, замените старый jar новым с тем же именем и запустите.

4. 4

   Лог

   Следите за логом при старте: конфликты плагинов видны сразу.

Античит на Paper#

Paper — одна из двух платформ, для которых сделан DGuard (вторая — Leaf). Поддерживаются Paper версий 1.21–26.3. Основная — 1.21.11: на ней DGuard тестируется и работает на боевых серверах; остальные поддерживаются, но на боевых серверах ещё не проверялись.

Подключение — как у любого плагина: добавьте сервер в панели и получите ключ, положите в plugins/ последний релиз PacketEvents и DGuard.jar, вставьте ключ в plugins/DGuard/config.yml → license.key и перезапустите сервер. Проверки идут в сетевых потоках, а не в основном, поэтому TPS остаётся 20: на живом сервере DGuard занимает 0,03 % одного ядра на основном потоке.

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