Настройка FreeMinecraftModels
FreeMinecraftModels по-прежнему поддерживает ручной импорт .bbmodel, но текущий процесс настройки рассчитан на Nightbreak и управляется через меню.
Предварительные требования
- Среда выполнения Java 21 для сервера
- Minecraft 1.21.4 или новее: плагин объявляет
api-version: 1.21.4и не загружается на старых версиях - Установленный и хотя бы раз запущенный FreeMinecraftModels, чтобы он создал свои папки данных. MagmaCore входит в jar плагина, поэтому отдельная установка не нужна
- Способ доставить сгенерированный ресурс-пак игрокам
ResourcePackManager — рекомендуемый способ доставки, потому что FreeMinecraftModels только генерирует пак, но не хостит его сам.
Процесс первого запуска
| Команда | Назначение |
|---|---|
/fmm setup | Меню управления контентом / первичной настройки (только для игроков; та самая команда, на которую игрокам указывают при первом запуске) |
/fmm recommendedplugins | Показывает плагины-компаньоны, хорошо сочетающиеся с FreeMinecraftModels |
/fmm downloadall | Помощник массовой установки: скачивает последнее обновление плагина плюс все доступные паки Nightbreak |
/fmm downloadallcontent | Помощник массовой установки доступных паков Nightbreak (только контент) |
/fmm updatecontent | Помощник массового обновления устаревших паков Nightbreak |
/fmm downloadpluginupdate | Скачивает только последнее обновление jar плагина |
/fmm applypluginupdate | Применяет скачанное обновление плагина без перезапуска сервера |
/fmm forcereinstallcontent <package|all> | Повторно скачивает существующий контент для восстановления, даже если версия считается актуальной |
/nightbreaklogin [token] | Общая привязка аккаунта Nightbreak: выводит ссылку для одобрения сервера или сохраняет вставленный токен; требуется nightbreak.login |
/nightbreaklogout | Удаляет сохранённый на этом сервере токен Nightbreak |
Если в config.yml ещё указано setupDone: false, игроки с правом freeminecraftmodels.* получают напоминание примерно через 10 секунд после каждого входа, если остаются онлайн. Открытие /fmm setup сохраняет setupDone: true для всего сервера и прекращает будущие напоминания. Сообщение также упоминает /fmm admin и /fmm. Завершение одного из вариантов в /fmm initialize тоже отмечает настройку выполненной; этот флаг не доказывает установку или доставку пака.
На панели /fmm setup также есть кнопка Pets, которая переключает режим питомцев между косметическими питомцами и дополнительными существами и сохраняет выбор в pets.yml.
Рекомендуемый рабочий процесс
- Установите FreeMinecraftModels и запустите сервер один раз.
- Привяжите сервер к своему аккаунту Nightbreak командой
/nightbreaklogin, затем одобрите его по выведенной ссылке. - Откройте
/fmm setup, чтобы посмотреть доступные паки и текущее состояние. - Используйте
/fmm downloadall, если хотите установить все официальные паки, к которым у вашего токена есть доступ (заодно подтягивается последнее обновление jar плагина). - Позднее используйте
/fmm updatecontentдля обновления устаревших официальных паков. - Дождитесь успешной инициализации и убедитесь, что игроки получают созданный
output/FreeMinecraftModels.zip, обычно через ResourcePackManager. После успешной генерации FMM уведомляет включённый ResourcePackManager, но само уведомление не доказывает доставку клиентам.
Интерактивное скачивание паков перезагружает FMM после изменения контента. Скачанный jar плагина вступает в силу после перезапуска или сразу после /fmm applypluginupdate. /fmm reload проверяет определения предметов, зачарований и рецептов реквизита перед пересборкой. Если проверка отклонена, текущий каталог остаётся активным. Проверяйте результат, прежде чем считать файлы применёнными.
Если вы предпочитаете, чтобы сервер сам подтягивал обновления, задайте nightbreak.autoDownloadPluginUpdates: true в config.yml (по умолчанию false). Скачанные обновления плагина и контента применяются после следующего перезапуска. Чтобы применять обновления плагина без перезапуска, задайте nightbreak.applyPluginUpdatesWithoutRestart значение when-empty или immediately (по умолчанию never). См. Конфигурацию.
Ручной импорт моделей
Прямой импорт моделей по-прежнему работает через:
plugins/FreeMinecraftModels/imports
Этот путь всё ещё полезен для:
- локальной разработки
- пользовательских моделей, которые вы не загружаете из Nightbreak
- преобразования контента
.bbmodelв текущий формат среды выполнения при запуске/fmm reload
И ручной импорт, и загрузка официальных пакетов в итоге требуют прохода reload/import, прежде чем список моделей среды выполнения и ресурс-пак будут пересобраны.
Поместите отдельный .bbmodel прямо в imports/. Этот путь записывает преобразованный .fmmodel в каталог моделей и сохраняет исходный импорт, поэтому следующая перезагрузка может преобразовать его снова. Отдельный сопутствующий .yml при этом не импортируется. Обычные подпапки без pack.meta также не обходятся рекурсивно. Для модели с настройками или скриптами используйте активный каталог models/ и scripts/ либо правильно упакованный архив; см. Заметки по созданию моделей.
Официальные паки контента
Текущая версия плагина поставляется с пятью готовыми пакетами под управлением 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: и используют текущие форматы определений предметов и зачарований. Старым пакам со скриптами экипированных предметов нужен обновлённый контент.
Напоминание о ресурс-паке
FreeMinecraftModels всегда требует, чтобы сгенерированный ресурс-пак тем или иным способом доходил до клиента.
См. Вывод ресурс-пака для текущих путей вывода и интеграции с ResourcePackManager.