Изменение команды запуска
Команда запуска — это команда, которую панель выполняет при нажатии кнопки «Запустить». Сам шаблон команды отредактировать не получится, но ты можешь изменить имя исполняемого файла и аргументы JVM в соответствующих полях. При автоматической смене ядра панель сама меняет параметры запуска. Если нужна произвольная команда, обратись в техническую поддержку.
Где посмотреть команду
- Открой my.superhub.host.
- Выбери нужный сервер.
- Перейди в «Настройки». Здесь находятся команда запуска, образ Docker и переменные.
Функционал управления постепенно переносится в личный кабинет. В будущем отдельная панель Pterodactyl может перестать использоваться. Пока она доступна, те же параметры можно найти через ссылку «Панель Pterodactyl» на странице сервера, во вкладке «Запуск».
В блоке «Команда запуска» показана готовая команда, а ниже — переменные, из которых она собирается. Например, поле «Исполняемый файл» может содержать server.jar, а поле «Аргументы JVM» — -Xms128M -XX:MaxRAMPercentage=95.0. Для такого набора команда выглядит так:
java -Xms128M -XX:MaxRAMPercentage=95.0 -jar server.jar
Набор переменных зависит от выбранного ядра. Если поле заблокировано или отмечено «Только чтение», изменить его значение здесь не получится. Версию Java можно выбрать в блоке «Образ Docker» по инструкции.
Поле «Версия Minecraft» в переменных закрыто для редактирования, но выбрать ядро и версию можно через мастер «Изменить ядро» в настройках личного кабинета. Если сервер уже настроен на Forge или NeoForge, версию можно изменить через поле точной версии загрузчика, а затем переустановить сервер — смотри инструкцию.
Аргументы JVM
Для Minecraft: Java Edition часто меняют не всю команду, а только аргументы JVM. Это параметры виртуальной машины Java: сборщик мусора, дополнительные флаги производительности и некоторые системные свойства. Подробнее о таких параметрах написано в отдельной статье: «Добавить флаги запуска».
Не копируй случайные наборы флагов без проверки. Некоторые аргументы работают только на определённых версиях Java, а устаревшие параметры могут полностью сломать запуск.
Генераторы команд
Иногда для Paper используют Start Script Generator. Он выдаёт целую команду запуска, которая начинается с java.
На хостинге обычно не нужно вставлять эту команду целиком. Если твоя задача — добавить оптимизационные флаги, скопируй только нужные JVM-аргументы, кроме параметров памяти, и укажи их в соответствующей переменной. Если вставить всю команду начиная с java, можно продублировать часть уже существующей команды запуска и сломать старт сервера.
Разберём сокращённый пример команды:
java -Xms2G -Xmx2G -XX:+UseG1GC -XX:+ParallelRefProcEnabled -jar server.jar
Здесь java запускает Java, параметры до -jar относятся к JVM, -jar server.jar выбирает файл ядра. Если тебе нужны дополнительные флаги сборщика мусора, возьми из этого примера только -XX:+UseG1GC -XX:+ParallelRefProcEnabled и допиши их через пробел в конец поля «Аргументы JVM», сохранив существующие параметры. Например, если в поле уже было -Xms128M -XX:MaxRAMPercentage=95.0, получится:
-Xms128M -XX:MaxRAMPercentage=95.0 -XX:+UseG1GC -XX:+ParallelRefProcEnabledНе добавляй повторно флаги, которые уже есть в переменной. java и -jar server.jar в это поле не входят.
Параметры памяти уже заданы панелью: в примере выше это -Xms128M -XX:MaxRAMPercentage=95.0. Сохраняй исходные значения своего сервера и не заменяй всё поле набором из генератора. Не добавляй -Xms2G -Xmx2G из примера команды и не изменяй параметры памяти вручную: это может привести к некорректному выделению памяти серверу.
Сохрани изменения и перезапусти сервер.
Файл запуска
При совместимой команде обычного запуска JAR можно, например, заменить Vanilla на Paper или Fabric. Если выбранному ядру нужны дополнительные файлы, загрузи их по инструкции проекта. Для другого ядра используй мастер «Изменить ядро» в личном кабинете; если нужного варианта нет и требуется другая команда запуска, напиши в поддержку.
Если ядро запускается через -jar, команда должна указывать на правильный .jar-файл. Например, если в корневой папке лежит файл paper-1.20.4.jar, а в переменной указано server.jar, сервер не сможет найти файл.
Исправить несоответствие можно двумя способами:
- переименовать загруженный файл в
server.jar; - изменить переменную файла запуска на реальное имя, например
paper-1.20.4.jar.
После изменения перезапусти сервер и проверь консоль. Ошибка поиска JAR должна исчезнуть. Если появилась другая ошибка, проверь требования ядра к Java и наличие остальных файлов сборки.
Forge и unix_args.txt
Следующее описание относится к серверу, для которого уже настроен шаблон Forge или NeoForge. Загрузка unix_args.txt на сервер с обычной командой java ... -jar server.jar сама по себе не изменит эту команду. Для перехода используй автоматическую смену ядра, а если нужного варианта нет — напиши в поддержку.
Шаблон Forge проверяет наличие unix_args.txt в корне сервера. Если файл есть, запуск идёт через @unix_args.txt, а значение поля «Исполняемый файл» не используется. Если файла нет, шаблон запускает .jar, указанный в этом поле. Поэтому для Forge с unix_args.txt изменение имени исполняемого файла не меняет способ запуска.
У NeoForge настроен запуск через @unix_args.txt без выбора между ним и .jar. Команда такого шаблона выглядит так:
java -Xms128M -XX:MaxRAMPercentage=95.0 -Dterminal.jline=false -Dterminal.ansi=true @unix_args.txt
Символ @ означает, что Java читает параметры из файла. Это не .jar-файл: переименовывать его в server.jar или указывать после -jar нельзя.
Проверь, что unix_args.txt находится в корне сервера и загружена вся папка libraries, созданная установщиком. При ручной установке Forge скопируй файл аргументов своей версии из libraries/net/minecraftforge/forge/ в корень по инструкции. Саму папку libraries сохраняй. Если нужных файлов нет, проверь результат установки; если требуется изменить шаблон команды, обратись в поддержку.
Произвольная команда
Если сборка запускается через .sh-скрипт, использует нестандартный лаунчер или требует другой команды, напиши в техническую поддержку. Для обычной установки Forge или NeoForge сначала проверь мастер «Изменить ядро»: он автоматически меняет параметры запуска. Поддержка нужна, если мастер не предлагает нужный вариант или сборке требуется особый запуск. Укажи нужное ядро и версию, приложи инструкцию по запуску сборки или требуемую команду — поддержка изменит шаблон.
Распространённые ошибки
Неверное имя файла
В консоли появляется ошибка:
Error: Unable to access jarfile server.jarКоманда запуска ищет server.jar, но такого файла нет в корневой папке. Проверь имя файла, расширение .jar и регистр букв. На Linux server.jar и Server.jar — разные имена.
Неподдерживаемый JVM-флаг
Сервер не запускается, а в консоли есть строки:
Unrecognized VM option
Could not create the Java Virtual MachineОбычно это значит, что в аргументах JVM есть опечатка или флаг, который не поддерживается выбранной версией Java. Удали последний добавленный параметр, сохрани изменения и перезапусти сервер.