BlockRadar
Серверов online—Игроков—На сайте—
Бесплатный мини-курс

Первый Minecraft-плагин

Пять шагов от пустого Java-проекта до рабочей команды /hello. Прогресс сохраняется в этом браузере.

Прогресс курса0 из 5 · 0%
Шаг 1

Подготовь Java-проект

Создай проект под Paper API. Нужны главный Java-класс и plugin.yml.

Результат шагаУ тебя есть пустой проект, который собирается без ошибок.
Шаг 2

Создай главный класс

Главный класс наследуется от JavaPlugin. onEnable() вызывается при включении плагина.

package ru.blockradar.hello;

import org.bukkit.plugin.java.JavaPlugin;

public final class HelloPlugin extends JavaPlugin {
    @Override
    public void onEnable() {
        getLogger().info("HelloPlugin запущен");
    }
}
Результат шагаКласс компилируется, package совпадает со структурой проекта.
Шаг 3

Опиши plugin.yml

Сервер должен знать имя плагина, главный класс, API и команду.

name: HelloPlugin
version: 1.0.0
main: ru.blockradar.hello.HelloPlugin
api-version: '1.21'
commands:
  hello:
    description: Первая команда плагина
Результат шагаПроверь api-version под свою сборку сервера.
Шаг 4

Добавь /hello

Подключи executor и верни игроку сообщение из своего плагина.

getCommand("hello").setExecutor((sender, command, label, args) -> {
    sender.sendMessage("Привет от BlockRadar Creator!");
    return true;
});
Результат шагаМини-челлендж: добавь имя игрока в ответ.
Шаг 5

Собери и запусти

Собери JAR, положи его в plugins тестового Paper-сервера и перезапусти сервер.

Результат шагаГотово: команда /hello работает внутри Minecraft.
Следующий уровень

Теперь преврати учебный плагин в проект

События игрока, конфигурация, Git, сервер для тестирования, Creator-портфолио и участие в Minecraft Challenge.