Comandos do FreeMinecraftModels

Use /freeminecraftmodels ou /fmm.

Configuração e Gerenciamento de Conteúdo

Comando	Finalidade
/fmm	Abre o menu de itens craftáveis para jogadores (veja Menu de Itens Craftáveis abaixo)
/fmm admin	Abre o navegador de conteúdo para admins — navega packs instalados, pastas, modelos e itens customizados (permissão: freeminecraftmodels.admin)
/fmm initialize	Abre o fluxo de configuração inicial (somente jogador)
/fmm setup	Abre o menu de gerenciamento de conteúdo (somente jogador)
/fmm downloadall	Baixa todo o conteúdo oficial atualmente acessível
/fmm updatecontent	Baixa atualizações para conteúdo oficial desatualizado
/fmm reload	Reimporta conteúdo e regenera a saída do pack
/fmm version	Mostra a versão do plugin (sem permissão necessária -- qualquer um pode executar)
/fmm stats	Mostra estatísticas dos modelos carregados

Spawn e Colocação de Modelos

Comando	Finalidade
/fmm spawn static <id>	Spawna um modelo estático
/fmm spawn dynamic <id>	Spawna um modelo dinâmico
/fmm spawn prop <id>	Cria uma entrada persistente de prop e o spawna
/fmm itemify <id> <material>	Cria um item colocável que spawna o modelo escolhido como prop
/fmm mount <id>	Spawna uma montaria experimental usando um cavalo disfarçado
/fmm giveitem <item>	Dá um item customizado FMM ao jogador (permissão: freeminecraftmodels.admin)
/fmm craftify <id>	Abre um construtor de receita interativo — coloque ingredientes em uma grade 3×3 e clique no item de saída para salvar uma receita de crafting para aquele prop

Disfarces de Jogadores

Comando	Finalidade
/fmm disguise <modelID> [player]	Disfarça um jogador como um modelo carregado. Sem argumento de alvo, disfarça o remetente. Com um alvo, requer freeminecraftmodels.disguise.others e funciona no console
/fmm undisguise [player]	Remove o disfarce. Sem alvo, retira o disfarce do remetente. Com alvo, requer freeminecraftmodels.disguise.others e funciona no console
/fmm disguiselist	Lista jogadores atualmente disfarçados e o modelo de cada (permissão: freeminecraftmodels.disguise.others)

Comportamento de disfarce:

• Disfarçar substitui qualquer disfarce anterior daquele jogador de forma limpa.
• Jogadores disfarçados ficam invisíveis para outros jogadores para que apenas o modelo seja visto. A invisibilidade persiste através de baldes de leite e outras interações que limpam efeitos.
• Plugins de terceiros podem controlar disfarces via a DisguiseAPI pública (veja Guia de API e Desenvolvedor).

Loja de Mobília

Comando	Finalidade
/fmm shop	Abre a loja de mobília opcional baseada em Vault onde jogadores podem comprar props craftáveis com moeda do jogo (permissão: freeminecraftmodels.shop, padrão: true)

A loja está desabilitada por padrão e só se registra quando:

• enabled: true em shop_config.yml
• Vault está instalado
• Um provedor de economia compatível com Vault está registrado

Quando qualquer um desses está ausente, /fmm shop fica não registrado (ou mostra a mensagem configurável de "loja desabilitada" se forçado a desabilitar em runtime). Veja Configuração para as chaves de configuração da loja e os campos por receita shopEnabled / shopPrice.

Utilitários

Comando	Finalidade
/fmm hitbox visualize [duration]	Visualiza hitboxes para depuração
/fmm location	Comando de diagnóstico — reporta quantos detectores de dungeon e provedores de proteção estão registrados na LocationAPI, e testa ambos os predicados na sua localização atual (permissão: freeminecraftmodels.*)
/fmm debug bedrock [on|off]	Toggle em runtime para o stream de log [FMM-BedrockDebug] que diagnostica o pipeline de exibição Bedrock. Omita o argumento de estado para reportar se o log está ativo no momento. Sempre volta para OFF no reload do plugin — intencionalmente não é uma chave de config para que não possa ser deixado ligado por acidente. Aceita tanto jogadores quanto console (permissão: freeminecraftmodels.*)
/fmm deleteall	Remove todas as entidades modeladas atualmente carregadas

Comportamento de Colocação de Props

Quando um jogador clica com botão direito usando um item de prop de papel (criado via /fmm itemify ou craftado via uma receita /fmm craftify), o seguinte se aplica:

• Consumo de item: O item de papel é consumido quando o prop é colocado, a menos que o jogador esteja no modo Criativo.
• Rotação: Props são colocados voltados para a direção do jogador, ajustados em incrementos de rotação de 10 graus. Isso dá aos jogadores controle fino sobre a orientação do prop apenas ajustando para onde estão olhando antes de colocar.

Menu de Itens Craftáveis

Executar /fmm sem argumentos abre um menu de inventário para jogadores mostrando todos os itens craftáveis que foram configurados com receitas.

• Cada item no menu representa um item FMM craftável.
• Clicar em um item abre um submenu de detalhes que exibe a grade de crafting espacial 3x3, uma seta e o item de saída — mostrando ao jogador exatamente como craftá-lo em uma mesa de crafting.
• Requer a permissão freeminecraftmodels.menu (padrão: true, disponível para todos os jogadores).

Navegador de Conteúdo para Admins

Executar /fmm admin abre um menu de inventário para administradores de servidor navegarem:

• Packs de conteúdo instalados
• Pastas e modelos individuais
• Itens customizados (modelos com material: definido)

Requer a permissão freeminecraftmodels.admin (padrão: op).

Construtor de Receitas

O comando /fmm craftify permite criar uma receita de mesa de crafting vanilla para qualquer modelo de prop.

1. Execute /fmm craftify <model_id> para abrir a UI do construtor de receitas.
2. Um inventário customizado abre com uma grade de crafting 3×3 e um item de saída pré-preenchido.
3. Coloque ingredientes do seu inventário na grade no padrão que quiser.
4. Clique no item de saída (o item de papel do prop) para salvar a receita.
5. Partículas e um som confirmam o salvamento.
6. A receita é salva em plugins/FreeMinecraftModels/recipes/<model_id>.yml e registrada imediatamente.
7. Jogadores agora podem craftar o item do prop em qualquer mesa de crafting.
8. Pressione Escape para cancelar sem salvar — os ingredientes são devolvidos ao seu inventário.
9. Executar craftify novamente para o mesmo modelo sobrescreve a receita anterior.
10. Receitas persistem entre reinicializações e reloads do servidor.

Arquivos de receita salvos incluem campos shopEnabled (padrão true) e shopPrice (padrão a partir de shop_config.yml) que controlam como a receita é exposta em /fmm shop.

Permissões

Registradas em plugin.yml

Permissão	Padrão	Descrição
freeminecraftmodels.*	OP	Wildcard que concede freeminecraftmodels.admin, freeminecraftmodels.disguise.self e freeminecraftmodels.disguise.others. A string do wildcard é também a permissão literal exigida por /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 e /fmm updatecontent
freeminecraftmodels.admin	OP	Acesso a /fmm admin (o navegador de conteúdo para admins) e /fmm giveitem
freeminecraftmodels.disguise.self	OP	Permite /fmm disguise e /fmm undisguise mirando apenas no remetente
freeminecraftmodels.disguise.others	OP	Permite /fmm disguise <model> <player>, /fmm undisguise <player> e /fmm disguiselist
freeminecraftmodels.menu	true	Acesso ao menu de itens craftáveis /fmm (disponível para todos os jogadores)
freeminecraftmodels.shop	true	Acesso a /fmm shop (disponível para todos os jogadores quando a loja está habilitada)

Verificadas pelos comandos

Permissão	Padrão	Descrição
freeminecraftmodels.deleteall	OP	Acesso a /fmm deleteall (verificada em runtime, não registrada em plugin.yml)

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location e shop são comandos exclusivos para jogadores.
• disguise e undisguise aceitam um jogador alvo e podem ser executados pelo console desde que um alvo seja fornecido.
• version não tem restrição de permissão e pode ser executado por qualquer um (jogadores ou console).