Comandos do FreeMinecraftModels

registerCraftingRecipes em config.yml tem a predefinição true. Para uma economia baseada apenas em compras, defina false e reinicie: as entradas válidas e ativadas continuam no catálogo da loja, mas são removidas do fabrico Bukkit e do menu de itens fabricáveis /fmm dos jogadores. As instruções de fabrico seguintes exigem true.

Use /freeminecraftmodels ou /fmm.

Instalação e gestão de conteúdo

Comando	Finalidade
/fmm	Abre o menu de itens fabricáveis para jogadores; consulte Menu de itens fabricáveis
/fmm admin	Abre o catálogo de administração com pacotes, pastas, modelos e itens personalizados; exige freeminecraftmodels.admin
/fmm setup	Abre o menu de gestão de conteúdo e instalação inicial, apenas para jogadores. É o comando indicado no primeiro arranque
/fmm recommendedplugins	Apresenta plugins complementares: um catálogo para jogadores ou uma lista na consola
/fmm downloadall	Descarrega a atualização mais recente do plugin e todo o conteúdo oficial disponível. Se houver alterações ao conteúdo, recarrega o FMM para as aplicar. O JAR descarregado entra em vigor após um reinício, após /fmm applypluginupdate ou conforme definido em nightbreak.applyPluginUpdatesWithoutRestart. Se a atualização do plugin falhar por falta de token Nightbreak ou erro de autenticação, a etapa de conteúdo não é executada
/fmm downloadallcontent	Descarrega todo o conteúdo oficial disponível, sem atualizar o JAR, e recarrega se pelo menos um pacote mudar
/fmm updatecontent	Descarrega atualizações de conteúdo oficial desatualizado e recarrega se pelo menos um pacote mudar. Também disponível como /fmm updateallcontent
/fmm downloadpluginupdate	Descarrega apenas o JAR mais recente. Entra em vigor após o próximo reinício, a menos que execute /fmm applypluginupdate ou defina nightbreak.applyPluginUpdatesWithoutRestart
/fmm applypluginupdate	Aplica uma atualização do plugin já descarregada sem reiniciar o servidor. O FMM e todos os plugins ativos do MagmaGuy que dependem dele, diretamente ou por soft-depend, são desativados, o JAR é substituído e voltam a ser carregados e ativados. É recusado quando não há nenhuma atualização mais recente à espera ou quando um plugin de outro autor depende do FMM. Se o novo JAR não ativar, o JAR anterior é carregado novamente e a atualização fica preparada para o próximo reinício. Aceita jogadores e consola. Exige freeminecraftmodels.*
/fmm forcereinstallcontent <package|all>	Repara conteúdo, voltando a descarregá-lo mesmo que a versão esteja atualizada. A conclusão com Tab oferece all e os identificadores dos pacotes Nightbreak. all abrange os pacotes detetados como descarregados; se os ficheiros estiverem totalmente ausentes, indique diretamente o identificador. Recarrega no final. Exige freeminecraftmodels.*
/fmm reload	Importa e valida os itens, os encantamentos e as receitas de elementos decorativos definidos pelos autores e, se tiver sucesso, reinicializa completamente configurações, receitas, modelos e pacote gerado. A validação pode recusar o recarregamento e manter o catálogo atual ativo
/fmm version	Mostra a versão do plugin, sem exigir permissão
/fmm stats	Mostra estatísticas dos modelos carregados

Comandos partilhados do Nightbreak

Estes comandos são registados pelo MagmaCore. São comandos independentes, sem o prefixo /fmm.

Comando	Finalidade
/nightbreaklogin [token]	Vincula este servidor à sua conta Nightbreak, permitindo descarregar conteúdo oficial e atualizações. Sem token, imprime uma ligação do nightbreak.io para aprovar; com um token, guarda esse token. Exige nightbreak.login, com predefinição op. É registado uma vez, pelo primeiro plugin Nightbreak a carregar
/nightbreaklogout	Remove o token Nightbreak guardado no servidor. Exige nightbreak.login, com predefinição op. Aceita jogadores e consola
/nightbreak plugins	Mostra o catálogo de plugins do Nightbreak, como um menu para jogadores e como lista no chat na consola (permissão: nightbreak.plugins, predefinição: op). Registado uma vez por servidor, tal como /nightbreaklogin. Consulte Configuração e gestão de conteúdo do Nightbreak
/freeminecraftmodelschangelog [dismiss|disable]	Mostra notas de atualização não lidas do FreeMinecraftModels e dos pacotes de conteúdo acompanhados. dismiss marca as notas apresentadas como lidas; disable oculta permanentemente os lembretes para esse jogador. Só aceita jogadores administradores, com freeminecraftmodels.*, uma permissão de instalação/administração ou OP. Se o nome do comando estiver ocupado por outro plugin, regista-o com um espaço de nomes, como /freeminecraftmodels:freeminecraftmodelschangelog

Ao entrar no servidor, os administradores com notas não lidas recebem um aviso clicável [VIEW CHANGELOG]. O resumo inclui botões para dispensar estas atualizações e nunca mostrar notas de atualização, equivalentes aos dois subcomandos. O estado de leitura de cada jogador fica em plugins/FreeMinecraftModels/nightbreak-changelogs.yml.

Criação e colocação de modelos

Comando	Finalidade
/fmm spawn static <id>	Cria um modelo estático acima do bloco visado, usando um raio de deteção de blocos até 300 blocos
/fmm spawn dynamic <id>	Cria um modelo sobre um porco oculto acima do bloco visado, com o mesmo raio de 300 blocos
/fmm spawn prop <id>	Cria um elemento decorativo persistente na posição atual do jogador. Recusa com A prop of that model already exists on this block. se já houver um elemento carregado desse modelo no mesmo bloco
/fmm itemify <id> <material>	Cria um item de colocação com o material Bukkit indicado. Use o nome da enumeração em maiúsculas, como PAPER. O item recebe o name e a lore do .yml de elemento decorativo do modelo, quando definidos. Não cria um item de mão definido pelo autor
/fmm mount <id> [scale]	Cria uma montada experimental: um cavalo domesticado e com sela que veste o modelo, e que o jogador monta e conduz. A escala opcional, acima de 0 e até 16, dimensiona o cavalo e o seu modelo; a conclusão com Tab sugere 1.0, 2.0 e 3.0. Consulte modelos personalizados montáveis
/fmm giveitem <item>	Entrega um item FMM registado e definido pelo autor; os IDs não distinguem maiúsculas de minúsculas. Exige freeminecraftmodels.admin
/fmm craftify <id>	Abre um editor interativo de receitas. Coloque ingredientes numa grelha 3×3 e clique no resultado para guardar a receita do elemento decorativo

Os comandos de criação direta não executam as verificações de proteção e espaço livre do item de colocação. Deixe uma posição livre no inventário para itemify e giveitem: estes comandos ignoram os itens que não cabem, em vez de os largarem no chão.

Disfarces de jogadores

Comando	Finalidade
/fmm disguise <modelID> [player]	Aplica um modelo carregado como disfarce. Sem alvo, disfarça quem executa o comando. Com alvo, exige freeminecraftmodels.disguise.self e freeminecraftmodels.disguise.others e funciona na consola
/fmm undisguise [player]	Remove o disfarce. Sem alvo, afeta quem executa o comando. Com alvo, exige freeminecraftmodels.disguise.self e freeminecraftmodels.disguise.others e funciona na consola
/fmm disguiselist	Lista os jogadores disfarçados e os respetivos modelos; exige freeminecraftmodels.disguise.others

Comportamento dos disfarces:

• Um novo disfarce substitui o anterior do mesmo jogador.
• Os jogadores disfarçados e o seu equipamento ficam ocultos aos observadores. Se o disfarce adicionou a invisibilidade, restaura-a após beber leite, remover efeitos ou reaparecer. Este mecanismo não controla nem restaura uma invisibilidade que já existia antes do disfarce.
• Outros plugins podem controlar disfarces através da API pública DisguiseAPI. Consulte o Guia da API e desenvolvimento.

Mascotes

Comando	Finalidade
/fmm pets	Abre o menu das suas mascotes, onde as leva consigo ou as manda para casa (permissão: freeminecraftmodels.pets)
/fmm petadmin mode [creatures|cosmetic]	Mostra o modo das mascotes, ou altera-o e guarda-o em pets.yml (permissão: freeminecraftmodels.pets.admin)
/fmm petadmin list	Lista as espécies de mascotes carregadas, com o respetivo ficheiro, modelo, corpo, comida de domesticação e comida de reprodução (permissão: freeminecraftmodels.pets.admin)
/fmm petadmin spawn <species>	Faz aparecer uma mascote selvagem da espécie sobre o bloco para onde olha, até 12 blocos de distância. Só funciona no modo CREATURES (permissão: freeminecraftmodels.pets.admin)
/fmm petadmin give <species>	Acrescenta um adulto da espécie à sua própria coleção de mascotes (permissão: freeminecraftmodels.pets.admin)
/fmm petmigrate [species]	Envia agora um bando de migração noturna sobre si, seja qual for a hora ou o céu (permissão: freeminecraftmodels.pets.admin)

Consulte Mascotes para os ficheiros de espécie, o pets.yml e os dois modos de mascotes.

Loja de mobília

Comando	Finalidade
/fmm shop	Abre a loja opcional integrada com o Vault, onde os jogadores compram elementos decorativos fabricáveis com moeda do jogo. Exige freeminecraftmodels.shop, com predefinição true

A loja está desativada por predefinição e só é registada se:

• shop_config.yml contiver enabled: true.
• O Vault estiver instalado.
• Existir um fornecedor de economia compatível com o Vault registado.

Se faltar algum requisito, /fmm shop não é registado. Uma loja ativada sem Vault ou fornecedor de economia regista um aviso. Um comando registado pode devolver a mensagem configurada de desativação se a configuração ou a ligação em cache indicar esse estado; não deteta continuamente a remoção do fornecedor. Consulte Configuração para as opções da loja e os campos shopEnabled e shopPrice de cada receita.

Utilitários

Comando	Finalidade
/fmm hitbox visualize [duration]	Mostra as hitboxes dos modelos a menos de 10 blocos no mesmo mundo e as entidades subjacentes. A duração é em ticks, com a predefinição 100 (cinco segundos); valores não positivos ou não numéricos usam 100 e valores superiores a 1200 usam 1200
/fmm location	Indica os detetores de dungeons e fornecedores de proteção registados e consulta is_in_dungeon / is_protected na sua posição. Estes predicados de localização não são a verificação de colocação que considera o jogador. Exige freeminecraftmodels.*
/fmm debug <bedrock|props> [on|off]	Ativa ou desativa os registos [FMM-BedrockDebug] ou a procura STACKED PROPS DETECTED de pares de elementos até 0,1 blocos durante as operações de limpeza. Sem um estado, indica se essa opção está ativa. Também aceita true/enable/enabled e false/disable/disabled. Ambos aceitam jogadores e consola. Exige freeminecraftmodels.*
/fmm packetdebug [ticks]	Recolhe tráfego dos modelos durante o número indicado de ticks do relógio de modelos, com a predefinição 1, limitado a 1–200 (inteiros inválidos usam 1). Indica pacotes lógicos e entregues por tick, distribuição por observador, pior jogador/tick, tipos de pacote e observadores com maior carga. Completa 1, 5, 20, 60. Execute na zona afetada. As contagens são exatas para o tráfego instrumentado; os bytes são estimados. Só é executada uma amostra de cada vez. Avisa após 400 ticks do servidor sem nova amostra. Aceita jogadores e consola. Exige freeminecraftmodels.*
/fmm filmic [on|off]	Ativa ou desativa temporariamente o modo fílmico para gravar vídeos com o ReplayMod. Todos os jogadores passam a receber todos os modelos carregados nos seus chunks carregados, mesmo fora do campo de visão, e os modelos continuam animados. Não é recomendado fora de gravações: consome muita largura de banda e desempenho do servidor. Nunca edita config.yml; a opção dura até o servidor reiniciar ou até filmicMode ser alterado em config.yml e o FMM recarregar. Sem argumento, indica o estado atual e se provém do comando ou de config.yml. Aceita jogadores e consola. Exige freeminecraftmodels.*
/fmm boneglide [ticks]	Define temporariamente riddenBoneInterpolationTicks, o número de ticks que os clientes Java demoram a deslizar um osso de modelo que vai montado na entidade até à pose seguinte. 0 passa diretamente para a pose. Aceita 0 a 59 e completa 0 a 3 com Tab. Sem argumento, indica o valor atual. Nunca edita config.yml; o valor de config.yml volta quando o FMM recarrega. Aceita jogadores e consola. Exige freeminecraftmodels.*
/fmm deleteall [radius]	Remove todas as entidades com modelos atualmente carregadas em todos os mundos, removendo permanentemente os elementos decorativos carregados. Não procura elementos descarregados. Um raio inteiro positivo só está disponível a jogadores e limita a remoção ao seu mundo e distância

As opções de diagnóstico não são guardadas em disco, mas /fmm reload não as repõe. Desative os registos explicitamente após recolher as provas; um novo arranque do servidor inicia ambas desativadas.

Colocação de elementos decorativos

Ao clicar com o botão direito com um item de colocação obtido por itemify, fabrico ou loja, aplicam-se estas regras. Os itens de mão definidos pelos autores estão excluídos deste processamento.

• Consumo: é consumido um item após uma colocação bem-sucedida, exceto no modo Criativo.
• Alvo: clicar num bloco usa o bloco e a face do evento de interação. Clicar no ar procura até cinco blocos. Elementos livres usam o centro da face; os voxelizados usam o bloco adjacente e um volume alinhado à grelha.
• Rotação: os elementos orientam-se para a posição do jogador em relação ao ponto de colocação, não apenas para o ângulo da sua mira. A colocação livre usa passos de 10 graus; a voxelizada, de 90 graus.
• Um elemento de cada modelo por bloco: se já existir um elemento carregado do mesmo modelo no bloco, a colocação é recusada com A prop of that model already exists on this block.. O item não é consumido.
• Mão principal e intervalo: só a mão principal coloca elementos. As tentativas têm um intervalo de 500 ms, incluindo as que depois falham na validação.
• Proteção e espaço: a consulta de proteção configurada verifica a célula adjacente. Os elementos voxelizados verificam depois o espaço livre e a proteção em todo o volume rodado. A permissão de exceção dispensa as consultas de proteção. Consulte Configuração para os limites de integração e cobertura de colisões.
• Remoção de duplicados: no arranque, nos eventos de carregamento de entidades e antes da criação direta de elementos, o FMM procura suportes com o mesmo modelo e bloco, preserva um e remove os restantes. Regista as remoções como [FMM Props] Removed N duplicate prop armor stand(s) ....

Menu de itens fabricáveis

/fmm, sem argumentos, abre um menu para jogadores com as entradas de modelos carregados cujas receitas de fabrico estão efetivamente registadas.

• Cada entrada representa um item FMM fabricável.
• Clicar num item abre os detalhes, com a grelha de fabrico 3×3, uma seta e o resultado. O jogador vê exatamente como o fabricar numa bancada.
• Exige freeminecraftmodels.menu, com predefinição true, disponível a todos os jogadores.

Catálogo para administradores

/fmm admin abre um menu onde os administradores podem consultar:

• Pacotes de conteúdo instalados.
• Pastas e modelos individuais.
• Itens personalizados, definidos por material:.

Exige freeminecraftmodels.admin, com predefinição op.

Editor de receitas

/fmm craftify permite criar uma receita normal de bancada para qualquer modelo de elemento decorativo.

1. Execute /fmm craftify <model_id> para abrir o editor.
2. Surge um inventário com uma grelha 3×3 e o item de resultado já preenchido.
3. Coloque ingredientes do seu inventário na disposição pretendida.
4. Clique no resultado, o item de papel do elemento, para guardar.
5. Uma gravação bem-sucedida emite partículas, um som e uma mensagem de sucesso. Se a gravação ou o registo falhar, o menu fica aberto, os ingredientes permanecem na grelha e o jogador recebe um erro. O FMM tenta restaurar a receita anteriormente registada; consulte a consola se a restauração também falhar.
6. A receita é guardada em plugins/FreeMinecraftModels/recipes/<model_id>.yml; o registo Bukkit depende de registerCraftingRecipes.
7. Se o registo for bem-sucedido e o fabrico estiver ativo, os jogadores podem fabricar o item de papel numa bancada.
8. Prima Escape antes de guardar para cancelar e recuperar os ingredientes, deixando cair aos seus pés o que não couber. Guardar limpa, pelo contrário, as pilhas completas da grelha; a receita só conserva tipos de materiais e disposição, não quantidades nem metadados dos itens.
9. Executar novamente craftify para o mesmo modelo substitui a receita e repõe os campos de ativação e loja nas predefinições, incluindo o preço.
10. As receitas mantêm-se entre reinícios e recarregamentos.

Formato do ficheiro de receita

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

Campo	Obrigatório	Notas
isEnabled	Não; predefinição true	Use false para remover o registo da receita sem apagar o ficheiro
model_id	Sim	Modelo colocado pelo item de papel fabricado. Um sufixo de estado de arco ou besta só é resolvido para o ID base se esse modelo base tiver um modelo de apresentação registado
shape	Sim	Até três linhas de até três caracteres. Um espaço representa uma posição vazia
ingredients	Sim	Mapa de um carácter da grelha para um nome de material Bukkit. Materiais desconhecidos são descartados sem aviso
shopEnabled	Não; predefinição true	Define se a receita aparece em /fmm shop
shopPrice	Não; predefinição defaultPrice de shop_config.yml	Preço na loja em moeda do Vault

A chave Bukkit é freeminecraftmodels:prop_recipe_<model_id> e o resultado é sempre o item de papel que coloca o modelo, não um item de mão definido com o seu material e encantamentos. Voltar a executar /fmm craftify substitui o ficheiro e tenta o registo com a mesma chave quando o fabrico está ativo.

O FMM lê todos os .yml em recipes/, incluindo subpastas, e carrega-os como um único catálogo. Cada model_id só pode ter um ficheiro de receita ativo. Um segundo ficheiro ativo para o mesmo model_id, ou um ficheiro com um erro de sintaxe YAML, faz com que /fmm reload seja recusado, mantendo as receitas atuais, e indica a quem o executou que consulte a consola. No arranque, o mesmo problema recusa apenas o catálogo de receitas. O FMM acaba de arrancar sem receitas de elementos decorativos nem entradas na loja de mobiliário até corrigir o ficheiro e executar /fmm reload. Procure Prop recipe catalog rejected, Duplicate recipe model ou Cannot prepare prop recipes na consola.

Permissões

Registadas em plugin.yml

Permissão	Predefinição	Descrição
freeminecraftmodels.*	OP	Permissão global que concede freeminecraftmodels.admin, freeminecraftmodels.deleteall, freeminecraftmodels.disguise.self, freeminecraftmodels.disguise.others, freeminecraftmodels.bypassregionprotection e freeminecraftmodels.pets.admin. É 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, /fmm packetdebug, /fmm filmic, /fmm boneglide, /fmm location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate, /fmm applypluginupdate e /fmm forcereinstallcontent
freeminecraftmodels.admin	OP	Acesso ao catálogo /fmm admin e a /fmm giveitem
freeminecraftmodels.deleteall	OP	Incluída na permissão global; permite /fmm deleteall
freeminecraftmodels.disguise.self	OP	Permite usar /fmm disguise e /fmm undisguise no próprio jogador
freeminecraftmodels.disguise.others	OP	Permite /fmm disguise <model> <player>, /fmm undisguise <player> e /fmm disguiselist
freeminecraftmodels.bypassregionprotection	OP	Dispensa as consultas de proteção do FMM para colocação e interação com elementos decorativos, incluindo preventPropPlacementInProtectedRegions. As verificações de espaço livre continuam ativas
freeminecraftmodels.menu	true	Acesso ao menu de itens fabricáveis /fmm, para todos os jogadores
freeminecraftmodels.shop	true	Acesso a /fmm shop, para todos os jogadores quando a loja está ativa

disguise e undisguise com um jogador alvo exigem ambas freeminecraftmodels.disguise.self e freeminecraftmodels.disguise.others. disguiselist exige apenas .others.

Permissões das mascotes

Permissão	Predefinição	Descrição
freeminecraftmodels.pets	true	Acesso a /fmm pets (disponível para todos os jogadores)
freeminecraftmodels.pets.admin	OP	Incluída na permissão global; acesso a /fmm petadmin e /fmm petmigrate

Registadas pelo MagmaCore

Permissão	Predefinição	Descrição
nightbreak.login	OP	Necessária para /nightbreaklogin e /nightbreaklogout. Registada uma vez por servidor pelo primeiro plugin Nightbreak a carregar
nightbreak.plugins	OP	Necessária para o comando partilhado /nightbreak plugins. Registada uma vez por servidor pelo primeiro plugin Nightbreak a carregar

Quem pode executar os comandos

• initialize, setup, spawn, itemify, mount, giveitem, craftify, hitbox visualize, location, admin, shop, pets, petadmin e petmigrate são exclusivos para jogadores, tal como /freeminecraftmodelschangelog.
• reload, stats, recommendedplugins, downloadall, downloadallcontent, updatecontent, downloadpluginupdate, applypluginupdate, forcereinstallcontent, packetdebug, debug, filmic, boneglide, deleteall, /nightbreaklogin, /nightbreaklogout e /nightbreak plugins aceitam jogadores e consola. O raio de deleteall só está disponível para jogadores.
• disguise e undisguise podem ser executados pela consola quando é indicado um jogador alvo.
• version não exige permissão e aceita jogadores ou consola.
• /fmm initialize abre a instalação inicial para jogadores com freeminecraftmodels.*. Use /fmm setup para a gestão habitual de conteúdo.