Вики PocketMine.ru

Установка Java

JDK 17 и 21 для Paper, Spigot, Nukkit-MOT и прокси. Linux, Windows, проверка версии, типичные ошибки.

Java 21 JDK 17 OpenJDK
Установка Java — Minecraft Wiki PocketMine

Java Runtime/JDK — основа серверов Minecraft Java Edition и Java-ядер Bedrock вроде Nukkit-MOT. Правильная версия JVM важнее «самой новой ради новейшей».

book writable command block iron sword hopper emerald redstone dust

Какую Java ставить в 2026

Paper / Spigot 1.20.5+Java 21 — рекомендуемый минимум
Paper 1.21.xJava 21; следите за заметками к релизу ядра
Nukkit-MOTJava 17+ (17 LTS или 21 LTS)
Старые ядра 1.16–1.20.4Часто хватает Java 17
Клиент Minecraft JavaОтдельно от серверной JVM; launcher тянет свою runtime
Рекомендация PocketMine.ru: для Paper 1.21 — Java 21; для Nukkit-MOT — Java 17 или 21. На одном VDS можно держать несколько JDK через update-alternatives.

Проверка текущей версии

В терминале Linux / macOS / PowerShell (если java в PATH):

Команда Зачем
java -version Версия runtime
javac -version Есть ли JDK (компилятор)
which java / where java Путь к бинарнику
echo $JAVA_HOME Переменная окружения (если задана)

Linux

OpenJDK 21 (для Paper)

  1. sudo apt update
  2. sudo apt install -y openjdk-21-jre-headless — для запуска сервера достаточно JRE.
  3. Для сборки плагинов: sudo apt install -y openjdk-21-jdk-headless
  4. Проверка: java -version — в выводе строка с 21.

OpenJDK 17 (для Nukkit-MOT / совместимость)

  1. sudo apt install -y openjdk-17-jre-headless
  2. Если установлено несколько Java: sudo update-alternatives --config java и выберите нужную.

CentOS / Rocky / Alma

  • Java 21: sudo dnf install -y java-21-openjdk-headless
  • Java 17: sudo dnf install -y java-17-openjdk-headless

Windows

  1. Скачайте Temurin / Microsoft Build of OpenJDK / Oracle JDK 21 с официального сайта дистрибутива OpenJDK.
  2. Установите, отметьте «Set JAVA_HOME» / добавление в PATH, если мастер предлагает.
  3. Откройте новый CMD: java -version.
  4. Для сервера удобнее JRE/JDK headless-аналоги; на Windows обычно ставят полный JDK.

Запуск сервера с явным путём к Java

Если в PATH «не та» Java:

  • Linux: /usr/lib/jvm/java-21-openjdk-amd64/bin/java -Xms2G -Xmx4G -jar paper.jar --nogui
  • Windows: "C:Program FilesEclipse Adoptiumjdk-21binjava.exe" -Xms2G -Xmx4G -jar paper.jar --nogui

Типичные ошибки

UnsupportedClassVersionErrorЯдро собрано под более новый class file — обновите Java
java: command not foundНет PATH / не установлена runtime
Wrong Java for old pluginsОчень старые плагины 1.8 иногда капризничают — смотрите docs плагина
Несколько JavaЯвно указывайте путь в start-скрипте сервера

Windows: Java через Scoop (рекомендуем)

  1. Поставьте Scoop — инструкция.
  2. scoop bucket add java
  3. JDK 21: scoop install temurin21-jdk
  4. JDK 17: scoop install temurin17-jdk
  5. java -version

Linux/macOS/WSL: SDKMAN!

SDKMAN — менеджер JDK, Maven, Gradle, Kotlin. На Windows — через WSL2 (нативно в PowerShell не обязателен, для Windows удобнее Scoop).

  1. Установите SDKMAN по официальной инструкции (без сторонних зеркал и «готовых» скриптов из чатов).
  2. Перезапустите shell / source "$HOME/.sdkman/bin/sdkman-init.sh"
  3. sdk version
  4. Список JDK: sdk list java
  5. Поставить Temurin 21: sdk install java 21.0.4-tem (точный идентификатор смотрите в sdk list java — патч-версии обновляются).
  6. Или алиас LTS: sdk install java 21-tem если доступен в вашем индексе.
  7. По умолчанию: sdk default java <identifier>
  8. Переключение: sdk use java <identifier>

SDKMAN: Maven и Gradle

  • sdk install maven
  • sdk install gradle
  • Подробнее: Gradle / Maven

Клиент Minecraft Java тянет свою runtime — серверу нужна отдельная JVM в PATH. На одном VDS можно держать 17 и 21 через alternatives / Scoop. Для Paper 1.21 ориентир — 21, для Nukkit-MOT — 17+.

Дальше по вики

После Java: Spigot/Paper, Nukkit-MOT. Для Bedrock на PHP: установка PHP и PocketMine-MP.