Настройка FreeMinecraftModels

FreeMinecraftModels по-прежнему поддерживает ручной импорт .bbmodel, но текущий процесс настройки рассчитан на Nightbreak и управляется через меню.

Предварительные требования

• Среда выполнения Java 21 для сервера
• Установленный и хотя бы раз запущенный FreeMinecraftModels, чтобы он создал свои папки данных
• Способ доставить сгенерированный ресурс-пак игрокам

ResourcePackManager — рекомендуемый способ доставки, потому что FreeMinecraftModels только генерирует пак, но не хостит его сам.

Процесс первого запуска

Команда	Назначение
/fmm setup	Меню управления контентом / первичной настройки (только для игроков; та самая команда, на которую игрокам указывают при первом запуске)
/fmm recommendedplugins	Показывает плагины-компаньоны, хорошо сочетающиеся с FreeMinecraftModels
/fmm downloadall	Помощник массовой установки: скачивает последнее обновление плагина плюс все доступные паки Nightbreak
/fmm downloadallcontent	Помощник массовой установки доступных паков Nightbreak (только контент)
/fmm updatecontent	Помощник массового обновления устаревших паков Nightbreak
/fmm downloadpluginupdate	Скачивает только последнее обновление jar плагина
/nightbreaklogin <token>	Регистрация общего токена Nightbreak

Если в config.yml всё ещё указано setupDone: false, игроки с правом freeminecraftmodels.* получают одноразовое напоминание при входе, указывающее на /fmm setup (открытие меню навсегда убирает это сообщение). Напоминание также упоминает /fmm admin и /fmm.

Рекомендуемый рабочий процесс

1. Установите FreeMinecraftModels и запустите сервер один раз.
2. Привяжите токен Nightbreak командой /nightbreaklogin <token>.
3. Откройте /fmm setup, чтобы посмотреть доступные паки и текущее состояние.
4. Используйте /fmm downloadall, если хотите установить все официальные паки, к которым у вашего токена есть доступ (заодно подтягивается последнее обновление jar плагина).
5. Позднее используйте /fmm updatecontent для обновления устаревших официальных паков.
6. Убедитесь, что игроки получают сгенерированный пак output/FreeMinecraftModels.zip, обычно через ResourcePackManager.

Если вы предпочитаете, чтобы сервер сам подтягивал обновления, задайте nightbreak.autoDownloadPluginUpdates: true в config.yml (по умолчанию false). Скачанные обновления плагина и контента применяются после следующего перезапуска. См. Конфигурацию.

Ручной импорт моделей

Прямой импорт моделей по-прежнему работает через:

plugins/FreeMinecraftModels/imports

Этот путь всё ещё полезен для:

• локальной разработки
• пользовательских моделей, которые вы не загружаете из Nightbreak
• преобразования контента .bbmodel в текущий формат среды выполнения при запуске /fmm reload

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

Официальные паки контента

Текущая версия плагина поставляется с пятью готовыми пакетами под управлением Nightbreak:

• Basic Furniture Pack (реквизит)
• BetterStructures Prop Pack (реквизит)
• EliteMobs Prop Pack (реквизит)
• Craftenmine's Weapons Item Pack (пользовательские предметы)
• Craftenmine Tools Item Pack (пользовательские предметы)

Они отображаются в /fmm setup, могут быть массово загружены через /fmm downloadall и обновлены через /fmm updatecontent. Два пака предметов Craftenmine — это пользовательские предметы (модели с заданным material:), они совместимы с Lua-скриптами предметов.

Напоминание о ресурс-паке

FreeMinecraftModels всегда требует, чтобы сгенерированный ресурс-пак тем или иным способом доходил до клиента.

См. Вывод ресурс-пака для текущих путей вывода и интеграции с ResourcePackManager.