> Полный список статей есть в [llms.txt](https://docs.f3cloud.com/llms.txt). Markdown-версия есть у каждой страницы, достаточно добавить .md к её адресу. Эта страница в Markdown: [https://docs.f3cloud.com/ru/games/minecraft-cores-plugins.md](https://docs.f3cloud.com/ru/games/minecraft-cores-plugins.md).

# Ядра и плагины Minecraft – Paper, Purpur, Fabric, Forge и установка плагинов

Ядра и плагины Minecraft. Чем отличаются Paper, Purpur, Folia, Fabric, NeoForge, Forge и Velocity, как сменить ядро сервера, где безопасно скачивать плагины, как их установить, обновить и удалить. Примеры с LuckPerms, WorldEdit и Chunky, проверено на Minecraft 26.3.

Когда сервер Minecraft уже работает, рано или поздно хочется большего. Например, раздать игрокам права, защитить постройки от гриферов или добавить в игру новые предметы. Для этого есть плагины и моды, а то, какие из них можно поставить, зависит от ядра сервера. В этой статье разберём, какие бывают ядра и чем они отличаются, как сменить ядро на уже работающем сервере и как устанавливать плагины. Все примеры мы проверили на тестовом сервере с Minecraft **26.3**, который установили по статье про [сервер Minecraft на VPS](https://docs.f3cloud.com/ru/games/minecraft-server.md).

***

## Ядро, плагины и моды

**Ядро** – это сама программа сервера, тот файл `.jar`, который запускается командой `java -jar`. Mojang выпускает официальное ядро, а сообщество делает свои, более быстрые или с дополнительными возможностями. От ядра зависит, что вообще можно добавить на сервер.

**Плагины** работают только на сервере. Они меняют правила игры, добавляют команды, права, защиту территорий, экономику. Игрокам ничего ставить не нужно, они заходят с обычной игрой, поэтому настоящих новых блоков и мобов плагины обычно не добавляют. Плагины работают на ядрах семейства Paper, то есть на Paper, Purpur и с оговорками на Folia.

**Моды** могут менять игру гораздо глубже, вплоть до новых блоков, мобов и измерений. Они работают на ядрах-загрузчиках Fabric, NeoForge и Forge. Часть модов достаточно поставить на сервер, а часть нужна и каждому игроку. Это указано на странице мода на [Modrinth](https://modrinth.com) в блоке **Supported environments**.

Плагины и моды несовместимы между собой. Плагин не запустится на Fabric, а мод на Paper. Поэтому сначала решите, что вам нужно, а потом выбирайте ядро.

***

## Какое ядро выбрать

| Ядро | Что это | Что подключается | Когда выбирать |
| --- | --- | --- | --- |
| **Vanilla** | Официальный сервер от Mojang | Ничего | Нужна игра без изменений |
| **Paper** | Быстрый сервер на основе официального | Плагины | Обычный сервер для друзей или сообщества |
| **Purpur** | Сервер на основе Paper с множеством дополнительных настроек | Плагины для Bukkit, Spigot и Paper | Хочется тонко настроить игровые механики |
| **Folia** | Версия Paper, которая обсчитывает разные части мира в разных потоках | Только плагины, поддерживающие Folia | Очень много игроков, разбросанных по миру |
| **Fabric** | Лёгкий загрузчик модов | Моды для Fabric | Моды, в том числе оптимизации |
| **NeoForge** | Загрузчик модов | Моды для NeoForge | Крупные сборки модов |
| **Forge** | Классический загрузчик модов | Моды для Forge | Сборка модов, которая есть только под Forge |
| **Velocity** | Прокси, который объединяет несколько серверов в одну сеть | Плагины для Velocity | Несколько серверов с переходом между ними |

На момент проверки сборки под Minecraft 26.3 были у всех ядер из таблицы, у Forge пока только без пометки «рекомендуемая». Если не знаете, что выбрать, ставьте **Paper**. Разработчики Folia сами пишут, что она не нужна большинству серверов и ломает большинство публичных плагинов.

***

## Как сменить ядро

Перейти между ядрами семейства Paper просто, потому что мир и плагины остаются теми же. Мы перевели тестовый сервер с Paper на Purpur, и он запустился с тем же миром и всеми тремя плагинами, а затем так же вернули Paper.

1. Остановите сервер и сделайте копию мира.

   ```bash
   systemctl stop minecraft
   cp -a /opt/minecraft/world /root/world-backup
   ```

2. Скачайте новое ядро в папку сервера. Для Purpur последняя сборка нужной версии скачивается по прямой ссылке.

   ```bash
   cd /opt/minecraft
   curl -fsSL -o purpur.jar https://api.purpurmc.org/v2/purpur/26.3/latest/download
   chown minecraft:minecraft purpur.jar
   ```

3. Замените в скрипте запуска имя файла ядра.

   ```bash
   sed -i 's/-jar paper.jar/-jar purpur.jar/' /opt/minecraft/start.sh
   ```

4. Запустите сервер и проверьте в журнале, что загрузилось новое ядро.

   ```bash
   systemctl start minecraft
   grep bootstrap /opt/minecraft/logs/latest.log
   ```

   В строке **Loading Purpur** будет версия ядра. Рядом с `server.properties` появится файл `purpur.yml` с дополнительными настройками.

С Fabric, NeoForge и Forge так не получится, ведь плагины там не работают. Сервер на загрузчике модов лучше ставить в отдельную папку. Для Fabric есть готовый файл сервера на странице [fabricmc.net/use/server](https://fabricmc.net/use/server). Мы проверили его на Minecraft 26.3. При первом запуске он сам скачал игру и загрузчик и создал папку `mods`, куда кладутся моды. Большинству модов для Fabric нужен ещё мод **Fabric API**, он тоже кладётся в `mods`.

***

## Где брать плагины

Скачивайте плагины только с известных площадок.

* [Modrinth](https://modrinth.com/plugins) – большой каталог плагинов и модов с удобным фильтром по версии игры и ядру.
* [Hangar](https://hangar.papermc.io) – каталог плагинов на сайте PaperMC.
* [SpigotMC](https://www.spigotmc.org/resources/) – каталог плагинов на сайте SpigotMC.

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

> **Не скачивайте плагины со случайных сайтов.**
>
> Плагин – это программа, которая работает на вашем сервере с правами пользователя `minecraft`. Плагин из непроверенного источника может содержать вредоносный код и получить доступ ко всем файлам сервера Minecraft.

***

## Как установить плагин

Установка плагина на Paper – это просто файл `.jar` в папке `plugins`. Мы поставили на тестовый сервер три популярных плагина. **LuckPerms** управляет правами игроков, **WorldEdit** помогает строить, а **Chunky** заранее создаёт мир вокруг спавна.

1. Скопируйте на странице плагина ссылку на файл нужной версии и скачайте его в папку `plugins`.

   ```bash
   cd /opt/minecraft/plugins
   curl -fsSL -O https://cdn.modrinth.com/data/Vebnzrzj/versions/b0mk8uS6/LuckPerms-Bukkit-5.5.71.jar
   chown minecraft:minecraft *.jar
   ```

2. Перезапустите сервер.

   ```bash
   systemctl restart minecraft
   ```

3. Откройте консоль сервера командой `su - minecraft -c "screen -r minecraft"` и введите `plugins`. Сервер покажет список загруженных плагинов.

<figure><img src="https://docs.f3cloud.com/img/minecraft-plugins-list.png" alt="Команда plugins в консоли Paper показывает три плагина Chunky, LuckPerms и WorldEdit"><figcaption><p>Все три плагина загружены</p></figcaption></figure>

При первом запуске плагин обычно создаёт в `plugins` свою папку с настройками, например `plugins/LuckPerms`. Настройки меняют в файлах этой папки, а потом перезапускают сервер.

***

## Примеры работы с плагинами

**LuckPerms** раздаёт права группам игроков. Ниже мы создали группу строителей, разрешили ей все команды WorldEdit и добавили в неё игрока.

```bash
lp creategroup builders
lp group builders permission set worldedit.* true
lp user Steve parent add builders
```

<figure><img src="https://docs.f3cloud.com/img/minecraft-luckperms.png" alt="Команды LuckPerms в консоли, группа builders создана, права worldedit выданы, игрок Steve не найден"><figcaption><p>Группа создана, а игрока LuckPerms ещё не знает</p></figcaption></figure>

Обратите внимание на последнюю строку. LuckPerms не нашёл игрока, который ещё ни разу не заходил на сервер. Поэтому добавляйте игрока в группу после его первого входа.

**Chunky** заранее создаёт участки мира, чтобы сервер не тратил на это силы, когда игроки разбегаются в разные стороны. Задайте радиус в блоках и запустите задачу.

```bash
chunky radius 300
chunky start
```

<figure><img src="https://docs.f3cloud.com/img/minecraft-chunky.png" alt="Chunky создаёт мир вокруг спавна, задача завершена, обработано 1521 участок за 40 секунд"><figcaption><p>Мир в радиусе 300 блоков создан за 40 секунд</p></figcaption></figure>

На нашем сервере мир в радиусе 300 блоков занял 1521 участок и был готов за 40 секунд, а папка мира выросла до 30 МБ. Для большого радиуса задача может идти часами, поэтому запускайте её, когда на сервере мало игроков.

***

## Как обновить или удалить плагин

* **Обновить.** Остановите сервер, удалите старый файл плагина из `plugins`, положите новый и запустите сервер. Папку с настройками плагина не трогайте.
* **Удалить.** Остановите сервер и удалите файл плагина. Если настройки плагина больше не нужны, удалите и его папку.

Перед обновлением ядра на новую версию Minecraft проверьте, что все ваши плагины уже её поддерживают.

***

## Частые вопросы

<details>

<summary>does not contain a paper-plugin.yml or plugin.yml! Could not determine plugin type</summary>

В папку `plugins` положили не плагин, а мод. Мы получили эту ошибку, когда положили туда мод Lithium для Fabric. Моды работают только на Fabric, NeoForge или Forge. Удалите файл из `plugins` или найдите плагин с похожими возможностями.

<figure><img src="https://docs.f3cloud.com/img/minecraft-plugin-load-error.png" alt="Ошибка Paper при загрузке мода Lithium для Fabric из папки plugins"><figcaption><p>Paper не может загрузить мод как плагин</p></figcaption></figure>

</details>

<details>

<summary>You are running an unsupported server version!</summary>

Плагин не рассчитан на эту версию Minecraft. Мы увидели это сообщение у EssentialsX 2.22.0, который официально поддерживает версии до 26.1.2, на сервере 26.3. Плагин при этом запустился, но работать без ошибок он не обязан. Поищите версию плагина для вашей версии игры или подождите её выхода.

</details>

<details>

<summary>A user for … could not be found</summary>

LuckPerms ещё не знает этого игрока. Попросите игрока зайти на сервер, а потом повторите команду.

</details>

<details>

<summary>Плагин работает на Paper, но не работает на Folia</summary>

Folia обсчитывает мир в нескольких потоках, и обычные плагины к этому не готовы. На Folia работают только плагины, в описании которых указана её поддержка. Если нужных плагинов для Folia нет, оставайтесь на Paper.

</details>

***

## Наши ресурсы

**Telegram-канал:** [https://t.me/f3cloud_news](https://t.me/f3cloud_news)\
**Официальный сайт:** [https://f3cloud.com](https://f3cloud.com/ru)