Как собрать плагин oraxen?

Уже довольно давно вижу вопросы по поводу сборки плагина oraxen своими руками и без головняка.

​

Основные проблемы всех, кто пытался — это то, что просто скачивают исходный код кнопкой Download ZIP на GitHub, или версия Java не та.
Разберём оба случая.

Проблема №1: неправильная версия java​

Oraxen не пишет в README, какая Java нужна для сборки. Это не очевидно — многие из‑за этого и ломаются.

Хорошая новость: версию можно посмотреть в самом репозитории — один раз запомнил, дальше всегда знаешь, что ставить.

Где на GitHub посмотреть, какая Java нужна​

Открываем репозиторий:Oraxen

Способ 1 — файл build.gradle.kts (главный)​

1. На главной странице репозитория в списке файлов найди build.gradle.kts
2. Нажми на него
3. Нажми Ctrl+F (поиск на странице)
4. Введи: toolchain или languageVersion

Увидишь примерно такое:

java {
    toolchain {
        languageVersion.set(JavaLanguageVersion.of(21))
    }
}

Цифра 21 — это и есть нужная версия Java для сборки.
Прямая ссылка на файл: oraxen/build.gradle.kts at master · oraxen/oraxen

Если в будущем Oraxen обновят — цифра может стать 22, 25 и т.д. Всегда смотри сюда, не гадай.

Что это значит для нас​

Сейчас Oraxen собирается на Java 21.
Не Java 8. Не «какая есть». Именно 21 (на момент написания статьи — смотри build.gradle.kts, если сомневаешься).
Веди в терминале: java -version

Если другое, то нужно ставить нужную java, нужную для тебя

Что делаем на долгосрок​

Раз настроим один раз — и забудем.

1. Установить JDK 21​

Скачать можно здесь: Adoptium
Windows → x64 → JDK → .msi → установить.
Или через терминал:
winget install EclipseAdoptium.Temurin.21.JDK

2. Поставить Java 21 «первой» в системе​

У многих уже стоят несколько Java (8, 11, 17, 21, 25). Windows берёт первую из списка Path — не ту, что в JAVA_HOME.

1. Win + R → sysdm.cpl → Enter
2. Дополнительно → Переменные среды
3. В Path поднять наверхстроку:
   C:\Program Files\Eclipse Adoptium\jdk-21.x.x-hotspot\bin
   (точное имя папки смотри в C:\Program Files\Eclipse Adoptium\)
4. JAVA_HOME— тоже на JDK 21:
   C:\Program Files\Eclipse Adoptium\jdk-21.x.x-hotspot
5. ОК → закрыть все терминалы → открыть новый

Проверка:
java -version
Должно быть 21.0.x, не 1.8.

Проблема №2: скачали ZIP​

Если на GitHub нажать Code → Download ZIP, получишь папку вроде oraxen-master. Внутри нет папки .git, а Oraxen при сборке использует плагин grgit — он читает текущую git-ветку для версионирования.

В IntelliJ или в консоли при синхронизации Gradle вылезет:

Failed to create service 'grgit'.
> No .git directory found!

Разберём как делать правильно.​

Начнём наверно с команды.
Напомню, oraxen большой плагин, и не нужно бояться что парсится/импортируется, и инициализируется слишком долго

Шаг 1. Создаём папку​

Создаём папку, где тебе удобно. Для наглядности — на Рабочем столе.
Я назвал её tut.
Открываем эту папку.

Шаг 2. Открываем терминал в этой папке​

Нажимаем в папке ПКМ (правая кнопка мыши).

В меню выбираем:
«Открыть в терминале»
Откроется чёрное или синее окно — это PowerShell или Командная строка.
Не страшно, дальше просто копируем команды.
В начале строки должно быть что-то вроде:

PS C:\Users\User\Desktop\tut>

Это значит: терминал уже внутри нашей папки tut. Сюда и будем клонировать проект.

Шаг 3. Проверяем, что git установлен​

В терминале пишем: git --version
Если всё ок — увидишь что-то вроде:
git version 2.45.xxxx


Если пишет, что команда не найдена — git не установлен. Ставим:

1. Открываем git-scm.com
2. Скачиваем и ставим (можно всё по умолчанию, Next-Next)
3. Закрываем терминал, открываем снова через ПКМ в папке tut
4. Снова: git --version

Шаг 4. Клонируем Oraxen (не ZIP!)​

В том же терминале, в папке tut, вводим одну команду:

git clone https://github.com/oraxen/oraxen.git

Enter. Подожди — пойдёт скачивание. Минуту–две, зависит от интернета.
Когда закончится, в папке tut появится новая папка:
tut
└── oraxen
Скаченное в консоли выглядит примерно вот так:


Внутри oraxen — исходники плагина и скрытая папка .git. Именно её не было в ZIP — из‑за этого и была ошибка No .git directory found!.

Шаг 5. Заходим в папку проекта​

В терминале: cd oraxen
Это значит: мы внутри проекта. Все команды сборки — отсюда.

6.1. Включаем режим без Spigot-модулей​

Первая команда:
$env:CI = "true"

Что это делает: Oraxen умеет собираться и под Paper, и под Spigot. Spigot-модули требуют отдельную утилиту BuildTools — без неё сборка падает с ошибкой про org.spigotmc:spigot.
Для обычного Paper / Folia сервера Spigot-модули не нужны. CI=true говорит Gradle: «собирай только то, что нужно для Paper».
После Enter ничего не выведет — это нормально. Переменная просто установилась в этой сессии терминала.

Если закроешь терминал — команду нужно будет ввести снова перед сборкой.

6.2. Запускаем сборку​

Вторая команда: .\gradlew.bat shadowJar
Что происходит:

1. Gradle скачает зависимости (первый раз — долго)
2. Скомпилирует core и все NMS-модули
3. Соберёт один fat-jar — готовый плагин

Первый раз жди 10–30 минут. Не закрывай терминал. Будут строки вроде:

Task :v1_21_R6:paperweightUserdevSetup

Executing decompileMinecraftServer...

Это нормально — Gradle качает и распаковывает серверные файлы Minecraft для разных версий.
Повторные сборки — намного быстрее (минуты, иногда секунды).

6.3. Как понять, что всё получилось​

В конце должно быть:
BUILD SUCCESSFUL

Если BUILD FAILED — что-то пошло не так. Скопируй красный текст ошибки и ищи решение (или спрашивай в чате).

​

6.4. Где лежит готовый JAR​

Открой в проводнике:
oraxen\build\libs\
Там файл вида:
oraxen-1.216.0.jar

Цифра 1.216.0 — версия из gradle.properties в корне проекта. У тебя может быть другая — это нормально.
Этот файл — готовый плагин.
Копируешь в plugins/ на сервер → перезапускаешь сервер.

Кайфуем

 

Ок

 

+REP