Команды FreeMinecraftModels
Используйте /freeminecraftmodels или /fmm.
Настройка и управление контентом
| Команда | Назначение |
|---|---|
/fmm | Открывает меню крафтящихся предметов для игроков (см. Меню крафтящихся предметов ниже) |
/fmm admin | Открывает админский браузер контента — просмотр установленных паков, папок, моделей и пользовательских предметов (право: freeminecraftmodels.admin) |
/fmm setup | Открывает меню управления контентом / первичной настройки (только для игроков; та самая команда, на которую игрокам указывают при первом запуске) |
/fmm recommendedplugins | Показывает плагины-компаньоны, хорошо сочетающиеся с FreeMinecraftModels (открывает меню-каталог для игроков, выводит список для консоли) |
/fmm downloadall | Скачивает последнее обновление плагина и весь доступный официальный контент, затем выполняет перезагрузку |
/fmm downloadallcontent | Скачивает весь доступный официальный контент (только контент, без обновления jar плагина) |
/fmm updatecontent | Скачивает обновления для устаревшего официального контента (алиас: /fmm updateallcontent) |
/fmm downloadpluginupdate | Скачивает только последнее обновление jar плагина (применяется после следующего перезапуска сервера) |
/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 [radius] | Удаляет все загруженные моделированные сущности и постоянные реквизиты. Без аргумента очищает всё; необязательный [radius] (только для игрока) ограничивает удаление сущностями в пределах указанного числа блоков от игрока |
Поведение размещения реквизита
Когда игрок кликает правой кнопкой по бумажному предмету реквизита (созданному через /fmm itemify или скрафченному по рецепту /fmm craftify), действует следующее:
- Расход предмета: бумажный предмет расходуется при размещении реквизита, кроме режима «Творчество».
- Поворот: реквизит размещается лицом в сторону игрока, со снапом до приращений поворота в 10 градусов. Это позволяет точно управлять ориентацией реквизита просто за счёт того, куда вы смотрите перед размещением.
Меню крафтящихся предметов
Запуск /fmm без аргументов открывает игрокам инвентарь-меню со всеми крафтящимися предметами, для которых настроены рецепты.
- Каждый предмет в меню представляет один крафтящийся FMM-предмет.
- Клик по предмету открывает детальное подменю с пространственной сеткой крафта 3×3, стрелкой и итоговым предметом — показывая игроку, как точно скрафтить его за верстаком.
- Требует право
freeminecraftmodels.menu(по умолчанию:true, доступно всем игрокам).
Админский браузер контента
Запуск /fmm admin открывает администраторам сервера инвентарь-меню для просмотра:
- установленных паков контента
- папок и отдельных моделей
- пользовательских предметов (моделей с заданным
material:)
Требует право freeminecraftmodels.admin (по умолчанию: op).
Конструктор рецептов
Команда /fmm craftify позволяет создать ванильный рецепт верстака для любой модели реквизита.
- Выполните
/fmm craftify <model_id>, чтобы открыть интерфейс конструктора рецептов. - Откроется пользовательский инвентарь с сеткой крафта 3×3 и заранее заполненным итоговым предметом.
- Расположите ингредиенты из своего инвентаря в сетке в любом нужном вам узоре.
- Кликните по итоговому предмету (бумажный предмет реквизита), чтобы сохранить рецепт.
- Частицы и звук подтвердят сохранение.
- Рецепт сохраняется в
plugins/FreeMinecraftModels/recipes/<model_id>.ymlи регистрируется сразу же. - После этого игроки могут крафтить предмет реквизита в любом верстаке.
- Нажмите Escape, чтобы отменить без сохранения — ингредиенты вернутся в ваш инвентарь.
- Повторный запуск craftify для той же модели перезаписывает прежний рецепт.
- Рецепты сохраняются между перезапусками и перезагрузками сервера.
В сохранённые файлы рецептов добавляются поля shopEnabled (по умолчанию true) и shopPrice (по умолчанию из shop_config.yml), которые управляют тем, как рецепт показывается в /fmm shop.
Права доступа
Зарегистрированы в plugin.yml
| Право | По умолчанию | Описание |
|---|---|---|
freeminecraftmodels.* | OP | Wildcard, выдающий freeminecraftmodels.admin, freeminecraftmodels.deleteall, 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 recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent и /fmm downloadpluginupdate |
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 | Разрешает размещать реквизиты и взаимодействовать с ними внутри регионов WorldGuard / приватов GriefPrevention, даже когда включён preventPropPlacementInProtectedRegions |
freeminecraftmodels.menu | true | Доступ к меню крафтящихся предметов /fmm (доступно всем игрокам) |
freeminecraftmodels.shop | true | Доступ к /fmm shop (доступно всем игрокам, когда магазин включён) |
Заметки об отправителе
setup,spawn,itemify,mount,giveitem,craftify,hitbox visualize,location,adminиshop— команды только для игроков.recommendedplugins,downloadall,downloadallcontent,updatecontent,downloadpluginupdateиdeleteallпринимают и игроков, и консоль (радиус дляdeleteallдоступен только игроку).disguiseиundisguiseпринимают целевого игрока и могут запускаться из консоли, если цель указана.versionне имеет ограничений по правам и доступна всем (и игрокам, и консоли).