Как поднять сервер Paper на своём компьютере: какая нужна Java, start.bat и eula.txt, куда класть плагины и где их брать, какие файлы настроек за что отвечают, почему не стоит пользоваться /reload и как разбирать ошибки плагинов.

Paper — самое популярное ядро для серверов Minecraft с плагинами. Это ванильный сервер с оптимизациями и исправлениями, который запускает плагины Bukkit и Spigot. Если тебе нужны приваты, экономика, телепорты или мини-игры без модов на клиенте, тебе сюда.

Почти все инструкции в интернете заканчиваются кнопкой «арендовать сервер». Для игры с друзьями и для настройки сборки плагинов хватит твоего компьютера.

Paper или Fabric с Forge

Выбор делается один раз, и его трудно поменять.

Плагины Paper работают только на сервере. Игроки заходят обычным клиентом Minecraft без установки чего-либо. Но добавить новые блоки или предметы со своими текстурами плагины не могут.

Моды Fabric и Forge меняют саму игру: новые блоки, мобы, механики. Зато тот же мод почти всегда нужен и на клиенте у каждого игрока.

Если нужны правила, команды и экономика — Paper. Если новый контент — Fabric или Forge.

Какая Java нужна

По документации Paper, версии 1.20–1.21.11 работают на Java 21, а новые версии с нумерацией 26.1 и выше требуют Java 25. Если в логе видишь Unsupported class file major version, дело в Java, подробнее в статье сервер Minecraft не запускается.

Проверь версию командой java -version.

Запуск

Скачай paper-<версия>.jar для нужной версии игры с papermc.io.
Положи в пустую папку и переименуй в paper.jar, чтобы не править команду при обновлениях.
Создай рядом start.bat:

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

Запусти. Сервер создаст файлы и остановится.
Открой eula.txt, замени eula=false на eula=true, запусти ещё раз.

Зайти можно по адресу localhost. Память в -Xms и -Xmx ставь по реальным возможностям компьютера: если сам играешь на нём же, 4 ГБ на сервер при 16 ГБ всего — это нормально, 12 уже нет.

Файлы настроек

Файл	За что отвечает
`server.properties`	порт, режим игры, сложность, белый список, `online-mode`
`bukkit.yml`	лимиты спавна мобов, частота автосохранений
`spigot.yml`	дальность обработки сущностей, настройки производительности
`config/paper-global.yml`	глобальные настройки Paper
`config/paper-world-defaults.yml`	настройки миров по умолчанию

В первый вечер нужен в основном server.properties. Остальные файлы трогают, когда сервер начинает тормозить при игроках.

Про online-mode: при true сервер проверяет лицензию игроков. Выключать его ради «пиратского» входа значит разрешить любому зайти под любым ником, в том числе под твоим с правами оператора. Если всё-таки делаешь так, ставь плагин авторизации и включай белый список.

Плагины

Плагин — это .jar в папке plugins. Кладёшь файл, перезапускаешь сервер, плагин загружен.

Где брать: Hangar (площадка от команды Paper), Modrinth и SpigotMC. Смотри, чтобы плагин поддерживал твою версию игры: на странице это обычно указано.

После первого запуска плагин создаёт свою папку в plugins с config.yml. Настройки меняют там, а применяют перезапуском сервера или командой перезагрузки самого плагина, если она у него есть.

◆

Не пользуйся командой /reload. Она перезагружает все плагины разом, и многие плагины к этому не готовы: утечки памяти, сломанные данные, странное поведение до следующего перезапуска. Полный перезапуск сервера надёжнее.

Права игрокам почти всегда выдают через плагин LuckPerms. Базовые команды сервера: op <ник> делает игрока оператором, whitelist on и whitelist add <ник> включают белый список.

Когда плагин не работает

Порядок проверки:

В консоли набери plugins. Плагин красным или его нет в списке — значит он не загрузился.
Открой logs/latest.log и найди строки с именем плагина рядом с ERROR.
Частая причина — плагину нужна зависимость. Например, многие плагины экономики требуют Vault. В логе рядом с именем плагина будет упоминание недостающей зависимости (dependency) и её название.
Вторая частая причина — плагин под другую версию игры.
Третья — два плагина делают одно и то же и конфликтуют: две экономики, два плагина на приваты.

Как отдать настройку агенту

Настройка сервера с плагинами — это десяток YAML-файлов, где один лишний пробел в отступе ломает весь конфиг, и лог, в котором нужно найти одну строку.

Дока — ИИ-агент, который работает с файлами и терминалом на твоём компьютере. Дай ей папку сервера и попроси:

«Плагин не загрузился. Посмотри лог и скажи, чего ему не хватает»;
«Проверь все config.yml в plugins на ошибки в YAML»;
«Настрой в EssentialsX стартовый набор: хлеб, каменный меч, кирка, остальное не трогай»;
«Сделай копию мира и папки plugins перед обновлением версии».

Агент открывает файлы сам, поэтому не нужно пересылать ему конфиги по одному. Ночную копию мира можно поставить на расписание.

Модель в Доке можно держать локальной, но пока на том же компьютере работают сервер и игра, памяти может не хватить. На это время удобнее облачная модель по API-ключу.

С чего начать

Запусти чистый Paper, зайди сам, поставь один плагин, например EssentialsX, и проверь, что его команды работают. Дальше добавляй по одному. Если после очередного плагина сервер не стартует, скачай Доку и попроси её прочитать лог.

Сервер Minecraft на Paper с плагинами: запуск на своём ПК и настройка без хостинга