Instalação do FreeMinecraftModels

O FreeMinecraftModels continua a suportar importações manuais de .bbmodel, mas a instalação atual usa menus integrados com Nightbreak.

Pré-requisitos

• Java 21 no servidor.
• Minecraft 1.21.4 ou posterior. O plugin declara api-version: 1.21.4 e não carrega em versões anteriores.
• FreeMinecraftModels instalado e iniciado uma vez para gerar as pastas de dados. O MagmaCore vem incluído no JAR do plugin, por isso não precisa de instalação separada.
• Uma forma de entregar o pacote de recursos gerado aos jogadores.

Recomenda-se ResourcePackManager para a entrega, pois o FreeMinecraftModels apenas gera o pacote, sem o alojar.

Instalação inicial

Comando	Finalidade
/fmm setup	Menu de conteúdo e orientação inicial, apenas para jogadores; é o comando indicado no primeiro arranque.
/fmm recommendedplugins	Mostra plugins complementares recomendados.
/fmm downloadall	Transfere a atualização mais recente do plugin e todos os pacotes Nightbreak acessíveis.
/fmm downloadallcontent	Transfere apenas os pacotes Nightbreak acessíveis.
/fmm updatecontent	Atualiza os pacotes Nightbreak desatualizados.
/fmm downloadpluginupdate	Transfere apenas a atualização do JAR do plugin.
/fmm applypluginupdate	Aplica uma atualização do plugin já transferida sem reiniciar o servidor.
/fmm forcereinstallcontent <package|all>	Transfere novamente conteúdo já instalado, mesmo quando a versão indica que está atualizado.
/nightbreaklogin [token]	Vinculação partilhada da conta Nightbreak: imprime uma ligação para aprovar o servidor ou guarda um token colado. Exige nightbreak.login.
/nightbreaklogout	Remove o token Nightbreak guardado neste servidor.

Com setupDone: false em config.yml, os jogadores com freeminecraftmodels.* recebem um lembrete cerca de 10 segundos depois de cada entrada, se ainda estiverem ligados. Abrir /fmm setup guarda setupDone: true para o servidor e dispensa os lembretes futuros. A mensagem também apresenta /fmm admin e /fmm. Concluir uma opção em /fmm initialize também marca a instalação como terminada; esse indicador não prova que um pacote foi instalado ou entregue.

A barra de ferramentas de /fmm setup tem também um botão Pets que alterna o modo de mascotes entre mascotes cosméticas e mais criaturas, e guarda a escolha em pets.yml.

Procedimento recomendado

1. Instale o FreeMinecraftModels e inicie o servidor uma vez.
2. Associe o servidor à sua conta Nightbreak com /nightbreaklogin e depois aprove-o na ligação que o comando imprime.
3. Abra /fmm setup para consultar os pacotes e o estado atual.
4. Use /fmm downloadall para instalar todos os pacotes oficiais acessíveis ao token, transferindo também a atualização do plugin.
5. Mais tarde, use /fmm updatecontent para atualizar os pacotes desatualizados.
6. Espere pela inicialização bem-sucedida e verifique que os jogadores recebem output/FreeMinecraftModels.zip, normalmente através do ResourcePackManager. O FMM notifica o ResourcePackManager, se estiver ativo, após gerar o pacote com sucesso; essa notificação, por si só, não prova a entrega ao cliente.

As transferências interativas de pacotes recarregam o FMM depois de alterar conteúdo. Um JAR do plugin transferido entra em vigor após um reinício, ou de imediato com /fmm applypluginupdate. /fmm reload valida os objetos, os encantamentos e as receitas de elementos decorativos definidos antes de reconstruir; uma validação rejeitada mantém o catálogo atual ativo. Verifique o resultado antes de considerar os ficheiros aplicados.

Para transferências automáticas de atualizações, defina nightbreak.autoDownloadPluginUpdates: true em config.yml, cujo valor predefinido é false. As atualizações de plugin e conteúdo transferidas são aplicadas após o próximo reinício. Para aplicar as atualizações do plugin sem reiniciar, defina nightbreak.applyPluginUpdatesWithoutRestart como when-empty ou immediately (predefinição never). Consulte Configuração.

Importação manual de modelos

A importação direta usa:

plugins/FreeMinecraftModels/imports

É útil para:

• Desenvolvimento local.
• Modelos personalizados que não vêm do Nightbreak.
• Converter .bbmodel para o formato atual ao executar /fmm reload.

As importações manuais e as transferências oficiais dependem de um ciclo de importação e recarregamento antes de reconstruir a lista de modelos e o pacote de recursos.

Coloque um .bbmodel solto diretamente em imports/. Esta via escreve um .fmmodel convertido no diretório de modelos e mantém o ficheiro de origem, pelo que outro recarregamento pode convertê-lo novamente. Não importa um .yml solto colocado ao lado. As subpastas normais sem pack.meta não são percorridas recursivamente por esta via. Para modelos com configurações ou scripts associados, use o diretório ativo models/ e scripts/, ou um arquivo corretamente empacotado; consulte Notas de criação de modelos.

Pacotes oficiais

O plugin inclui cinco pacotes pré-definidos geridos pelo Nightbreak:

• Basic Furniture Pack: elementos decorativos.
• BetterStructures Prop Pack: elementos decorativos.
• EliteMobs Prop Pack: elementos decorativos.
• Craftenmine's Weapons Item Pack: objetos personalizados.
• Craftenmine Tools Item Pack: objetos personalizados.

Aparecem em /fmm setup, podem ser transferidos em conjunto com /fmm downloadall e atualizados com /fmm updatecontent. Os dois pacotes Craftenmine contêm objetos personalizados, modelos com material: definido, e usam os formatos atuais de objetos e encantamentos. Pacotes antigos com scripts de objetos equipados precisam de conteúdo atualizado.

Entrega do pacote de recursos

O pacote gerado pelo FreeMinecraftModels tem sempre de chegar ao cliente por alguma via.

Consulte os caminhos atuais e a integração ResourcePackManager em Pacote de recursos gerado.