Команды FreeMinecraftModels

Используйте /freeminecraftmodels или /fmm.

Настройка и управление контентом

Команда	Назначение
/fmm	Открывает меню крафтящихся предметов для игроков (см. Меню крафтящихся предметов ниже)
/fmm admin	Открывает админский браузер контента — просмотр установленных паков, папок, моделей и пользовательских предметов (право: freeminecraftmodels.admin)
/fmm initialize	Открывает меню первичной настройки (только игрок)
/fmm setup	Открывает меню управления контентом (только игрок)
/fmm downloadall	Скачивает весь доступный официальный контент
/fmm updatecontent	Скачивает обновления для устаревшего официального контента
/fmm reload	Заново импортирует контент и перегенерирует вывод пака
/fmm version	Показывает версию плагина (право не требуется — может выполнить любой)
/fmm stats	Показывает статистику по загруженным моделям

Спавн и размещение моделей

Команда	Назначение
/fmm spawn static <id>	Спавнит статическую модель
/fmm spawn dynamic <id>	Спавнит динамическую модель
/fmm spawn prop <id>	Создаёт постоянную запись реквизита и спавнит его
/fmm itemify <id> <material>	Создаёт размещаемый предмет, который спавнит выбранную модель как реквизит
/fmm mount <id>	Спавнит экспериментального ездового маунта на основе замаскированной лошади
/fmm giveitem <item>	Выдаёт пользовательский FMM-предмет игроку (право: freeminecraftmodels.admin)
/fmm craftify <id>	Открывает интерактивный конструктор рецептов — разместите ингредиенты в сетке 3×3 и кликните по итоговому предмету, чтобы сохранить рецепт крафта для этого реквизита

Маскировки игроков

Команда	Назначение
/fmm disguise <modelID> [player]	Маскирует игрока под загруженную модель. Без аргумента-цели маскирует отправителя. С целью требует freeminecraftmodels.disguise.others и работает из консоли
/fmm undisguise [player]	Снимает маскировку. Без аргумента-цели снимает её с отправителя. С целью требует freeminecraftmodels.disguise.others и работает из консоли
/fmm disguiselist	Показывает список замаскированных игроков и модель каждого (право: freeminecraftmodels.disguise.others)

Поведение маскировки:

• При наложении новой маскировки старая аккуратно заменяется.
• Замаскированные игроки делаются невидимыми для других, чтобы виделась только модель. Эта невидимость сохраняется и после ведра молока, и других эффектов, очищающих зелья.
• Сторонние плагины могут управлять маскировкой через публичный DisguiseAPI (см. API и руководство разработчика).

Магазин мебели

Команда	Назначение
/fmm shop	Открывает опциональный магазин мебели на базе Vault, где игроки могут покупать крафтящиеся реквизиты за внутриигровую валюту (право: freeminecraftmodels.shop, по умолчанию: true)

Магазин выключен по умолчанию и регистрируется только когда:

• enabled: true в shop_config.yml
• Установлен Vault
• Зарегистрирован совместимый с Vault экономический провайдер

Если что-то из этого отсутствует, /fmm shop не регистрируется (или показывает настраиваемое сообщение «магазин отключён», если он принудительно выключен во время работы). См. Конфигурацию для ключей конфигурации магазина и полей shopEnabled / shopPrice в рецептах.

Утилиты

Команда	Назначение
/fmm hitbox visualize [duration]	Визуализирует хитбоксы для отладки
/fmm location	Диагностическая команда — сообщает, сколько детекторов подземелий и провайдеров защиты зарегистрировано в LocationAPI, и проверяет оба предиката в вашей текущей позиции (право: freeminecraftmodels.*)
/fmm debug bedrock [on|off]	Переключатель потока логов [FMM-BedrockDebug] во время выполнения, который диагностирует пайплайн отображения для Bedrock. Опустите аргумент состояния, чтобы узнать, включено ли логирование сейчас. Всегда сбрасывается в OFF при перезагрузке плагина — намеренно не сделан ключом конфига, чтобы случайно не остался включённым. Принимает и игроков, и консоль (право: freeminecraftmodels.*)
/fmm deleteall	Удаляет все текущие загруженные моделированные сущности

Поведение размещения реквизита

Когда игрок кликает правой кнопкой по бумажному предмету реквизита (созданному через /fmm itemify или крафченному по рецепту /fmm craftify), действует следующее:

• Расход предмета: бумажный предмет расходуется при размещении реквизита, кроме режима «Творчество».
• Поворот: реквизит размещается лицом в сторону игрока, со снапом до приращений поворота в 10 градусов. Это позволяет точно управлять ориентацией реквизита просто за счёт того, куда вы смотрите перед размещением.

Меню крафтящихся предметов

Запуск /fmm без аргументов открывает игрокам инвентарь-меню со всеми крафтящимися предметами, для которых настроены рецепты.

• Каждый предмет в меню представляет один крафтящийся FMM-предмет.
• Клик по предмету открывает детальное подменю с пространственной сеткой крафта 3×3, стрелкой и итоговым предметом — показывая игроку, как точно крафтить его за верстаком.
• Требует право freeminecraftmodels.menu (по умолчанию: true, доступно всем игрокам).

Админский браузер контента

Запуск /fmm admin открывает администраторам сервера инвентарь-меню для просмотра:

• установленных паков контента
• папок и отдельных моделей
• пользовательских предметов (моделей с заданным material:)

Требует право freeminecraftmodels.admin (по умолчанию: op).

Конструктор рецептов

Команда /fmm craftify позволяет создать ванильный рецепт верстака для любой модели реквизита.

1. Выполните /fmm craftify <model_id>, чтобы открыть интерфейс конструктора рецептов.
2. Откроется пользовательский инвентарь с сеткой крафта 3×3 и заранее заполненным итоговым предметом.
3. Расположите ингредиенты из своего инвентаря в сетке так, как хотите.
4. Кликните по итоговому предмету (бумажный предмет реквизита), чтобы сохранить рецепт.
5. Частицы и звук подтвердят сохранение.
6. Рецепт сохраняется в plugins/FreeMinecraftModels/recipes/<model_id>.yml и регистрируется сразу же.
7. После этого игроки могут крафтить предмет реквизита в любом верстаке.
8. Нажмите Escape, чтобы отменить без сохранения — ингредиенты вернутся в ваш инвентарь.
9. Повторный запуск craftify для той же модели перезаписывает прежний рецепт.
10. Рецепты сохраняются между перезапусками и перезагрузками сервера.

В сохранённые файлы рецептов добавляются поля shopEnabled (по умолчанию true) и shopPrice (по умолчанию из shop_config.yml), которые управляют тем, как рецепт показывается в /fmm shop.

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

Зарегистрированы в plugin.yml

Право	По умолчанию	Описание
freeminecraftmodels.*	OP	Wildcard, выдающий freeminecraftmodels.admin, freeminecraftmodels.disguise.self и freeminecraftmodels.disguise.others. Строка wildcard также является буквальным правом, требуемым для /fmm reload, /fmm stats, /fmm spawn, /fmm itemify, /fmm craftify, /fmm mount, /fmm hitbox visualize, /fmm debug bedrock, /fmm location, /fmm setup, /fmm initialize, /fmm downloadall и /fmm updatecontent
freeminecraftmodels.admin	OP	Доступ к /fmm admin (админский браузер контента) и /fmm giveitem
freeminecraftmodels.disguise.self	OP	Разрешает /fmm disguise и /fmm undisguise только в отношении отправителя
freeminecraftmodels.disguise.others	OP	Разрешает /fmm disguise <model> <player>, /fmm undisguise <player> и /fmm disguiselist
freeminecraftmodels.menu	true	Доступ к меню крафтящихся предметов /fmm (доступно всем игрокам)
freeminecraftmodels.shop	true	Доступ к /fmm shop (доступно всем игрокам, когда магазин включён)

Проверяются командами

Право	По умолчанию	Описание
freeminecraftmodels.deleteall	OP	Доступ к /fmm deleteall (проверяется во время работы, не зарегистрировано в plugin.yml)

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location и shop — команды только для игроков.
• disguise и undisguise принимают целевого игрока и могут запускаться из консоли, если цель указана.
• version не имеет ограничений по правам и доступна всем (и игрокам, и консоли).