С чего начать: Первый плагин

Перейти к содержанию
​

Как создать самый первый плагин
Пошаговая инструкция для тех, кто ещё ни разу этого не делал

Все материалы:
1. Первый плагин
2. Работа с файлами конфигурации
3. Обработка событий
4. Команды

1. Выбор IDE для разработки.
Вообще писать Вы можете хоть в нотпаде, но удобнее делать это в специальном редакторе.
Я все свои плагины под bukkit написал в Eclipse, первые плагины для Nukkit тоже делал в нём. Однако сейчас я использую IntelliJ IDEA и на мой взгляд, эта среда разработки значительно удобнее.

2. Где взять IntelliJ IDEA?
Так как с выбором среды разработки мы определеились то теперь нужно её скачать: https://www.jetbrains.com/idea/download/


Здесь качаем версию "Community" её более чем достаточно для разработки любых плагинов для Nukkit.

3. Устанавливаем и запускаем
И видим что-то вроде (у Вас не будет в левой части списка проектов):


4. Создаем проект
Жмём ссылку Create New Project. Появляется окно, в котором Вы должны выбрать тип создаваемого проекта. Я обычно выбираю Maven — это дает возможность, при необходимости воспользоваться каким-то Maven репозиторием. Но в принципе подойдёт и тип Java.

Если Вы воспользовались Maven, то необходимо просто нажать "Next" и заполнить параметры проекта, относящиеся к Maven:


Необходимо указать значения для GroupId и ArctifactId. В Maven у каждого проекта есть два уникальных параметра groupId artifactId. Чтобы не было путаницы groupId — обычно доменное имя организации или сайта проекта. artifactId - название проекта.

После указания параметров Maven, указываем имя проекта:



Жмём кнопку "Finish" и проект создан!

5. Создаем пакет проекта
В левой части окна, оторажена структура проекта. Разворачиваем папку src — нам нужна папка /src/main/java. Кликаем на ней правой кнопкой мыши и создаем новый пакет:


Вводим имя пакета.



Всё пакет создан!

6. Настраиваем библиотеку
Поскольку мы будем писать плагины для Nukkit, то значит будем обращаться к его функциям, а значит сам сервер будет выступать у нас в качестве библиотеки.

Для этого в окне проекта жмём кнопку Project Structure (Структура проекта):



В появившемся окне выбираем раздел Library (Библиотека), там давим кнопку "+" и выпадающем меню жмём "Java".

 

После этого Вам будет предложено выбрать файл на диске — надо будет найти jar-файл сервера наккит (я лично положил его в отдельную папку).


7. Создаем главный класс проекта
Главный класс проекта надо создавать в пакете, который мы создали раньше:



Вводим имя название класса:


Класс создан:


8. Создаем plugin.yml
Каждому плагину необходим файл plugin.yml. В этом классе описаны некоторые настройки плагина и указано, какой класс у плагина главный.
Без этого файла плагин не будет загружен.

Файл создается в папке resources (ресурсы):


Файл называем (естественно) "plugin.yml"



В файле указываем текст:

Code:

name: FirstPlugin
main: me.fromgate.firstplugin.FirstPlugin
version: "0.0.1"
author: fromgate, nukkit.ru
api: ["1.0.0"]
description: My first plugin

Здесь:
Поле "name" — название плагина
"main" — пакет плагина + название главного класса плагина
"version" — номер версии, обращаю внимание, что его нужно указывать в кавычках
"api" — похоже это версии API, которые поддерживает плагин. Всегда пишем "["1.0.0"]".
"description" — краткое описание плагина.

Кстати, пусть Вас не пугает, сообщение:


Вам предлагаю установить плагин для работы с форматом YAML. По моему он не нужен, поэтому давите "Ignore extension".

9. Пишем первый простой код
Возвращаемся к редактированию основного класса плагина делаем следующее:
Дописываем к названю плагина два слова "extends PluginBase". Это означает, что наш класс наследует класс PluginBase — такие классы nukkit может загружать в качестве плагинов.

В самом классе создаем метод:

Code:

@Override
public void onEnable(){
this.getLogger().info(TextFormat.RED+"My first plugin enabled");
}

В процессе набора текста, редактор может сообщать, что какие-то классы ему неизвестны. Как правило, достаточно просто нажать сочетание клавиш Alt+Enter, чтобы необходимые пакеты были указаны в разделе импортируемых.



В приниципе первый плагин готов! Можно компилировать!

10. Компилируем плагин
Снова давим кнопку "Project Structure" и переходим к разделу "Artifacts".
Жмём на плюсик, выбирам "JAR", потом "Empty":



Открывается окно настройки проекта.
Здесь нужно:

• Задать название (Name)
• Указать директорию куда будет компилироваться файл (я указываю директорию плагинов моего тестового сервера)
• Перенести мышкой из правой части панели "Available Elements" в левую элемент 'FirstPlugin' compile output
• И задать галочку "Build on make"

 

Жмём Ok, переходим в редактор и жмём сочетание клавиш Ctrl+F9 и....


Всё! Плагин скомпилировался и лежит там где вы его указали. Можно запускать сервер!

11. Проверяем плагин
Для этого мы просто запускаем сервер и смотрим в консоль.
Если Вы увидите там наше сообщение, значит Вы всё сделали правильно!


Успехов!

 

Там когда код набираешь - видеть надо. IDEA за тебя пишет

 

Так разработчики-то те же. Это по сути одан и та же IDE

 

Я постараюсь сделать обучалки на основные вопросы:

• как использовать конфиг;
• как создавать команды;
• как обрабатывать события;
• ну и ещё какие-то.

 

Породолжение: Работа с конфигурацией

Про команды, будет следующий туториал. Постараюсь к вечеру.
Готового скелета у меня пока нет. Я думаю к концу всех этих обучалок, мы получим скелет плагина )

 

А спасибо. Это видно я удалил после того как подключил подсветку синтаксиса )

 

Тогда обрати внимание на плагин CatLoad и вообще не сообщения его автора @Doomhawk - у него тут самый продвинутый опыт по части разработки и запуска Nukkit без ПК

 

@Iggy
Ругается на то, что не та версия Java.

Проверьте, что у Вас установлена 8-ая версия Java.

А потом, проверьте проект (как должно быть, я подсветил красным):