Настройка FreeMinecraftModels

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

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

• Java 21 runtime для сервера
• 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

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

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

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

• BetterStructures Prop Pack
• EliteMobs Prop Pack

Они отображаются в /fmm setup, могут быть массово загружены командой /fmm downloadall и обновлены командой /fmm updatecontent.

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

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

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