Configuração do FreeMinecraftModels

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

Pré-requisitos

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

O ResourcePackManager é o caminho de entrega recomendado porque o FreeMinecraftModels apenas gera o pack; ele não o hospeda sozinho.

Fluxo Inicial

Comando	Finalidade
/fmm initialize	Menu de onboarding inicial (somente jogador)
/fmm setup	Menu de gerenciamento de conteúdo (somente jogador)
/fmm downloadall	Auxiliar de instalação em massa para packs Nightbreak acessíveis
/fmm updatecontent	Auxiliar de atualização em massa para packs Nightbreak desatualizados
/nightbreaklogin <token>	Registro compartilhado de token do Nightbreak

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

Fluxo Recomendado

1. Instale o FreeMinecraftModels e inicie o servidor uma vez.
2. Rode /fmm initialize.
3. Vincule um token Nightbreak com /nightbreaklogin <token>.
4. Abra /fmm setup para inspecionar packs disponíveis e o estado atual.
5. Use /fmm downloadall se quiser instalar todos os packs oficiais que seu token pode acessar.
6. Use /fmm updatecontent depois para atualizar packs oficiais desatualizados.
7. Garanta que os jogadores recebam o pack gerado output/FreeMinecraftModels.zip, geralmente pelo ResourcePackManager.

Importações Manuais de Modelos

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

plugins/FreeMinecraftModels/imports

Esse caminho continua ú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ê roda /fmm reload

Tanto importações manuais quanto downloads de pacotes oficiais acabam dependendo de uma passagem de reload/import antes que a lista de modelos do runtime e o resource pack sejam reconstruídos.

Packs de Conteúdo Oficiais

O plugin atual vem com cinco pacotes gerenciados pelo Nightbreak pré-feitos:

• Basic Furniture Pack (props)
• BetterStructures Prop Pack (props)
• EliteMobs Prop Pack (props)
• Craftenmine's Weapons Item Pack (itens customizados)
• Craftenmine Tools Item Pack (itens customizados)

Eles aparecem dentro de /fmm setup, podem ser baixados em massa com /fmm downloadall e podem ser atualizados com /fmm updatecontent. Os dois packs Craftenmine são itens customizados (modelos com material: definido) e são elegíveis para scripts Lua de itens.

Lembrete sobre o Resource Pack

O FreeMinecraftModels sempre precisa que sua saída de resource pack gerada chegue até o cliente de alguma forma.

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