Comandos do FreeMinecraftModels
registerCraftingRecipes em config.yml tem o valor padrão true. Defina false e reinicie para uma economia baseada apenas em compras: as receitas continuam visíveis nos menus e na loja, mas as receitas de crafting Bukkit são removidas. As instruções de crafting nesta página exigem true.
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 setup | Abre o menu de gerenciamento de conteúdo / configuração inicial, exclusivo para jogadores (o comando para o qual os jogadores são direcionados no primeiro boot) |
/fmm recommendedplugins | Mostra plugins complementares que combinam bem com o FreeMinecraftModels (abre um menu de catálogo para jogadores, imprime uma lista no console) |
/fmm downloadall | Baixa a atualização mais recente do plugin e todo o conteúdo oficial disponível. Se o conteúdo mudou, o FMM recarrega para aplicá-lo; o jar do plugin baixado ainda exige um reinício do servidor. Se a etapa de atualização do plugin falhar por falta de um token Nightbreak ou por falha de autenticação, a etapa de conteúdo é totalmente pulada |
/fmm downloadallcontent | Baixa todo o conteúdo oficial disponível (apenas conteúdo, sem atualizar o jar do plugin) e recarrega se pelo menos um pacote mudou |
/fmm updatecontent | Baixa atualizações para conteúdo oficial desatualizado e recarrega se pelo menos um pacote mudou (alias: /fmm updateallcontent) |
/fmm downloadpluginupdate | Baixa apenas a atualização mais recente do jar do plugin (aplicada após o próximo reinício do servidor) |
/fmm forcereinstallcontent <package|all> | Comando de reparo — rebaixa conteúdo que você já tem, mesmo quando os números de versão dizem que está atualizado. O tab-complete oferece all mais o slug de cada pacote Nightbreak. all cobre todo pacote detectado como baixado; se os arquivos de um pack estiverem completamente ausentes, informe o slug diretamente. Recarrega em seguida (permissão: freeminecraftmodels.*) |
/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 |
Comandos Nightbreak Compartilhados
Estes são registrados pelo MagmaCore, e não pelo próprio FreeMinecraftModels, então são comandos de nível superior, não subcomandos de /fmm.
| Comando | Finalidade |
|---|---|
/nightbreaklogin <token> | Armazena o token compartilhado da conta Nightbreak para este servidor, liberando downloads de conteúdo oficial e atualizações do plugin (permissão: nightbreak.login, padrão: op). Registrado uma única vez por servidor — o primeiro plugin Nightbreak a carregar fica com ele |
/nightbreaklogout | Limpa o token da conta Nightbreak armazenado neste servidor (permissão: nightbreak.login, padrão: op). Aceita tanto jogadores quanto console |
/freeminecraftmodelschangelog [dismiss|disable] | Mostra as notas de versão não lidas do FreeMinecraftModels (lançamentos do plugin e pacotes de conteúdo acompanhados). dismiss marca as notas exibidas como lidas; disable oculta permanentemente os lembretes de changelog para você. Exclusivo para jogadores e apenas para admins — o jogador precisa de freeminecraftmodels.*, de uma das permissões de setup/admin, ou de OP. Se outro plugin já ocupa o rótulo /freeminecraftmodelschangelog, o comando se registra sob um fallback com namespace, como /freeminecraftmodels:freeminecraftmodelschangelog |
Admins com notas de versão não lidas recebem um aviso no chat ao entrar, com um prompt clicável [VIEW CHANGELOG]; a visualização do resumo oferece os botões Dismiss These Updates e Never Show Changelogs, que fazem o mesmo que os dois subcomandos. O estado de leitura por jogador fica em plugins/FreeMinecraftModels/nightbreak-changelogs.yml.
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. Recusa com A prop of that model already exists on this block. se um prop do mesmo modelo já estiver carregado naquele bloco |
/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.self + 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.self + 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
DisguiseAPIpú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: trueemshop_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|props> [on|off] | Toggles em runtime para os streams de log de diagnóstico do FMM. bedrock alterna o stream [FMM-BedrockDebug], que diagnostica o pipeline de exibição Bedrock; props alterna a varredura de props empilhados, que faz cada carregamento de chunk reportar quaisquer dois props a menos de 0,1 bloco um do outro como STACKED PROPS DETECTED. Omita o argumento de estado para reportar o estado atual sem alterá-lo. on/true/enable/enabled e off/false/disable/disabled são todos aceitos. Ambos os toggles sempre voltam para OFF no reload do plugin — intencionalmente não são chaves de config, para que não possam ser deixados ligados por acidente. Aceita tanto jogadores quanto console (permissão: freeminecraftmodels.*) |
/fmm packetdebug [ticks] | Diagnóstico único de carga de pacotes. Amostra o tráfego de pacotes de entidades modeladas pelos próximos [ticks] ticks do relógio de modelos (padrão 1, limitado a 200) e reporta pacotes lógicos/tick, pacotes efetivamente entregues/tick incluindo o fan-out por espectador, o pior jogador/tick, um detalhamento por tipo de pacote e os espectadores mais pesados. O tab-complete oferece 1, 5, 20, 60. Execute enquanto estiver na área com lag. As contagens de pacotes são exatas; os valores em bytes são estimativas. Expira com um aviso se nenhuma amostra chegar (nenhuma entidade modelada carregada, ou NMS desabilitado). Aceita tanto jogadores quanto console (permissão: freeminecraftmodels.*) |
/fmm deleteall [radius] | Remove todas as entidades modeladas carregadas e props persistentes. Sem argumento, limpa tudo; um [radius] opcional (somente jogador) limita a remoção a entidades dentro daquela quantidade de blocos do jogador |
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.
- Um prop por modelo por bloco: A colocação é recusada com
A prop of that model already exists on this block.quando um prop do mesmo modelo já está carregado naquele bloco. O item não é consumido em uma colocação recusada. - Apenas mão principal: Apenas a metade de mão principal do evento de interação coloca um prop, então um único clique direito não pode mais produzir dois props.
- Limpeza de duplicatas: Na inicialização do servidor e a cada carregamento de chunk, o FreeMinecraftModels procura armor stands de prop que compartilhem modelo e bloco, mantém um e remove o restante. As remoções são registradas como
[FMM Props] Removed N duplicate prop armor stand(s) ....
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.
- Execute
/fmm craftify <model_id>para abrir a UI do construtor de receitas. - Um inventário customizado abre com uma grade de crafting 3×3 e um item de saída pré-preenchido.
- Coloque ingredientes do seu inventário na grade no padrão que quiser.
- Clique no item de saída (o item de papel do prop) para salvar a receita.
- Partículas e um som confirmam o salvamento.
- A receita é salva em
plugins/FreeMinecraftModels/recipes/<model_id>.ymle registrada imediatamente. - Jogadores agora podem craftar o item do prop em qualquer mesa de crafting.
- Pressione Escape para cancelar sem salvar — os ingredientes são devolvidos ao seu inventário.
- Executar craftify novamente para o mesmo modelo sobrescreve a receita anterior.
- Receitas persistem entre reinicializações e reloads do servidor.
Formato do Arquivo 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 | sim (padrão true) | Defina como false para desregistrar a receita sem apagar o arquivo |
model_id | sim | O modelo que o item de papel craftado coloca. Um ID de modelo que carrega um sufixo de estado de arco/besta é automaticamente reescrito para o ID do modelo base |
shape | sim | Até três linhas de até três caracteres. Um espaço significa "slot vazio" |
ingredients | sim | Mapa de um único caractere da shape para um nome de material do Bukkit. Materiais não reconhecidos são descartados silenciosamente |
shopEnabled | não (padrão true) | Se a receita é listada em /fmm shop |
shopPrice | não (padrão defaultPrice de shop_config.yml) | Custo em moeda do Vault na loja |
A chave da receita Bukkit registrada é freeminecraftmodels:prop_recipe_<model_id>, e a saída é sempre o item de papel de colocação do modelo. Reexecutar /fmm craftify para o mesmo modelo sobrescreve o arquivo e o reregistra sob a mesma chave.
Permissões
Registradas em plugin.yml
| Permissão | Padrão | Descrição |
|---|---|---|
freeminecraftmodels.* | OP | Wildcard que concede freeminecraftmodels.admin, freeminecraftmodels.deleteall, freeminecraftmodels.disguise.self, freeminecraftmodels.disguise.others e freeminecraftmodels.bypassregionprotection. 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, /fmm packetdebug, /fmm location, /fmm setup, /fmm initialize, /fmm recommendedplugins, /fmm downloadall, /fmm downloadallcontent, /fmm updatecontent, /fmm downloadpluginupdate e /fmm forcereinstallcontent |
freeminecraftmodels.admin | OP | Acesso a /fmm admin (o navegador de conteúdo para admins) e /fmm giveitem |
freeminecraftmodels.deleteall | OP | Filho do wildcard; acesso a /fmm deleteall |
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.bypassregionprotection | OP | Permite colocar e interagir com props em qualquer lugar onde outro plugin bloquearia a colocação normal de blocos, mesmo quando preventPropPlacementInProtectedRegions está habilitado |
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) |
Os comandos disguise e undisguise com jogador alvo exigem tanto freeminecraftmodels.disguise.self como freeminecraftmodels.disguise.others. disguiselist exige apenas .others.
Registradas pelo MagmaCore
| Permissão | Padrão | Descrição |
|---|---|---|
nightbreak.login | OP | Exigida pelos comandos compartilhados /nightbreaklogin e /nightbreaklogout. Registrada uma única vez por servidor pelo primeiro plugin Nightbreak a carregar |
Notas sobre o remetente
initialize,setup,spawn,itemify,mount,giveitem,craftify,hitbox visualize,location,admineshopsão comandos exclusivos para jogadores./freeminecraftmodelschangelogtambém é exclusivo para jogadores.recommendedplugins,downloadall,downloadallcontent,updatecontent,downloadpluginupdate,forcereinstallcontent,packetdebug,debug,deleteall,/nightbreaklogine/nightbreaklogoutaceitam tanto jogadores quanto console (um raio emdeleteallé exclusivo para jogadores).disguiseeundisguiseaceitam um jogador alvo e podem ser executados pelo console desde que um alvo seja fornecido.versionnão tem restrição de permissão e pode ser executado por qualquer um (jogadores ou console)./fmm initializeabre o menu de configuração inicial para jogadores comfreeminecraftmodels.*. Use/fmm setuppara gerir o conteúdo no dia a dia.