Настройка FreeMinecraftModels

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

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

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

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

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

Команда	Назначение
/fmm initialize	Меню первичной настройки (только для игроков)
/fmm setup	Меню управления контентом (только для игроков)
/fmm downloadall	Массовая установка доступных паков Nightbreak
/fmm updatecontent	Массовое обновление устаревших паков Nightbreak
/nightbreaklogin <token>	Регистрация общего токена Nightbreak

Если в config.yml всё ещё указано setupDone: false, игроки с правом freeminecraftmodels.* будут получать при входе напоминание о необходимости запустить /fmm initialize.

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

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

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

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

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.