1. Установка JDK 8, настройка IntelliJ IDEA и создание первого проекта Spigot
Установка JDK 8, настройка IntelliJ IDEA и создание первого проекта Spigot
Добро пожаловать в курс по разработке плагинов для Minecraft версии 1.8! Вы выбрали легендарную версию игры, которая до сих пор остается стандартом для PvP-режимов и многих серверов мини-игр. Чтобы создавать свои собственные дополнения, нам потребуется надежный фундамент.
В этой статье мы пройдем путь от пустого рабочего стола до вашего первого скомпилированного .jar файла, который можно запустить на сервере. Мы разберем установку Java 8, настройку среды разработки IntelliJ IDEA и структуру базового плагина.
Зачем нам Java 8 и Minecraft 1.8?
Minecraft версии 1.8 был написан во времена, когда Java 8 была передовой технологией. Несмотря на то, что сейчас существуют гораздо более новые версии Java (17, 21 и далее), для разработки под старые ядра (Spigot 1.8.8) настоятельно рекомендуется использовать именно JDK 8.
Использование более новых версий Java может привести к ошибкам совместимости, например, UnsupportedClassVersionError, когда сервер, работающий на старой Java, не может прочитать плагин, скомпилированный на новой.
Шаг 1: Установка Java Development Kit (JDK) 8
Для запуска Minecraft достаточно JRE (Java Runtime Environment), но для разработки нам необходим JDK (Java Development Kit). Он включает в себя компилятор javac, который превращает ваш код в понятный машине формат.
Где скачать JDK 8?
Oracle изменила лицензионную политику, поэтому мы будем использовать бесплатные и надежные дистрибутивы, такие как Amazon Corretto 8 или Eclipse Adoptium (Temurin 8).
.msi для Windows или .pkg для macOS) и запустите его.Проверка установки
После установки откройте командную строку (Terminal или CMD) и введите:
Вы должны увидеть вывод, похожий на:
openjdk version "1.8.0_..."
Это означает, что Java успешно установлена и готова к работе.
Шаг 2: Установка и настройка IntelliJ IDEA
IntelliJ IDEA от компании JetBrains — это стандарт индустрии для разработки на Java. Она «умная», подсказывает ошибки на лету и автоматизирует рутину.
!Схема процесса разработки: от написания кода в среде разработки до запуска плагина на сервере.
Шаг 3: Создание проекта и подключение Spigot API
Теперь самое интересное. Мы создадим проект и объясним IntelliJ IDEA, что мы хотим работать с Minecraft.
Создание нового проекта
FirstPlugin.Подключение библиотеки Spigot
Чтобы писать код для Minecraft, нам нужно подключить Spigot API. Это «словарь», который объясняет программе, что такое «Игрок», «Блок» или «Чат».
Вам понадобится файл ядра сервера, например spigot-1.8.8.jar. Если у вас его нет, его нужно получить (обычно через BuildTools, так как распространение готовых ядер ограничено лицензией, но для обучения можно найти локальную копию).
File -> Project Structure (или Ctrl+Alt+Shift+S).+ -> Java.spigot-1.8.8.jar и выберите его.Теперь IDEA знает все команды Minecraft.
Шаг 4: Структура плагина и файл plugin.yml
Любой плагин состоит минимум из двух вещей:
plugin.yml).Создание главного класса
src нажмите правой кнопкой мыши -> New -> Java Class.com.example.Main. Это создаст пакет com.example и класс Main.Напишем код:
Разбор кода:
* extends JavaPlugin: Мы говорим, что наш класс — это не просто код, а плагин для Spigot.
* onEnable(): Этот метод запускается автоматически, когда сервер включает плагин.
* onDisable(): Запускается при выключении сервера или плагина.
* getLogger().info(...): Выводит сообщение в консоль сервера.
Создание plugin.yml
Без этого файла сервер не поймет, что перед ним плагин. Этот файл — паспорт вашего проекта.
src -> New -> File.plugin.yml.> Важно: В поле main должен быть указан полный путь к классу, включая пакеты. Если вы напишете просто Main, сервер выдаст ошибку ClassNotFoundException.
Шаг 5: Полезные команды IntelliJ IDEA
Вы просили изучить базовые команды среды разработки. Вот те, которые сэкономят вам часы работы. Запомните эти горячие клавиши:
1. Автоматический импорт и исправление ошибок (Alt + Enter)
Если вы написали JavaPlugin, и текст горит красным, поставьте на него курсор и нажмите Alt + Enter. IDEA сама предложит добавить import org.bukkit.plugin.java.JavaPlugin;.2. Форматирование кода (Ctrl + Alt + L)
Если ваш код выглядит неаккуратно (кривые отступы), нажмите эту комбинацию. IDEA автоматически расставит все скобки и пробелы по стандартам Java.3. Автодополнение (Ctrl + Space)
Начните писать getLog и нажмите Ctrl + Space. IDEA предложит getLogger(). Это основной инструмент программиста, чтобы не писать длинные названия вручную.4. Генерация кода (Alt + Insert)
Позволяет быстро создавать конструкторы, геттеры, сеттеры и переопределять методы (например, onEnable).Шаг 6: Компиляция (Сборка Artifact)
Мы написали код, но сервер понимает только .jar файлы. Нам нужно «собрать» проект.
File -> Project Structure -> Artifacts.+ -> JAR -> From modules with dependencies.Main Class пустым (для плагинов оно не нужно, так как входная точка указана в plugin.yml).Теперь, чтобы получить файл:
Build -> Build Artifacts.Build.Готовый файл появится в папке out/artifacts/FirstPlugin_jar/ внутри папки вашего проекта. Этот файл можно копировать в папку plugins вашего сервера и запускать!
Заключение
Поздравляю! Вы настроили профессиональное рабочее окружение и создали заготовку для будущего плагина. Вы узнали, что такое JDK, зачем нужен plugin.yml и как использовать магию Alt + Enter в IntelliJ IDEA.
В следующей статье мы углубимся в Spigot API и научимся реагировать на действия игроков, например, на вход на сервер или разрушение блоков.