Перейти к основному содержимому

FAQ по FreeMinecraftModels

Если у вас есть вопрос, которого нет в этом списке, загляните в боковую панель, чтобы узнать, есть ли посвящённая ему страница в вики!

Начало работы

Как установить и использовать FreeMinecraftModels?​

Информация

Установка:

  1. Скачайте FreeMinecraftModels.jar и поместите его в папку plugins
  2. Перезапустите сервер для создания папок плагина
  3. Выполните /fmm initialize, если хотите пройти процедуру первоначальной настройки
  4. Если вы используете официальные пакеты контента, привяжите Nightbreak командой /nightbreaklogin <token>
  5. Используйте /fmm setup или /fmm downloadall для официального контента, управляемого через Nightbreak
  6. Для ручного контента поместите файлы .bbmodel в ~/plugins/FreeMinecraftModels/imports/ и выполните /fmm reload
  7. Найдите сгенерированный ресурспак в ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip

Распространение ресурспака:

Выберите один из этих методов:

  • Вариант А (Рекомендуемый): Установите Resource Pack Manager для автоматического распространения
  • Вариант Б: Настройте вручную через server.properties или хостинг-сервис

Спавн моделей:

  • /fmm spawn static <id> - Заспавнить временную декоративную модель
  • /fmm spawn dynamic <id> - Заспавнить модель, привязанную к сущности
  • /fmm spawn prop <id> - Заспавнить постоянную модель в мире

Управление:

  • /fmm - Показать сводку настройки/помощи
  • /fmm initialize - Открыть меню первоначальной настройки
  • /fmm setup - Открыть меню управления контентом
  • /fmm downloadall - Скачать весь доступный официальный контент
  • /fmm updatecontent - Обновить устаревший официальный контент
  • /fmm reload - Перезагрузить плагин и конвертировать новые модели
  • /fmm version - Показать версию плагина
  • /fmm stats - Показать статистику количества сущностей

Функции для игроков:

  • /fmm disguise <modelID> - Превратить вашу внешность в пользовательскую модель
  • /fmm undisguise - Снять маскировку и восстановить обычный вид
  • /fmm itemify <model> <material> - Создать размещаемый предмет, который спавнит указанную модель
  • /fmm craftify <modelID> - Открыть интерактивный конструктор рецептов для создания рецепта крафта пропса
  • /fmm mount <modelID> - Заспавнить ездовую лошадь, замаскированную под пользовательскую модель (экспериментально)

Отладка:

  • /fmm hitbox visualize [duration] - Визуализировать хитбоксы моделей с помощью частиц (duration в тиках, по умолчанию 100)

Администрирование:

  • /fmm deleteall - Удалить все загруженные моделированные сущности (используйте с осторожностью — запроса на подтверждение нет)

Права доступа:

  • freeminecraftmodels.* - Требуется для большинства команд (disguise, itemify, mount, hitbox visualize, spawn)
  • freeminecraftmodels.deleteall - Требуется для команды /fmm deleteall

Команды по умолчанию доступны только операторам. При необходимости выдайте эти права обычным игрокам.

Возможности и ограничения моделей

Каковы ограничения размеров и вращения моделей?​

Информация

Ограничения размера:

  • Максимум: 112x112x112 пикселей (7x7x7 игровых блоков)
  • FreeMinecraftModels использует внутреннее масштабирование 4x для достижения этих размеров
  • Стандартные ресурспаки Minecraft ограничены меньшими размерами

Ограничения вращения кубов:

  • Допустимые углы: 0°, ±22.5°, ±45° и кратные 22.5° (начиная с v2.3.0)
  • Вращение только по одной оси
  • Пример: [22.5, 0, 0] работает, но [22.5, 0, 45] поворачивается лишь частично
  • Другие углы не будут отображаться корректно

Вращение костей:

  • Кости поддерживают любой угол вращения
  • Избегайте стандартных положений покоя 90°, -90°, 180°, -180° (может вызвать неожиданное поведение)
  • Поддерживается многоосевое вращение
  • Каждая кость создаёт отдельную сущность (учитывайте производительность)

Примечание о производительности:

Сохраняйте количество костей как можно меньшим. Каждая кость создаёт отдельную сущность в Minecraft, что может повлиять на производительность сервера при масштабировании.

Какие анимации поддерживаются?​

Информация

FreeMinecraftModels поддерживает эти стандартные анимации состояний:

Стандартные анимации:

  • Walk (Ходьба)
  • Idle (Покой)
  • Death (Смерть)
  • Attack (Атака)
  • Spawn (Появление)

Как это работает:

  • Создайте анимации в BlockBench
  • Плагин считывает ключевые кадры анимации из файлов .bbmodel
  • Анимации запускаются автоматически на основе состояния сущности
  • Разработчики могут запускать анимации программно с помощью playAnimation(animationName, false, false)

Особый случай:

Сущности Вызывателя обнаруживают ближайшие Клыки Вызывателя для автоматического запуска анимации атаки.

Что такое виртуальные кости и как они работают?​

Информация

Виртуальные кости — это специальные кости с зарезервированными именами, которые добавляют функциональность вашим моделям:

Кости хитбокса:

  • Имя: hitbox
  • Создаёт зоны взаимодействия и коллизии
  • Определяет границы сущности с совпадающими значениями x/z

Кости таблички имени:

  • Префикс: tag_
  • Отображает текст над моделями
  • Используется для именования сущностей

Кости вращения головы:

  • Префикс: h_
  • Вращается в зависимости от положения головы игрока/сущности
  • Автоматически отслеживает движение головы

Использование:

Создайте кость в BlockBench с одним из этих специальных имён, и плагин автоматически применит соответствующую функциональность.

FAQ по устранению неполадок

Вместо пользовательских моделей я вижу только конскую броню.​

Информация

Если вместо пользовательских моделей в игре вы видите только конскую броню, скорее всего проблема в том, что вы неправильно объединили ресурспак FMM с вашим существующим ресурспаком.

MagmaGuy разработал плагин Resource Pack Manager (RSPM), который может автоматически объединять ресурспаки. Вы можете скачать его на Spigot здесь.

Просто поместите .jar файл RSPM в папку plugins, и RSPM позаботится обо всём. Он объединит все ресурспаки, автоматически разместит их на хостинге и распространит игрокам при входе на сервер.

Почему я не вижу свою модель после добавления файла .bbmodel?​

Информация

Если ваша модель не отображается, проверьте эти распространённые проблемы:

1. Забыли перезагрузить

Выполните /fmm reload после размещения файлов .bbmodel в папке imports. Это конвертирует модели и генерирует ресурспак.

2. Ресурспак не применён

Игроки должны иметь активный ресурспак FMM, чтобы видеть модели.

  • Проверьте ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip на наличие сгенерированного пака
  • Установите Resource Pack Manager для автоматического распространения
  • ИЛИ распространяйте вручную через server.properties или хостинг-сервис

3. Неправильное расположение файла

Файлы .bbmodel для ручного импорта должны помещаться в: ~/plugins/FreeMinecraftModels/imports/

Если вы используете официальные пакеты контента, используйте /fmm setup или /fmm downloadall вместо ручного размещения файлов.

4. Модель содержит ошибки

Проверьте журналы консоли на наличие сообщений об ошибках при выполнении /fmm reload. Распространённые проблемы включают неподдерживаемые вращения, слишком большие модели или проблемы с текстурами.

5. Проблема объединения ресурспаков

Если вы видите конскую броню вместо моделей, ресурспаки не были правильно объединены. Используйте Resource Pack Manager (RSPM) для автоматического объединения.

ViaVersion может приводить к неправильному отображению ресурспаков.​

Информация

ViaVersion может вызывать проблемы с ресурспаками, особенно при работе сервера на версии ниже 1.21.4. В Minecraft были внесены изменения в обработку ресурспаков начиная с версии 1.21.4. Если вы запускаете сервер на версии вроде 1.21.3 и используете ViaVersion для подключения клиентов 1.21.4, эти клиенты могут столкнуться с проблемами отображения определённого содержимого ресурспаков, например пользовательских моделей из FMM (FreeMinecraftModels).

Это происходит потому, что система ресурспаков в Minecraft изменилась с обновлением 1.21.4.

Примечание: Это ограничение Minecraft и ViaVersion, а не FreeMinecraftModels. Трансляция протокола ViaVersion может не полностью поддерживать изменения ресурспаков при работе на серверных версиях ниже 1.21.4.

Для решения этой проблемы рассмотрите обновление сервера до версии 1.21.4 или выше, так как это обеспечит лучшую совместимость с современными возможностями ресурспаков, включая пользовательские модели FMM.

Почему мои модели вызывают лаги или проблемы с производительностью?​

Информация

Каждая кость в вашей модели BlockBench создаёт отдельную сущность в Minecraft. Модели с большим количеством костей могут влиять на производительность сервера.

Советы по оптимизации:

  • Минимизируйте количество костей в моделях
  • Ограничьте количество заспавненных моделей
  • Рассмотрите использование статичных моделей вместо динамических, когда анимации не нужны
  • Избегайте спавна множества моделей с большим количеством костей рядом друг с другом

Техническое объяснение:

FreeMinecraftModels рендерит каждую кость как отдельную сущность Minecraft. Модель с 50 костями создаёт 50 сущностей. При масштабировании это влияет на производительность.

Лучшие практики:

  • Проектируйте модели с меньшим количеством костей
  • Тестируйте производительность с реалистичным количеством спавнов
  • Следите за TPS сервера при добавлении новых моделей

Расширенные функции

Нужен ли мне Resource Pack Manager (RSPM)?​

Информация

Resource Pack Manager (RSPM) необязателен, но настоятельно рекомендуется.

Что делает RSPM:

  • Автоматически объединяет ресурспаки от нескольких плагинов
  • Размещает ресурспаки на хостинге (внешний хостинг не нужен)
  • Автоматически распространяет паки игрокам при входе
  • Исключает ручную настройку ресурспаков

Без RSPM:

Вам придётся вручную:

  • Объединять ресурспак FMM с существующими серверными ресурспаками
  • Размещать объединённый пак на внешнем сервисе или через server.properties
  • Настраивать сервер для отправки пака игрокам
  • Обновлять пак каждый раз при добавлении новых моделей

Зачем использовать RSPM:

Большинство проблем «конская броня вместо моделей» вызваны неправильным объединением ресурспаков. RSPM решает это автоматически.

Скачать RSPM: https://www.spigotmc.org/resources/resource-pack-manager.118574/

Разработан MagmaGuy, тем же автором, что и FreeMinecraftModels.

Могу ли я использовать FreeMinecraftModels в своём плагине?​

Информация

Да, FreeMinecraftModels предоставляет API для разработчиков.

Интеграция через Maven/Gradle:

Репозиторий: https://repo.magmaguy.com/releases

Артефакт:

  • GroupId: com.magmaguy
  • ArtifactId: FreeMinecraftModels
  • Scope: provided (должен быть установлен на сервере, не включайте в jar)

Основные классы API:

  • ModeledEntity (базовый класс)
  • StaticEntity
  • DynamicEntity
  • PropEntity

Пример использования:

StaticEntity staticEntity = StaticEntity.create(id, location);
if (staticEntity == null) {
    Bukkit.getLogger().warning("Failed to create model");
    return;
}
staticEntity.setRightClickCallback(...);
staticEntity.remove();

Важно:

Не включайте FreeMinecraftModels в свой плагин через shade. Он должен быть установлен отдельно на сервере.

Подробную документацию по API см. в официальном README.

Как замаскировать игрока под пользовательскую модель?​

Информация

Команда /fmm disguise превращает внешний вид игрока в любую пользовательскую модель.

Команда:

/fmm disguise <modelID>

Как это работает:

  • Делает игрока невидимым для других игроков
  • Накладывает пользовательскую модель на позицию игрока
  • Модель следует за движениями игрока
  • Идеально для ролевых серверов или особых событий

Пример:

/fmm disguise dragon

Чтобы снять маскировку:

/fmm undisguise

Требования:

  • Право доступа: freeminecraftmodels.*
  • modelID должен быть валидной конвертированной моделью в папке models

Примечания:

  • Хитбокс игрока остаётся неизменным (та же коллизия)
  • Другие игроки видят пользовательскую модель вместо скина игрока
  • Эффект невидимости действует до тех пор, пока вы не снимете маскировку

Как создать размещаемые предметы-модели?​

Информация

Команда /fmm itemify создаёт специальные предметы, которые игроки могут использовать для размещения моделей в мире.

Команда:

/fmm itemify <model> <material>

Параметры:

  • model - Любой валидный идентификатор модели из папки models
  • material - Любой материал Minecraft (STICK, PAPER, DIAMOND и т.д.)

Пример:

/fmm itemify lamp_post STICK

Что создаётся:

  • Пользовательский предмет с форматированным золотым отображаемым именем (например, «✦ Wolf ✦»)
  • Описательный лор, объясняющий предмет
  • Предмет добавляется прямо в ваш инвентарь
  • Клик правой кнопкой мыши для размещения модели как пропса

Варианты использования:

  • Давать игрокам предметы для украшения построек
  • Создавать пользовательские «яйца призыва» для мебели
  • Распространять модели без выдачи прав на строительство
  • Наборы для творческого строительства

Требования:

  • Право доступа: freeminecraftmodels.*
  • Игрок должен быть в игре (не консоль)

Как отладить хитбоксы моделей?​

Информация

Команда /fmm hitbox visualize визуализирует хитбоксы моделей с помощью частиц.

Команда:

/fmm hitbox visualize [duration]

Параметры:

  • duration (необязательно) - Как долго показывать хитбоксы в тиках (по умолчанию: 100, максимум: 1200)
  • 20 тиков = 1 секунда

Примеры:

/fmm hitbox visualize          # Показать на 5 секунд
/fmm hitbox visualize 200      # Показать на 10 секунд

Как это работает:

  • Ищет модели в радиусе 10 блоков от вас
  • Отображает границы ориентированного ограничивающего параллелепипеда (OBB) с помощью частиц
  • Показывает и модель, и её границы коллизии
  • Полезно для проверки размера и вращения хитбокса

Когда использовать:

  • Проверка соответствия хитбоксов визуальным моделям
  • Отладка проблем взаимодействия
  • Проверка вращений хитбоксов
  • Устранение проблем обнаружения кликов

Требования:

  • Право доступа: freeminecraftmodels.*

Примечание: Хитбоксы в FMM вращаются вместе с моделью, в отличие от стандартных AABB в Minecraft.

Можно ли создать ездовые пользовательские модели?​

Информация

Да, используйте команду /fmm mount для создания ездовых пользовательских моделей (экспериментальная функция).

Команда:

/fmm mount <modelID>

Что делает:

  • Спавнит лошадь в вашей позиции
  • Маскирует лошадь под вашу пользовательскую модель
  • Автоматически приручает лошадь и надевает седло
  • Сразу сажает вас на лошадь

Пример:

/fmm mount dragon

Требования:

  • Право доступа: freeminecraftmodels.*
  • Валидный идентификатор модели

Важные замечания:

  • Эта функция отмечена как экспериментальная
  • Скорость передвижения и поведение соответствуют стандартной лошади
  • Хитбокс лошади остаётся неизменным
  • Лучше всего работает с моделями, разработанными для ездовых животных

Варианты использования:

  • Пользовательские ездовые животные для ролевых серверов
  • Особый транспорт для VIP-игроков
  • Уникальные ездовые существа для карт приключений