FoliaToGo: Свежие сборки Folia Каждую Ночь

Вероятно, вы слышали, что Folia - это будущее серверов Minecraft - параллельная обработка чанков, лучшая поддержка нескольких ядер, реальные улучшения производительности. Проблема в том, что Paper не выпустит автоматизированные сборки до тех пор, пока Folia не будет «официально готова». FoliaToGo сокращает это ожидание, предоставляя свежие компилированные файлы Folia каждый полночь UTC, без дополнительных условий.

Что делает этот проект

FoliaToGo автоматизирует процесс, который иначе был бы ручным и занимал много времени. Проект запускает рабочий процесс GitHub Actions каждую ночь в полночь UTC, компилируя последний код Folia и размещая результирующий файл .jar, который вы можете скачать. Нет необходимости в компиляции с вашей стороны. Нет ожидания официальных релизов. Просто скачайте и запустите.

С 104 звездами на GitHub и написанным в основном на Shell, это прямое решение конкретной проблемы. Всё установлено элегантно просто, потому что нужно хорошо делать только одно: автоматизировать сборку и сделать её доступной.

Почему администраторы серверов хотят это

Модель потоков Folia действительно отличается от Paper. Вместо одного потока, обрабатывающего все обновления чанков, Folia распределяет их по нескольким ядрам CPU. На правильно настроенном оборудовании это приводит к реальным приростам производительности - особенно в пиковые часы, когда TPS обычно падает.

Но Folia всё ещё экспериментальна. Вот главное: она получает обновления постоянно. Патчи безопасности, исправления ошибок, настройки производительности, которые могут быть важны для вашего сервера.

Вы могли бы подождать шесть месяцев до официального релиза. Или же можно скачать сборку с прошлой ночи и сразу получить эти улучшения. Для публичных серверов это реальная привлекательность - вы не жертвуете стабильностью, просто избегаете ожидания.

Начало работы - Простой способ

Самый простой подход: скачать напрямую с GitHub. Перейдите в раздел Actions проекта FoliaToGo (в README есть прямая ссылка) и скачайте последнюю успешную сборку. Это просто файл .jar - положите его в директорию вашего сервера рядом с Paper, как вы обычно это делаете.

java -Xmx30G -Xms30G -XX:+UseG1GC -XX:+ParallelRefProcEnabled \
 -XX:MaxGCPauseMillis=200 -XX:+UnlockExperimentalVMOptions \
 -XX:G1NewCollectionPercentage=30 -XX:G1MaxNewCollectionPercentage=40 \
 -XX:G1HeapRegionSize=8M -XX:G1HeapWastePercent=5 \
 -XX:G1MixedGCCountTarget=4 -XX:InitiatingHeapOccupancyPercent=15 \
 -XX:G1MixedGCLiveThresholdPercent=90 -XX:G1ReferenceProcessingThreads=4 \
 -XX:G1ReservePercent=10 -jar server.jar nogui

Это стабильная конфигурация JVM для Folia. Измените значения Xmx и Xms в зависимости от доступной ОЗУ - значения 30G приведены как пример.

Если вы хотите собрать локально, клонируйте репозиторий и запустите скрипт сборки:

git clone https://github.com/Slackadays/FoliaToGo
cd FoliaToGo
sh build.sh

Один нюанс: это не работает в Windows Command Prompt или PowerShell. Требуется bash - WSL2 на Windows или правильная среда Unix. Сборка также занимает время, в зависимости от вашего оборудования. Вы компилируете весь сервер из исходного кода, а не просто скачиваете предустановленный файл .jar.

Реальные сценарии, где это помогает

Вы управляете сервером для выживания. 50 игроков, пиковые часы каждую ночь. До Folia вы быжили бы каждую оптимизацию - настройки плагинов, код-ревью, возможно, апгрейд оборудования. С Folia вы тестируете ночные сборки в тестовой среде и деплоите свежую компиляцию в продакшн, когда находитесь улучшения. Вы получаете прирост производительности, который был бы невозможен иначе.

Или вы разработчик плагинов, тестирующийся против самой последней версии кода Folia. Официальные релизы могли бы быть неделями позже. FoliaToGo означает, что вы тестируетесь против сборки с прошлой ночи и сразу же обнаруживаете изменения API.

Если вы работаете с настраиваемыми сообщениями чата или командами, Генератор текста Minecraft может помочь правильно отформатировать их. Аналогично, если вы создаёте серверы с интенсивным использованием террена или разрабатываете плагины для генерации террена, инструмент Поиск блоков Minecraft полезен для кросс-сопоставления свойств блоков во время разработки.

Ловушки, которые вас поймут

Folia не является заменой Paper, которую можно просто подменить. Некоторые плагины не будут работать. Anything, предполагающее однопоточное поведение, сломается. Вы не можете просто заменить файл .jar и ожидать, что всё будет работать.

Сборки выполняются по расписанию. Если критический патч безопасности был отправлен в Folia в 3 часа UTC, ваша следующая автоматизированная сборка прибудет через 21 час в полночь UTC. Для продакшн-серверов этот разрыв может быть важен.

Я узнал это тяжело: Folia движется быстро. Сборка трёх недель назад может быть несовместима с текущим кодом. Вы не можете бесконечно использовать старую сборку. Обновления важны, и пропуск сборок может оставить вас позади.

Также явно проверяйте поддержку плагинов. Некоторые фреймворки справляются с Folia грациозно. Другие - нет. Знайте это до развертывания.

Стоит ли использовать это

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

Вы управляете чем-то, что требует выжимать производительность из каждого доступного CPU цикла? Стоит серьёзно рассмотреть. Модель потоков действительно разная, и на правильном оборудовании это заметно.

Сервер, полный плагинов? Тестируйте тщательно сначала. Ваши результаты будут сильно зависеть от используемых плагинов.

Сам проект очень стабилен - это автоматизированные сборки стабильного апстрима-кода. Этот риск - сам Folia, который экспериментален по дизайну. На самом деле, это особенность. Вы получаете самые последние улучшения быстрее, чем ожидая официальный статус «готово».