Как установить Paper на Minecraft-сервер
Paper: сервер Minecraft Java Edition с поддержкой Bukkit/Spigot/Paper-плагинов. Эта инструкция рассчитана на чистую установку или замену совместимого ядра на остановленном сервере.
Перед установкой: сохраните данные
Если на сервере уже есть мир, сначала остановите его и скачайте копию всей рабочей папки. В неё должны входить миры, plugins, server.properties, файлы игроков и конфигурации. При переходе между версиями Minecraft формат мира может измениться; откат JAR не равен откату мира.
- Уточните Minecraft-версию и требуемую Java. Для Paper 1.20-1.21.11: Java 21 по таблице PaperMC; для 26.1+: Java 25.
- Проверьте поддержку версии у критических плагинов, например приватов, экономики и авторизации.
- Не устанавливайте новый JAR поверх работающего Java-процесса.
Скачайте Paper и укажите правильное имя JAR
Откройте официальный раздел загрузок PaperMC, выберите версию Minecraft и сборку. Не используйте JAR из случайных архивов или видеороликов. Сохраните номер сборки: он пригодится при поиске ошибки.
- Остановите сервер и дождитесь статуса «Остановлен».
- В Ghosting откройте Файлы, перейдите в корневую папку и нажмите Загрузить файлы.
- Загрузите скачанный JAR. Если запуск ожидает server.jar, используйте это имя либо измените параметр запуска через доступную панель/поддержку.
- Не удаляйте старый JAR до успешной проверки, но убедитесь, что запускается именно новый.
Первый запуск и EULA
Запустите Paper. Если консоль сообщает о необходимости принять EULA, прочитайте соглашение Minecraft, затем измените eula.txt. После повторного запуска дождитесь Done и попробуйте подключиться по адресу из панели.
java -version
java -Xms1G -Xmx4G -jar paper.jar --nogui
Где находятся настройки
После запуска появятся server.properties, bukkit.yml, spigot.yml, а также конфигурации Paper в config и настройки отдельных миров. Точные файлы и ключи зависят от версии. Меняйте по одному параметру и сохраняйте исходную копию.
| Файл / папка | Назначение |
|---|---|
| server.properties | Порт, whitelist, дистанции и основные свойства игры |
| plugins/ | JAR плагинов и их собственные данные |
| config/paper-global.yml | Общие настройки современных версий Paper |
| config/paper-world-defaults.yml | Настройки миров по умолчанию |
| logs/latest.log | Последний журнал запуска и ошибок |
Таблицу можно прокрутить по горизонтали →
Если Paper не стартует
Не переустанавливайте сервер сразу. Откройте logs/latest.log и найдите первую ошибку до строки остановки. Часто последняя строчка: лишь следствие.
| Ошибка | Действие |
|---|---|
| Unable to access jarfile | Сверьте имя JAR, регистр букв, папку и параметр запуска |
| UnsupportedClassVersionError | Выберите требуемую версию Java |
| FAILED TO BIND TO PORT | Сверьте назначенный порт; не запускайте второй процесс на том же адресе |
| You need to agree to the EULA | Прочитайте EULA и проверьте eula=true |
| Процесс убит без Java stack trace | Проверьте лимит памяти и события OOM в панели/у поддержки |
Таблицу можно прокрутить по горизонтали →
Проверка после установки
Подключитесь, создайте небольшую постройку и выполните штатный перезапуск. Убедитесь, что мир и данные игроков сохранены. Лишь затем переносите все плагины. Если ошибка возникает только с плагинами, проверьте запуск без сторонних JAR на отдельной копии сервера, сохранив их папки данных.
Документация и источники
Названия файлов и параметры могут отличаться между версиями. Перед изменением сверяйте документацию своей сборки.