Команды FreeMinecraftModels

registerCraftingRecipes в config.yml по умолчанию равно true. Для экономики только с покупками установите false и перезапустите сервер: рецепты останутся в меню и магазине, но рецепты крафта Bukkit будут удалены. Инструкции по крафту на этой странице требуют true.

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

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

Команда	Назначение
/fmm	Открывает меню крафтящихся предметов для игроков (см. Меню крафтящихся предметов ниже)
/fmm admin	Открывает админский браузер контента — просмотр установленных паков, папок, моделей и пользовательских предметов (право: freeminecraftmodels.admin)
/fmm setup	Открывает меню управления контентом / первичной настройки (только для игроков; та самая команда, на которую игрокам указывают при первом запуске)
/fmm recommendedplugins	Показывает плагины-компаньоны, хорошо сочетающиеся с FreeMinecraftModels (открывает меню-каталог для игроков, выводит список для консоли)
/fmm downloadall	Скачивает последнее обновление плагина и весь доступный официальный контент. Если контент изменился, FMM перезагружается, чтобы применить его; скачанный jar плагина по-прежнему требует перезапуска сервера. Если шаг обновления плагина не удался из-за отсутствия токена Nightbreak или ошибки аутентификации, шаг с контентом пропускается целиком
/fmm downloadallcontent	Скачивает весь доступный официальный контент (только контент, без обновления jar плагина) и перезагружается, если изменился хотя бы один пакет
/fmm updatecontent	Скачивает обновления для устаревшего официального контента и перезагружается, если изменился хотя бы один пакет (алиас: /fmm updateallcontent)
/fmm downloadpluginupdate	Скачивает только последнее обновление jar плагина (применяется после следующего перезапуска сервера)
/fmm forcereinstallcontent <package|all>	Команда восстановления — заново скачивает уже имеющийся у вас контент, даже когда номера версий говорят, что он актуален. Автодополняет all и все слаги пакетов Nightbreak. all охватывает все пакеты, определённые как скачанные; если файлы пака отсутствуют полностью, укажите его слаг напрямую. После этого перезагружается (право: freeminecraftmodels.*)
/fmm reload	Заново импортирует контент и перегенерирует вывод пака
/fmm version	Показывает версию плагина (право не требуется — может выполнить любой)
/fmm stats	Показывает статистику по загруженным моделям

Общие команды Nightbreak

Они регистрируются MagmaCore, а не самим FreeMinecraftModels, поэтому это команды верхнего уровня, а не подкоманды /fmm.

Команда	Назначение
/nightbreaklogin <token>	Сохраняет общий токен аккаунта Nightbreak для этого сервера, открывая доступ к загрузке официального контента и обновлений плагина (право: nightbreak.login, по умолчанию: op). Регистрируется один раз на сервер — владельцем становится тот плагин Nightbreak, который загрузился первым
/nightbreaklogout	Удаляет сохранённый токен аккаунта Nightbreak с этого сервера (право: nightbreak.login, по умолчанию: op). Принимает и игроков, и консоль
/freeminecraftmodelschangelog [dismiss|disable]	Показывает непрочитанные заметки о выпусках FreeMinecraftModels (релизы плагина и отслеживаемые пакеты контента). dismiss помечает показанные заметки как прочитанные; disable навсегда скрывает напоминания об изменениях лично для вас. Только для игроков и только для админов — игроку нужно freeminecraftmodels.*, одно из прав setup/admin или OP. Если метка /freeminecraftmodelschangelog уже занята другим плагином, команда регистрируется под запасным именем с пространством имён, например /freeminecraftmodels:freeminecraftmodelschangelog

Админов с непрочитанными заметками о выпусках при входе подталкивают в чате кликабельной подсказкой [VIEW CHANGELOG]; в представлении дайджеста есть кнопки Dismiss These Updates и Never Show Changelogs, делающие то же, что и две подкоманды. Состояние прочтения по каждому игроку хранится в plugins/FreeMinecraftModels/nightbreak-changelogs.yml.

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

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

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

Команда	Назначение
/fmm disguise <modelID> [player]	Маскирует игрока под загруженную модель. Без аргумента-цели маскирует отправителя. С целью требует freeminecraftmodels.disguise.self + freeminecraftmodels.disguise.others и работает из консоли
/fmm undisguise [player]	Снимает маскировку. Без аргумента-цели снимает её с отправителя. С целью требует freeminecraftmodels.disguise.self + 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|props> [on|off]	Переключатели диагностических потоков логов FMM во время выполнения. bedrock переключает поток [FMM-BedrockDebug], диагностирующий пайплайн отображения для Bedrock; props включает сканирование наложенных реквизитов, из-за которого при каждой загрузке чанка сообщается о любых двух реквизитах в пределах 0.1 блока друг от друга как STACKED PROPS DETECTED. Опустите аргумент состояния, чтобы узнать текущее состояние, не меняя его. Принимаются on/true/enable/enabled и off/false/disable/disabled. Оба переключателя всегда сбрасываются в OFF при перезагрузке плагина — намеренно не сделаны ключами конфига, чтобы случайно не остались включёнными. Принимает и игроков, и консоль (право: freeminecraftmodels.*)
/fmm packetdebug [ticks]	Одноразовая диагностика пакетной нагрузки. Сэмплирует трафик пакетов моделированных сущностей в течение следующих [ticks] тиков модельных часов (по умолчанию 1, максимум 200) и сообщает логические пакеты/тик, фактически доставленные пакеты/тик с учётом размножения по зрителям, худшего одиночного игрока за тик, разбивку по типам пакетов и самых тяжёлых зрителей. Автодополняет 1, 5, 20, 60. Запускайте, стоя в лагающей зоне. Счётчики пакетов точны; цифры в байтах — оценки. Завершается по таймауту с предупреждением, если сэмпл не получен (нет загруженных моделированных сущностей или NMS отключён). Принимает и игроков, и консоль (право: freeminecraftmodels.*)
/fmm deleteall [radius]	Удаляет все загруженные моделированные сущности и постоянные реквизиты. Без аргумента очищает всё; необязательный [radius] (только для игрока) ограничивает удаление сущностями в пределах указанного числа блоков от игрока

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

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

• Расход предмета: бумажный предмет расходуется при размещении реквизита, кроме режима «Творчество».
• Поворот: реквизит размещается лицом в сторону игрока, со снапом до приращений поворота в 10 градусов. Это позволяет точно управлять ориентацией реквизита просто за счёт того, куда вы смотрите перед размещением.
• Один реквизит одной модели на блок: размещение отклоняется сообщением A prop of that model already exists on this block., когда реквизит той же модели уже загружен на этом блоке. При отклонённом размещении предмет не расходуется.
• Только основная рука: реквизит размещает только «основная» половина события взаимодействия, поэтому один клик правой кнопкой больше не может породить два реквизита.
• Очистка дубликатов: при старте сервера и при каждой загрузке чанка FreeMinecraftModels ищет стойки для брони реквизитов, у которых совпадают модель и блок, оставляет одну и удаляет остальные. Удаления пишутся в лог как [FMM Props] Removed N duplicate prop armor stand(s) ....

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

Запуск /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. Рецепты сохраняются между перезапусками и перезагрузками сервера.

Формат файла рецепта

isEnabled: true
model_id: "wooden_chair"
shape:
  - "L L"
  - "LLL"
  - "L L"
ingredients:
  L: OAK_LOG
shopEnabled: true
shopPrice: 250.0

Поле	Обязательное	Заметки
isEnabled	да (по умолчанию true)	Установите false, чтобы снять рецепт с регистрации, не удаляя файл
model_id	да	Модель, которую размещает скрафченный бумажный предмет. ID модели с суффиксом состояния лука/арбалета автоматически переписывается в базовый ID модели
shape	да	До трёх строк по три символа. Пробел означает «пустая ячейка»
ingredients	да	Отображение одного символа узора на имя материала Bukkit. Нераспознанные материалы молча отбрасываются
shopEnabled	нет (по умолчанию true)	Показывается ли рецепт в /fmm shop
shopPrice	нет (по умолчанию defaultPrice из shop_config.yml)	Стоимость в валюте Vault в магазине

Ключ зарегистрированного рецепта Bukkit — freeminecraftmodels:prop_recipe_<model_id>, а результатом всегда является бумажный предмет размещения этой модели. Повторный запуск /fmm craftify для той же модели перезаписывает файл и заново регистрирует рецепт под тем же ключом.

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

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

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

Команды disguise и undisguise с указанным игроком требуют одновременно freeminecraftmodels.disguise.self и freeminecraftmodels.disguise.others. Для disguiselist достаточно .others.

Зарегистрированы MagmaCore

Право	По умолчанию	Описание
nightbreak.login	OP	Требуется для общих команд /nightbreaklogin и /nightbreaklogout. Регистрируется один раз на сервер тем плагином Nightbreak, который загрузился первым

Заметки об отправителе

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location, admin и shop — команды только для игроков. /freeminecraftmodelschangelog тоже только для игроков.
• recommendedplugins, downloadall, downloadallcontent, updatecontent, downloadpluginupdate, forcereinstallcontent, packetdebug, debug, deleteall, /nightbreaklogin и /nightbreaklogout принимают и игроков, и консоль (радиус для deleteall доступен только игроку).
• disguise и undisguise принимают целевого игрока и могут запускаться из консоли, если цель указана.
• version не имеет ограничений по правам и доступна всем (и игрокам, и консоли).
• /fmm initialize открывает меню первичной настройки для игроков с freeminecraftmodels.*. Для обычного управления контентом используйте /fmm setup.