Configuração do FreeMinecraftModels

FreeMinecraftModels ainda suporta importações manuais de .bbmodel, mas o fluxo de configuração atual é integrado ao Nightbreak e orientado por menus.

Pré-requisitos

• Um runtime Java 21 para o servidor
• FreeMinecraftModels instalado e iniciado uma vez para que possa gerar suas pastas de dados
• Uma forma de entregar o resource pack gerado aos jogadores

ResourcePackManager é o caminho de entrega recomendado porque FreeMinecraftModels apenas gera o pack; ele não o hospeda por si só.

Fluxo Inicial

Comando	Propósito
/fmm initialize	Menu de integração inicial apenas para jogadores
/fmm setup	Menu de gerenciamento de conteúdo apenas para jogadores
/fmm downloadall	Auxiliar de instalação em massa para pacotes Nightbreak acessíveis
/fmm updatecontent	Auxiliar de atualização em massa para pacotes Nightbreak desatualizados
/nightbreaklogin <token>	Registro de token Nightbreak compartilhado

Se config.yml ainda tiver setupDone: false, jogadores com freeminecraftmodels.* recebem um lembrete de login dizendo para executar /fmm initialize.

Fluxo de Trabalho Recomendado

1. Instale FreeMinecraftModels e inicie o servidor uma vez.
2. Execute /fmm initialize.
3. Vincule um token Nightbreak com /nightbreaklogin <token>.
4. Abra /fmm setup para inspecionar os pacotes disponíveis e o estado atual.
5. Use /fmm downloadall se quiser instalar todos os pacotes oficiais que seu token pode acessar.
6. Use /fmm updatecontent mais tarde para atualizar pacotes oficiais desatualizados.
7. Certifique-se de que os jogadores recebam o pack gerado output/FreeMinecraftModels.zip, geralmente através do ResourcePackManager.

Importações Manuais de Modelos

A importação direta de modelos ainda funciona através de:

plugins/FreeMinecraftModels/imports

Esse caminho ainda é útil para:

• desenvolvimento local
• modelos customizados que você não está obtendo do Nightbreak
• converter conteúdo .bbmodel para o formato de runtime atual quando você executa /fmm reload

Importações manuais e downloads de pacotes oficiais dependem de uma passagem de reload/importação antes que a lista de modelos em runtime e o resource pack sejam reconstruídos.

Pacotes de Conteúdo Oficiais

O plugin atual vem com três pacotes pré-configurados gerenciados pelo Nightbreak:

• Basic Furniture Pack
• BetterStructures Prop Pack
• EliteMobs Prop Pack

Estes aparecem dentro de /fmm setup, podem ser baixados em massa com /fmm downloadall e podem ser atualizados com /fmm updatecontent.

Lembrete sobre Resource Pack

FreeMinecraftModels sempre precisa que sua saída de resource pack gerado chegue ao cliente de alguma forma.

Veja Saída do resource pack para os caminhos de saída atuais e a integração com o ResourcePackManager.