Configuracao do FreeMinecraftModels

Esta pagina cobre as definicoes atuais de config.yml que afetam materialmente o setup, o rendering e a interacao dos jogadores.

Localizacao do ficheiro

plugins/FreeMinecraftModels/config.yml

Definicoes atualmente verificadas

setupDone

• Predefinido: false
• Controla se a orientacao de configuracao inicial e considerada concluida
• Jogadores com permissoes amplas de FreeMinecraftModels recebem um lembrete para executar /fmm initialize enquanto este valor permanecer false
• O fluxo de setup altera este valor por ti; nao precisas de o editar manualmente durante o onboarding normal

useDisplayEntitiesWhenPossible

• Predefinido: true
• Diz ao FreeMinecraftModels para preferir rendering com display entities quando o servidor e o cliente suportam esse caminho
• O plugin continua a usar fallback quando display entities nao estao disponiveis
• Clientes Bedrock sao um caso especial, por isso nao assumas que isto obriga ao mesmo caminho de rendering para todos os jogadores

maxModelViewDistance

• Predefinido: 60
• Limita a distancia a que entidades modeladas sao enviadas aos observadores
• Valores mais baixos reduzem a carga de pacotes e de rendering do cliente em areas densas com muitos modelos

maxInteractionAndAttackDistance

• Predefinido: 3
• Aplica-se a entidades modeladas estaticas e dinamicas
• E usado pelas verificacoes de interacao e deteccao de ataque em tempo de execucao

maxInteractionAndAttackDistanceForProps

• Predefinido: 6
• Aplica-se a entidades do tipo prop
• Isto esta separado da distancia de interacao usada para entidades estaticas e dinamicas

sendCustomModelsToBedrockClients

• Predefinido: false
• Controla se o FreeMinecraftModels tenta enviar modelos personalizados para clientes Bedrock
• Se estiver desativado, os jogadores Bedrock fazem fallback para a entidade vanilla subjacente quando ela existe
• Se o ativares, certifica-te de que o teu caminho de resource pack para Bedrock/Geyser/Floodgate esta realmente pronto para esses clientes

Notas operacionais

• /fmm reload reimporta conteudo e regenera o pacote de output, por isso alteracoes de configuracao que afetem o rendering sao mais faceis de validar depois de um reload
• O FreeMinecraftModels so gera o resource pack; nao o aloja por si proprio
• O ResourcePackManager continua a ser o caminho recomendado para clientes Java e o caminho documentado mais seguro para setups mistos

Quando alterar estes valores

Usa esta configuracao para ajustar o comportamento em tempo de execucao, nao para gerir content packages.

• Usa /fmm initialize, /fmm setup, /fmm downloadall e /fmm updatecontent para o ciclo de vida de pacotes oficiais
• Usa a pasta imports para trabalho manual de importacao de .bbmodel ou outro conteudo local
• Usa config.yml quando precisares de ajustar modo de rendering, distancia de visibilidade, distancia de interacao ou comportamento Bedrock

Limitacoes conhecidas

• O repositorio local tem divergencia de metadados de versao entre plugin.yml e pom.xml, por isso esta pagina documenta comportamento em vez de fixar uma versao publica especifica
• O comportamento Bedrock depende tanto desta configuracao como do teu setup mais amplo de Floodgate/Geyser/resource pack, por isso mantem afirmacoes conservadoras a menos que tenhas testado exatamente a tua stack