Pular para o conteúdo principal

FAQ do FreeMinecraftModels

Se você tiver uma pergunta que não está listada aqui, dê uma olhada na barra lateral para ver se há uma página dedicada a ela na wiki!

Primeiros Passos

Como instalo e uso o FreeMinecraftModels?​

Info

Instalação:

  1. Baixe FreeMinecraftModels.jar e coloque-o na sua pasta de plugins
  2. Reinicie o servidor para gerar as pastas do plugin
  3. Coloque arquivos .bbmodel em ~/plugins/FreeMinecraftModels/imports/
  4. Execute /fmm reload para converter modelos e gerar o pacote de recursos
  5. Encontre o pacote de recursos gerado em ~/plugins/FreeMinecraftModels/outputs/

Distribuindo o Pacote de Recursos:

Escolha um destes métodos:

  • Opção A (Recomendada): Instale Resource Pack Manager para distribuição automática
  • Opção B: Configure manualmente via server.properties ou um serviço de hospedagem

Spawnando Modelos:

  • /fmm spawn static <id> - Spawna modelo decorativo temporário
  • /fmm spawn dynamic <id> - Spawna modelo anexado a entidade
  • /fmm spawn prop <id> - Spawna modelo de mundo persistente

Gerenciamento:

  • /fmm reload - Recarrega plugin e converte novos modelos
  • /fmm version - Mostra versão do plugin
  • /fmm stats - Exibe estatísticas de contagem de entidades

Recursos do Jogador:

  • /fmm disguise <modelID> - Transforma sua aparência em um modelo personalizado
  • /fmm undisguise - Remove disfarce do jogador e restaura aparência normal
  • /fmm itemify <model> <material> - Cria um item colocável que spawna o modelo especificado
  • /fmm mount <modelID> - Spawna um cavalo montável disfarçado como modelo personalizado (experimental)

Depuração:

  • /fmm hitbox debug [duration] - Visualiza hitboxes do modelo usando partículas (duração em ticks, padrão 100)

Administrativo:

  • /fmm deleteall - Remove TODAS as entidades modeladas do seu mundo (use com cuidado - sem prompt de confirmação)

Permissões:

  • freeminecraftmodels.* - Necessária para a maioria dos comandos (disguise, itemify, mount, hitbox debug, spawn)
  • freeminecraftmodels.deleteall - Necessária para o comando /fmm deleteall

Comandos são apenas para OP por padrão. Conceda essas permissões para jogadores não-OP se necessário.

Recursos e Limites de Modelos

Quais são os limites de tamanho e rotação dos modelos?​

Info

Limites de Tamanho:

  • Máximo: 112x112x112 pixels (7x7x7 blocos no jogo)
  • FreeMinecraftModels usa escala interna 4x para alcançar esses tamanhos
  • Pacotes de recursos padrão do Minecraft são limitados a tamanhos menores

Limites de Rotação de Cubos:

  • Ângulos permitidos: 0°, ±22.5°, ±45° e múltiplos de 22.5° (a partir da v2.3.0)
  • Apenas rotação de eixo único
  • Exemplo: [22.5, 0, 0] funciona, mas [22.5, 0, 45] rotaciona apenas parcialmente
  • Outros ângulos não serão exibidos corretamente

Rotação de Ossos:

  • Ossos suportam qualquer ângulo de rotação
  • Evite posições de repouso padrão de 90°, -90°, 180°, -180° (pode causar comportamento inesperado)
  • Rotação multi-eixo suportada
  • Cada osso cria uma entidade separada (consideração de desempenho)

Nota de Desempenho:

Mantenha a contagem de ossos o mais baixa possível. Cada osso spawna uma entidade separada no Minecraft, o que pode impactar o desempenho do servidor em escala.

Quais animações são suportadas?​

Info

FreeMinecraftModels suporta essas animações de estado padrão:

Animações Padrão:

  • Walk (Andar)
  • Idle (Parado)
  • Death (Morte)
  • Attack (Ataque)
  • Spawn (Surgir)

Como Funciona:

  • Crie animações no BlockBench
  • O plugin lê keyframes de animação dos arquivos .bbmodel
  • Animações acionam automaticamente baseado no estado da entidade
  • Desenvolvedores podem acionar animações programaticamente usando playAnimation(animationName, false)

Caso Especial:

Entidades Evoker detectam Evoker Fangs próximos para acionar animações de ataque automaticamente.

O que são ossos virtuais e como eles funcionam?​

Info

Ossos virtuais são ossos especiais com nomes reservados que adicionam funcionalidade aos seus modelos:

Ossos de Hitbox:

  • Nome: hitbox
  • Cria zonas de interação e caixas de colisão
  • Define limites da entidade com valores x/z correspondentes

Ossos de Tag de Nome:

  • Prefixo: tag_
  • Exibe texto acima dos modelos
  • Usado para nomear entidades

Ossos de Rotação de Cabeça:

  • Prefixo: h_
  • Rotaciona baseado na posição da cabeça do jogador/entidade
  • Rastreia movimento da cabeça automaticamente

Uso:

Crie um osso no BlockBench com um desses nomes especiais, e o plugin aplica automaticamente a funcionalidade correspondente.

FAQ de Solução de Problemas

Em vez de modelos personalizados, só vejo armadura de cavalo.​

Info

Se, em vez de modelos personalizados aparecerem no seu jogo, você só vê armadura de cavalo, o problema provavelmente é que você não mesclou o pacote de recursos do FMM corretamente com seu pacote de recursos preexistente.

MagmaGuy desenvolveu um plugin chamado Resource Pack Manager (RSPM) que pode mesclar pacotes de recursos automaticamente para você. Você pode baixá-lo do Spigot aqui.

Simplesmente coloque o arquivo .jar do RSPM na sua pasta de plugins, e o RSPM cuidará de tudo. Ele mesclará todos os pacotes de recursos, hospedará automaticamente e os distribuirá aos jogadores quando eles entrarem no seu servidor.

Por que não consigo ver meu modelo depois de adicionar o arquivo .bbmodel?​

Info

Se seu modelo não está aparecendo, verifique esses problemas comuns:

1. Esqueceu de recarregar

Execute /fmm reload depois de colocar arquivos .bbmodel na pasta imports. Isso converte modelos e gera o pacote de recursos.

2. Pacote de recursos não aplicado

Jogadores devem ter o pacote de recursos FMM ativo para ver modelos.

  • Verifique ~/plugins/FreeMinecraftModels/outputs/ para o pacote gerado
  • Instale Resource Pack Manager para distribuição automática
  • OU distribua manualmente via server.properties ou um serviço de hospedagem

3. Localização de arquivo errada

Arquivos .bbmodel devem estar em: ~/plugins/FreeMinecraftModels/imports/ Não em subpastas, não em outros diretórios.

4. Modelo tem erros

Verifique logs do console para mensagens de erro durante /fmm reload. Problemas comuns incluem rotações não suportadas, modelos grandes demais ou problemas de textura.

5. Problema de mesclagem de pacote de recursos

Se você vê armadura de cavalo em vez de modelos, pacotes de recursos não foram mesclados corretamente. Use Resource Pack Manager (RSPM) para lidar com a mesclagem automaticamente.

ViaVersion pode levar a Pacotes de Recursos não serem exibidos corretamente.​

Info

ViaVersion pode causar problemas com pacotes de recursos, particularmente ao executar um servidor em uma versão inferior a 1.21.4. Minecraft introduziu mudanças em como pacotes de recursos são tratados a partir de 1.21.4. Se você está executando um servidor na versão 1.21.3 e usando ViaVersion para permitir que clientes 1.21.4 se conectem, esses clientes podem ter problemas ao exibir certos conteúdos de pacotes de recursos, como modelos personalizados do FMM (FreeMinecraftModels).

Isso acontece porque o sistema de pacote de recursos no Minecraft mudou com a atualização 1.21.4.

Nota: Esta é uma limitação do Minecraft e ViaVersion, não específica ao FreeMinecraftModels. A tradução de protocolo do ViaVersion pode não suportar completamente mudanças de pacotes de recursos ao executar em versões de servidor abaixo de 1.21.4.

Para resolver isso, considere atualizar seu servidor para 1.21.4 ou superior, pois isso garantirá melhor compatibilidade com recursos modernos de pacotes de recursos, incluindo modelos personalizados do FMM.

Por que meus modelos estão causando lag ou problemas de desempenho?​

Info

Cada osso em seu modelo BlockBench cria uma entidade separada no Minecraft. Modelos com muitos ossos podem impactar o desempenho do servidor.

Dicas de Otimização:

  • Minimize a contagem de ossos em seus modelos
  • Limite o número de modelos spawnados
  • Considere usar modelos Static em vez de Dynamic quando animações não são necessárias
  • Evite spawnar muitos modelos com alta contagem de ossos perto uns dos outros

Explicação Técnica:

FreeMinecraftModels renderiza cada osso como uma entidade Minecraft separada. Um modelo com 50 ossos spawna 50 entidades. Em escala, isso impacta o desempenho.

Melhores Práticas:

  • Projete modelos com menos ossos
  • Teste desempenho com contagens de spawn realistas
  • Monitore TPS do servidor ao adicionar novos modelos

Recursos Avançados

Preciso do Resource Pack Manager (RSPM)?​

Info

Resource Pack Manager (RSPM) é opcional mas altamente recomendado.

O que o RSPM faz:

  • Mescla automaticamente pacotes de recursos de múltiplos plugins
  • Hospeda pacotes de recursos (sem necessidade de hospedagem externa)
  • Distribui pacotes para jogadores automaticamente no login
  • Elimina configuração manual de pacote de recursos

Sem RSPM:

Você deve manualmente:

  • Mesclar pacote de recursos FMM com quaisquer pacotes de recursos de servidor existentes
  • Hospedar o pacote mesclado em um serviço externo ou via server.properties
  • Configurar servidor para enviar pacote aos jogadores
  • Atualizar pacote toda vez que adicionar novos modelos

Por que usar RSPM:

A maioria dos problemas de "armadura de cavalo em vez de modelos" são causados por mesclagem inadequada de pacotes de recursos. RSPM lida com isso automaticamente.

Baixe RSPM: https://www.spigotmc.org/resources/resource-pack-manager.118574/

Desenvolvido por MagmaGuy, o mesmo autor do FreeMinecraftModels.

Posso usar FreeMinecraftModels no meu próprio plugin?​

Info

Sim, FreeMinecraftModels fornece uma API para desenvolvedores.

Integração Maven/Gradle:

Repositório: https://repo.magmaguy.com/releases

Artifact:

  • GroupId: com.magmaguy
  • ArtifactId: FreeMinecraftModels
  • Scope: provided (deve ser instalado no servidor, não shade)

Classes Principais da API:

  • ModeledEntity (classe base)
  • StaticEntity
  • DynamicEntity
  • PropEntity

Exemplo de Uso:

StaticEntity staticEntity = StaticEntity.create(id, location);
if (staticEntity == null) {
    Bukkit.getLogger().warning("Falha ao criar modelo");
    return;
}
staticEntity.setRightClickCallback(...);
staticEntity.remove();

Importante:

Não faça shade do FreeMinecraftModels no seu plugin. Ele deve ser instalado separadamente no servidor.

Para documentação detalhada da API, veja o README oficial.

Como disfarço um jogador como um modelo personalizado?​

Info

O comando /fmm disguise transforma a aparência de um jogador em qualquer modelo personalizado.

Comando:

/fmm disguise <modelID>

Como funciona:

  • Torna o jogador invisível para outros jogadores
  • Sobrepõe o modelo personalizado na posição do jogador
  • O modelo segue os movimentos do jogador
  • Perfeito para servidores de roleplay ou eventos especiais

Exemplo:

/fmm disguise dragon

Para remover o disfarce:

/fmm undisguise

Requisitos:

  • Permissão: freeminecraftmodels.*
  • modelID deve ser um modelo convertido válido na sua pasta de modelos

Notas:

  • Hitbox do jogador permanece inalterada (mesma caixa de colisão)
  • Outros jogadores veem o modelo personalizado em vez da skin do seu jogador
  • O efeito de invisibilidade é permanente até você remover o disfarce

Como crio itens de modelo colocáveis?​

Info

O comando /fmm itemify cria itens especiais que jogadores podem usar para colocar modelos no mundo.

Comando:

/fmm itemify <model> <material>

Parâmetros:

  • model - Qualquer ID de modelo válido da sua pasta de modelos
  • material - Qualquer material do Minecraft (STICK, PAPER, DIAMOND, etc.)

Exemplo:

/fmm itemify lamp_post STICK

O que cria:

  • Um item personalizado com nome colorido em ouro: "Model Placer: [modelName]"
  • Lore descritiva explicando o item
  • O item é adicionado diretamente ao seu inventário
  • Clique com botão direito para colocar o modelo como prop

Casos de uso:

  • Dar itens aos jogadores para decorar suas construções
  • Criar "ovos de spawn" personalizados para móveis
  • Distribuir modelos sem dar permissões de construção
  • Kits de configuração para construção criativa

Requisitos:

  • Permissão: freeminecraftmodels.*
  • Jogador deve estar no jogo (não console)

Como depuro hitboxes de modelos?​

Info

O comando /fmm hitbox debug visualiza hitboxes de modelos usando partículas.

Comando:

/fmm hitbox debug [duration]

Parâmetros:

  • duration (opcional) - Por quanto tempo mostrar hitboxes em ticks (padrão: 100, máx: 1200)
  • 20 ticks = 1 segundo

Exemplos:

/fmm hitbox debug          # Mostrar por 5 segundos
/fmm hitbox debug 200      # Mostrar por 10 segundos

Como funciona:

  • Procura por modelos dentro de 10 blocos de você
  • Exibe limites de caixa delimitadora orientada (OBB) com partículas
  • Mostra tanto o modelo quanto seus limites de colisão
  • Útil para verificar tamanho e rotação de hitbox

Quando usar:

  • Testar se hitboxes correspondem aos modelos visuais
  • Depurar problemas de interação
  • Verificar rotações de hitbox
  • Solucionar problemas de detecção de clique

Requisitos:

  • Permissão: freeminecraftmodels.*

Nota: Hitboxes no FMM rotacionam com o modelo, diferente das AABBs padrão do Minecraft.

Posso criar modelos personalizados montáveis?​

Info

Sim, use o comando /fmm mount para criar modelos personalizados montáveis (recurso experimental).

Comando:

/fmm mount <modelID>

O que faz:

  • Spawna um cavalo na sua localização
  • Disfarça o cavalo como seu modelo personalizado
  • Automaticamente doma o cavalo e adiciona uma sela
  • Faz você montar o cavalo imediatamente

Exemplo:

/fmm mount dragon

Requisitos:

  • Permissão: freeminecraftmodels.*
  • ID de modelo válido

Notas importantes:

  • Este recurso é marcado como experimental
  • Velocidade de movimento e comportamento correspondem a um cavalo padrão
  • A hitbox do cavalo permanece inalterada
  • Funciona melhor com modelos projetados para montarias

Casos de uso:

  • Montarias personalizadas para servidores de roleplay
  • Transporte especial para jogadores VIP
  • Criaturas montáveis únicas para mapas de aventura