Configuração do FreeMinecraftModels

Esta página cobre as configurações atuais do config.yml que afetam materialmente a configuração, renderização e interação com jogadores.

Localização do Arquivo

plugins/FreeMinecraftModels/config.yml

Configurações Verificadas Atuais

setupDone

• Padrão: false
• Controla se a orientação de configuração inicial é considerada completa
• Jogadores com permissões amplas do FreeMinecraftModels são lembrados de executar /fmm initialize enquanto isso permanecer false
• O fluxo de configuração alterna esse valor para você; não é necessário editá-lo manualmente durante a integração normal

useDisplayEntitiesWhenPossible

• Padrão: true
• Diz ao FreeMinecraftModels para preferir a renderização por display entity quando o servidor e o caminho do cliente suportarem
• O plugin ainda faz fallback quando display entities não estão disponíveis
• Clientes Bedrock são um caso especial, então não assuma que isso força o mesmo caminho de renderização para todos os jogadores

maxModelViewDistance

• Padrão: 60
• Limita a que distância as entidades modeladas são enviadas aos visualizadores
• Valores mais baixos reduzem a carga de pacotes e renderização do cliente em áreas densas com muitos modelos

maxInteractionAndAttackDistance

• Padrão: 3
• Aplica-se a entidades modeladas estáticas e dinâmicas
• Usado pelas verificações de interação e detecção de acerto em runtime

maxInteractionAndAttackDistanceForProps

• Padrão: 6
• Aplica-se a entidades prop
• Isso é separado da distância de interação de entidades estáticas/dinâmicas

sendCustomModelsToBedrockClients

• Padrão: false
• Controla se FreeMinecraftModels tenta enviar modelos customizados para clientes Bedrock
• Se desabilitado, jogadores Bedrock fazem fallback para a entidade vanilla subjacente quando ela existe
• Se você habilitar isso, certifique-se de que seu caminho de resource pack Bedrock/Geyser/Floodgate está realmente pronto para esses clientes

Permissões

Registradas no plugin.yml

Permissão	Padrão	Descrição
freeminecraftmodels.*	op	Concede acesso a todos os comandos do FreeMinecraftModels
freeminecraftmodels.admin	op	Concede acesso a comandos de admin como /fmm admin e /fmm giveitem
freeminecraftmodels.menu	true	Concede acesso ao menu de itens craftáveis /fmm (disponível para todos os jogadores por padrão)

Aplicadas por comandos (não registradas no plugin.yml)

Permissão	Padrão	Descrição
freeminecraftmodels.deleteall	op	Concede acesso a /fmm deleteall (verificada pelo handler do comando em tempo de execução)

Configuração YML de Modelos

Cada arquivo .bbmodel pode ter um arquivo .yml companheiro (mesmo nome, mesmo diretório) que controla configurações específicas do modelo. O formato YML unificado suporta os seguintes campos:

isEnabled: true
voxelize: true
solidify: true
scripts:
  - my_script.lua
material: DIAMOND_SWORD
name: "&bFrost Blade"
lore:
  - "&7A sword forged in ice"
  - "&7Deals frost damage"
enchantments:
  - SHARPNESS,3
  - UNBREAKING,2

Campo	Tipo	Descrição
isEnabled	boolean	Se o modelo é carregado (padrão: true)
scripts	lista de strings	Nomes de arquivo de scripts Lua a vincular (de plugins/FreeMinecraftModels/scripts/)
voxelize	boolean	Quando true, o prop se ajusta a incrementos de rotação de 90 graus e se alinha à grade de blocos quando colocado. A área é calculada a partir das dimensões da hitbox do modelo (arredondada para blocos inteiros). A colocação verifica que todos os blocos na área não são sólidos.
solidify	boolean	Quando true (requer voxelize: true), blocos de barreira apenas por pacote são colocados em cada bloco da área do prop, dando-lhe colisão no lado do cliente. Essas barreiras são invisíveis e existem apenas em pacotes — não são colocadas no mundo. As barreiras são automaticamente removidas quando o prop é recolhido ou destruído.
material	string	Um nome de material do Bukkit (ex: DIAMOND_SWORD, PAPER). Quando definido, o modelo se torna um item customizado que os jogadores podem segurar e equipar
name	string	Nome de exibição para o item customizado (suporta códigos de cor &)
lore	lista de strings	Linhas de lore para o item customizado (suporta códigos de cor &)
enchantments	lista de strings	Encantamentos no formato ENCHANTMENT_NAME,LEVEL (ex: SHARPNESS,3)

Quando material está definido, o modelo é registrado como um item customizado. Os jogadores podem recebê-lo via /fmm giveitem, craftá-lo se uma receita estiver configurada, e ele ganha acesso a todos os 22 hooks Lua de item.

Notas Operacionais

• /fmm reload reimporta conteúdo e regenera o pack de saída, então mudanças de configuração que afetam o comportamento de renderização são mais fáceis de validar após um reload
• FreeMinecraftModels apenas gera o resource pack; ele não o hospeda por si só
• ResourcePackManager ainda é o caminho de entrega recomendado para clientes Java e o caminho documentado mais seguro para configurações mistas

Quando Alterar Esses Valores

Use esta configuração para ajuste de comportamento em runtime, não para gerenciamento de pacotes de conteúdo.

• Use /fmm initialize, /fmm setup, /fmm downloadall e /fmm updatecontent para trabalho de ciclo de vida de pacotes oficiais
• Use a pasta imports para importação manual de .bbmodel ou outro conteúdo local
• Use config.yml quando precisar ajustar modo de renderização, distância de visibilidade, distância de interação ou comportamento Bedrock

Ressalvas Conhecidas

• O repositório local tem divergência de metadados de versão entre plugin.yml e pom.xml, então esta página documenta intencionalmente o comportamento em vez de fixar uma string de versão pública rígida
• O comportamento Bedrock depende tanto desta configuração quanto da sua configuração mais ampla de Floodgate/Geyser/resource pack, então mantenha as afirmações conservadoras a menos que tenha testado sua stack exata