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 setup	Menu de gerenciamento de conteúdo / onboarding 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
/fmm downloadall	Auxiliar de instalação em massa: baixa a atualização mais recente do plugin mais todos os packs Nightbreak acessíveis
/fmm downloadallcontent	Auxiliar de instalação em massa para packs Nightbreak acessíveis (apenas conteúdo)
/fmm updatecontent	Auxiliar de atualização em massa para packs Nightbreak desatualizados
/fmm downloadpluginupdate	Baixa apenas a atualização mais recente do jar do plugin
/nightbreaklogin <token>	Registro compartilhado de token do Nightbreak

Se config.yml ainda tiver setupDone: false, jogadores com freeminecraftmodels.* recebem um lembrete de login único apontando para /fmm setup (abri-lo dispensa a mensagem permanentemente). O lembrete também destaca /fmm admin e /fmm.

Fluxo Recomendado

1. Instale o FreeMinecraftModels e inicie o servidor uma vez.
2. Vincule um token Nightbreak com /nightbreaklogin <token>.
3. Abra /fmm setup para inspecionar packs disponíveis e o estado atual.
4. Use /fmm downloadall se quiser instalar todos os packs oficiais que seu token pode acessar (isso também puxa a atualização mais recente do jar do plugin).
5. Use /fmm updatecontent depois para atualizar packs oficiais desatualizados.
6. Garanta que os jogadores recebam o pack gerado output/FreeMinecraftModels.zip, geralmente pelo ResourcePackManager.

Se você preferir que o servidor busque atualizações por conta própria, defina nightbreak.autoDownloadPluginUpdates: true em config.yml (padrão false). Atualizações de plugin e de conteúdo baixadas são aplicadas após o próximo reinício. Veja Configuração.

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 de itens 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.