Pular para o conteúdo principal

FAQ do FreeMinecraftModels

Se você tem 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?​

Informações

Instalação:

  1. Baixe FreeMinecraftModels.jar e coloque na sua pasta de plugins
  2. Reinicie seu servidor para gerar as pastas do plugin
  3. Execute /fmm initialize se quiser o fluxo de configuração inicial
  4. Se você usa pacotes de conteúdo oficiais, vincule o Nightbreak com /nightbreaklogin <token>
  5. Use /fmm setup ou /fmm downloadall para conteúdo oficial gerenciado pelo Nightbreak
  6. Para conteúdo manual, coloque arquivos .bbmodel em ~/plugins/FreeMinecraftModels/imports/ e execute /fmm reload
  7. Encontre o resource pack gerado em ~/plugins/FreeMinecraftModels/output/FreeMinecraftModels.zip

Distribuindo o Resource Pack:

Escolha um destes métodos:

  • Opção A (Recomendada): Instale o 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 vinculado a uma entidade
  • /fmm spawn prop <id> - Spawna modelo persistente no mundo

Gerenciamento:

  • /fmm - Mostra resumo de configuração/ajuda
  • /fmm initialize - Abre o menu de configuração inicial
  • /fmm setup - Abre o menu de gerenciamento de conteúdo
  • /fmm downloadall - Baixa todo o conteúdo oficial acessível
  • /fmm updatecontent - Atualiza conteúdo oficial desatualizado
  • /fmm reload - Recarrega o plugin e converte novos modelos
  • /fmm version - Mostra a versão do plugin
  • /fmm stats - Exibe estatísticas de contagem de entidades

Recursos para Jogadores:

  • /fmm disguise <modelID> - Transforma sua aparência em um modelo customizado
  • /fmm undisguise - Remove o disfarce do jogador e restaura a aparência normal
  • /fmm itemify <model> <material> - Cria um item colocável que spawna o modelo especificado
  • /fmm craftify <modelID> - Abre um construtor de receitas interativo para criar uma receita de crafting para um prop
  • /fmm mount <modelID> - Spawna um cavalo montável disfarçado como um modelo customizado (experimental)

Depuração:

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

Administrativo:

  • /fmm deleteall - Remove todas as entidades modeladas carregadas no momento (use com cautela - sem prompt de confirmação)

Permissões:

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

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

Recursos e Limites de Modelos

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

Informações

Limites de Tamanho:

  • Máximo: 112x112x112 pixels (7x7x7 blocos no jogo)
  • FreeMinecraftModels usa escala interna 4x para atingir esses tamanhos
  • Resource packs 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)
  • Rotação em eixo único apenas
  • 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 Bones:

  • Bones 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 bone cria uma entidade separada (consideração de performance)

Nota de Performance:

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

Quais animações são suportadas?​

Informações

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

Animações Padrão:

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

Como Funciona:

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

Caso Especial:

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

O que são bones virtuais e como funcionam?​

Informações

Bones virtuais são bones especiais com nomes reservados que adicionam funcionalidade aos seus modelos:

Bones de Hitbox:

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

Bones de Name Tag:

  • Prefixo: tag_
  • Exibe texto acima dos modelos
  • Usado para nomeação de entidades

Bones de Rotação de Cabeça:

  • Prefixo: h_
  • Rotaciona com base na posição da cabeça do jogador/entidade
  • Rastreia movimentos de cabeça automaticamente

Uso:

Crie um bone 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 customizados, eu só vejo armadura de cavalo.​

Informações

Se, em vez de modelos customizados aparecendo no seu jogo, você só vê armadura de cavalo, o problema é provavelmente que você não mesclou o resource pack do FMM corretamente com seu resource pack pré-existente.

MagmaGuy desenvolveu um plugin chamado Resource Pack Manager (RSPM) que pode mesclar automaticamente resource packs 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 resource packs, os hospedará automaticamente e os distribuirá aos jogadores quando eles logarem no seu servidor.

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

Informações

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

1. Esqueceu de recarregar

Execute /fmm reload após colocar arquivos .bbmodel na pasta imports. Isso converte modelos e gera o resource pack.

2. Resource pack não aplicado

Jogadores precisam ter o resource pack do FMM ativo para ver os modelos.

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

3. Local de arquivo errado

Arquivos .bbmodel para importações manuais devem ir em: ~/plugins/FreeMinecraftModels/imports/

Se você está usando pacotes de conteúdo oficiais, use /fmm setup ou /fmm downloadall em vez de colocar arquivos manualmente.

4. Modelo com erros

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

5. Problema de mesclagem de resource pack

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

ViaVersion pode fazer com que Resource Packs não sejam exibidos corretamente.​

Informações

ViaVersion pode causar problemas com resource packs, particularmente ao executar um servidor em uma versão inferior a 1.21.4. O Minecraft introduziu mudanças na forma como resource packs são tratados a partir da 1.21.4. Se você está executando um servidor em uma versão como 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 resource pack, como modelos customizados do FMM (FreeMinecraftModels).

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

Nota: Esta é uma limitação do Minecraft e do ViaVersion, não específica do FreeMinecraftModels. A tradução de protocolo do ViaVersion pode não suportar totalmente as mudanças de resource pack ao executar em versões de servidor abaixo da 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 resource pack, incluindo modelos customizados do FMM.

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

Informações

Cada bone no seu modelo BlockBench cria uma entidade separada no Minecraft. Modelos com muitos bones podem impactar a performance do servidor.

Dicas de Otimização:

  • Minimize a contagem de bones nos seus modelos
  • Limite o número de modelos spawnados
  • Considere usar modelos Estáticos em vez de Dinâmicos quando animações não são necessárias
  • Evite spawnar muitos modelos com alta contagem de bones próximos uns dos outros

Explicação Técnica:

FreeMinecraftModels renderiza cada bone como uma entidade separada do Minecraft. Um modelo com 50 bones spawna 50 entidades. Em escala, isso impacta a performance.

Melhores Práticas:

  • Projete modelos com menos bones
  • Teste a performance com contagens realistas de spawn
  • Monitore o TPS do servidor ao adicionar novos modelos

Recursos Avançados

Preciso do Resource Pack Manager (RSPM)?​

Informações

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

O Que o RSPM Faz:

  • Mescla automaticamente resource packs de múltiplos plugins
  • Hospeda resource packs (não precisa de hospedagem externa)
  • Distribui packs para jogadores automaticamente ao logar
  • Elimina configuração manual de resource pack

Sem RSPM:

Você deve manualmente:

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

Por Que Usar o RSPM:

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

Baixar 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?​

Informações

Sim, FreeMinecraftModels fornece uma API para desenvolvedores.

Integração Maven/Gradle:

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

Artefato:

  • GroupId: com.magmaguy
  • ArtifactId: FreeMinecraftModels
  • Scope: provided (deve estar instalado no servidor, não faça 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("Failed to create model");
    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 customizado?​

Informações

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

Comando:

/fmm disguise <modelID>

Como funciona:

  • Torna o jogador invisível para outros jogadores
  • Sobrepõe o modelo customizado 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:

  • A hitbox do jogador permanece inalterada (mesma caixa de colisão)
  • Outros jogadores veem o modelo customizado em vez da skin do jogador
  • O efeito de invisibilidade é permanente até que você remova o disfarce

Como crio itens de modelo colocáveis?​

Informações

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 customizado com um nome de exibição decorado em dourado (ex: "✦ Wolf ✦")
  • 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 aos jogadores itens para decorar suas construções
  • Criar "ovos de spawn" customizados para mobília
  • 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?​

Informações

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

Comando:

/fmm hitbox visualize [duration]

Parâmetros:

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

Exemplos:

/fmm hitbox visualize          # Mostra por 5 segundos
/fmm hitbox visualize 200      # Mostra por 10 segundos

Como funciona:

  • Busca 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:

  • Testando se hitboxes correspondem aos modelos visuais
  • Depurando problemas de interação
  • Verificando rotações de hitbox
  • Solucionando problemas de detecção de clique

Requisitos:

  • Permissão: freeminecraftmodels.*

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

Posso criar modelos customizados montáveis?​

Informações

Sim, use o comando /fmm mount para criar modelos customizados 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 customizado
  • 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 customizadas para servidores de roleplay
  • Transporte especial para jogadores VIP
  • Criaturas montáveis únicas para mapas de aventura