Ядро Leaf: что это и как перейти с Paper

Коротко: Leaf — ядро от Winds-Studio на основе Paper, с асинхронным поиском пути, спавном мобов и трекером сущностей, а также патчами из Gale, Pufferfish и Purpur. Плагины работают те же, что на Paper. Чтобы перейти, сделайте бэкап, скачайте Leaf той же версии Minecraft на leafmc.one/download, замените jar и запустите сервер. DGuard официально поддерживает Leaf наравне с Paper.

Что такое Leaf#

Leaf — форк Paper. Документация описывает его так: баланс между производительностью, ванильным поведением и стабильностью, рассчитанный на крупные сети под высокой нагрузкой. В основе — Paper с его API и оптимизациями, сверху — патчи из Gale, Pufferfish, Purpur и других форков из списка благодарностей (Leaves, SparklyPaper, Moonrise и не только), плюс собственные.

Все патчи Purpur в Leaf есть, но часть их настроек переехала в конфиги Gale и Leaf. Обновления из Paper, по FAQ проекта, Leaf подтягивает обычно раз в 1–3 недели.

• Асинхронные модули: поиск пути мобов, спавн мобов, трекер сущностей, отправка чанков, сохранение данных игроков.
• Параллельный тик миров — каждый мир в своём потоке (экспериментально).
• Протоколы клиентских модов: Jade, AppleSkin, карты Xaero, Syncmatica и другие — каждый включается в конфиге.
• Формат регионов Linear — экономит место на диске; экспериментальный, сама документация его не советует.
• Интеграция с Sentry из Pufferfish — подробные отчёты об ошибках сервера.
• Исправления части ванильных багов и дополнительные настройки механик.

Leaf и Paper: в чём разница#

Короче: Leaf — это Paper плюс набор рычагов для производительности. Если сервер не упирается в основной поток, разница может быть незаметна. Если упирается — Leaf даёт, что крутить, но крутить придётся самому. Общая картина по ядрам — в статье какое ядро выбрать.

Версии и где скачать#

Официальные источники — страница загрузок Leaf и GitHub Releases репозитория Winds-Studio/Leaf. На странице загрузок есть версии от 1.21.4 до 26.3, и у каждой сборки указан канал: стабильный или экспериментальный. Экспериментальные сборки Leaf прямо называет нерекомендуемыми для боевых серверов.

На октябрь 2026 года стабильные сборки есть у 1.21.11, а у 26.2 и 26.3 — пока только экспериментальные. Java нужна та же, что Paper требует для этой версии: 21 для 1.21.x и 25 для 26.x — на странице загрузок Leaf 26.3 так и указано: Java 25+.

curl -O https://api.leafmc.one/v2/projects/leaf/versions/26.3/builds/4/downloads/leaf-26.3-4.jar

Как перейти с Paper на Leaf#

1. 1

   Узнайте точную версию сервера

   Выполните /version и скачайте Leaf той же версии Minecraft. Не обновляйте игру одновременно со сменой ядра — иначе не поймёте, что именно сломалось.

2. 2

   Остановите сервер и сделайте бэкап

   README Leaf прямо просит сделать резервную копию до перехода. Копируйте миры, конфиги и плагины — подробно в статье бэкапы сервера.

3. 3

   Замените jar

   Положите jar Leaf в папку сервера и поправьте имя в скрипте запуска (или переименуйте файл в то, что там указано). Старый jar Paper сохраните — пригодится для отката.

4. 4

   Запустите и прочитайте лог

   В config/ появятся leaf-global.yml, gale-global.yml и gale-world-defaults.yml. Конфиги Paper, bukkit.yml и spigot.yml остаются и работают.

5. 5

   Проверьте плагины

   /plugins — все ли зелёные. Если плагин не работает, FAQ Leaf советует проверить его на Purpur; если и там не работает — сообщить на GitHub Leaf.

Мир при переходе остаётся прежним: по умолчанию Leaf хранит регионы в обычном формате MCA (misc.region-format.format-name: MCA), как и Paper. Вернуться на Paper — та же замена jar, пока вы не включали Linear и secure seed. Самый надёжный путь назад — копия, сделанная перед переходом.

Настройки Leaf: что включать осторожно#

Главный файл — config/leaf-global.yml. Его можно перезагрузить командой /leaf reload, но асинхронные модули так не перезагружаются — после их изменения нужен перезапуск. Ниже — опции из документации Leaf для 1.21.11; на других версиях названия могут отличаться, сверяйтесь с документацией своей версии.

Secure seed особенно интересен открытым выживаниям и анархиям: документация Paper называет подбор сида одним из способов обойти anti-xray. Подробнее о защите руд — в статье защита от X-Ray.

DGuard на Leaf#

DGuard официально поддерживает Leaf — наравне с Paper это одна из двух платформ, для которых он сделан. Поддерживаются Leaf версий 1.21–26.3; основная — 1.21.11: на ней DGuard тестируется и работает на боевых серверах, остальные поддерживаются, но на боевых серверах ещё не проверялись.

Подключение то же, что на Paper: последний релиз PacketEvents и DGuard.jar в plugins/, ключ из панели — в plugins/DGuard/config.yml → license.key, перезапуск. Если вы выбрали Leaf ради производительности, античит её не съест: проверки DGuard идут в сетевых потоках, а не в основном, и на живом сервере занимают 0,03 % одного ядра на основном потоке — 0,38 мс из тика в 10,9 мс при 121 игроке. Подробнее — в статье нагрузка античита.

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