Folia · MINECRAFT JAVA EDITION

Как установить Folia и проверить плагины перед запуском

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

Обновлено 3 мин чтения
Независимые регионы могут обрабатываться параллельно
Регион AДалёкая группа игроков
Регион BДругая группа чанков
Регион CОтдельная локация
Схема модели Folia. Близкие чанки объединяются; нагрузка одного региона не делится автоматически на произвольное число потоков. Все регионы ограничены доступным CPU.

Подготовьте отдельную проверку

Запишите версию Minecraft и ядра, Java, имя запускаемого JAR, плагины и их зависимости. Скопируйте миры и внешние базы. Тестовая копия не должна писать в ту же рабочую базу плагина, иначе это уже не изолированный тест.

  • Проверьте поддержку Folia у каждого обязательного плагина до установки.
  • Начните с той же Minecraft-версии, чтобы не смешивать смену ядра с конвертацией мира.
  • Уточните поддержку выбранного ядра и параметров запуска у хостинга.

Скачайте официальный JAR и проверьте Java

Получите сборку Folia с сайта PaperMC для нужной версии игры. Требуемую Java уточняйте у этой сборки, а не по году в названии статьи. Не пытайтесь исправлять несовместимость Java случайным переименованием JAR.

  1. Остановите тестовый сервер и дождитесь завершения процесса.
  2. Откройте Файлы в Ghosting и загрузите JAR в корень.
  3. Сверьте имя файла с командой запуска. Если настройка скрыта, обратитесь в поддержку.
  4. Выберите нужную Java через доступное окружение или согласуйте её с поддержкой.

Первый запуск без сторонних плагинов

На отдельной тестовой копии сначала исключите сторонние JAR плагинов из загрузки, сохранив их данные. Запустите Folia, при необходимости прочитайте и примите EULA, дождитесь завершения запуска. Убедитесь, что процесс использует Folia и нужную версию мира.

Подключайте проверенные плагины по очереди

Проверяйте версию, зависимости и реальную поддержку Folia. Не меняйте plugin.yml вручную, чтобы обойти отказ запуска. После каждой небольшой группы плагинов тестируйте основные действия обычным игроком без OP.

Что проверитьПример теста
Права и приватыИгрок может строить только в разрешённой зоне
ТелепортыПереход между далёкими регионами и измерениями
Экономика и данныеБаланс не теряется после перезапуска и смены локации
Задачи и сущностиНет ошибок доступа к чужому региону или потоку
ПерезапускМиры и данные плагинов сохраняются согласованно

Таблицу можно прокрутить по горизонтали →

Настройте потоки под фактический лимит

Не копируйте количество потоков из чужого конфига. Folia, работа чанков, GC и сеть делят ресурсы. Настройку threaded-regions.threads и связанные параметры проверяйте по документации вашей сборки и доступному лимиту CPU.

  • Начинайте с документированных значений, затем измеряйте нагрузку.
  • Предварительная генерация мира может сократить работу во время игрового пика, но сама требует CPU и места.
  • Не оценивайте многопоточность только по загрузке всей машины: отдельный регион может отставать.

Проверка, публикация и откат

Зафиксируйте результат тестирования и только затем планируйте перенос игроков. Сохраните исходный сервер остановленным до проверки. Если менялась версия мира или схема базы плагина, откат одного JAR не восстановит прежнее состояние. При сбое приложите версию Folia, Java, список плагинов, сценарий воспроизведения и лог без паролей и токенов.

Документация и источники

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