VRM no Blender: importação, o que quebra e as correções
O Blender não lê .vrm sozinho. Com a extensão gratuita VRM format ele lê, e a maior parte do que então parece errado não é dano, e sim uma diferença entre o que um app de VRM mostra e o que o Blender mostra por padrão. Esta página percorre a importação, as cinco coisas que as pessoas relatam como quebradas e o caminho de volta para VRM ou FBX.
Escrito com base no Blender 4.2 a 4.5 com a extensão VRM format 4.x, em arquivos VRM 0.x e 1.0 do VRoid Studio e do nosso próprio conversor, 10 de novembro de 2026.
Instalar a extensão
O add-on está listado na plataforma Blender Extensions como VRM format, de saturday06, licença MIT, para Blender 4.2 ou mais recente. Blenders mais antigos instalam o mesmo add-on a partir de um ZIP.
- Blender 4.2+: Edit → Preferences → Get Extensions, procure VRM e clique em Install. Sem internet: baixe o ZIP em vrm-addon-for-blender.info e use Install from Disk.
- Blender 2.93 a 4.1: Edit → Preferences → Add-ons → Install, escolha o ZIP e ative Import-Export: VRM format (mude o filtro para Community se ele estiver escondido).
- Uma aba VRM aparece na barra lateral da viewport 3D (tecla N), e File → Import e File → Export ganham uma entrada VRM (.vrm).
Importar e o que você vê
File → Import → VRM (.vrm). Você recebe uma armação com os ossos humanoides, as malhas como filhas dela com seus pesos de skin, as texturas empacotadas no .blend e cada material montado como um grupo de nós MToon, quando o arquivo usava MToon, ou como Principled BSDF para materiais PBR. As expressões do VRM (piscar, as vogais, alegria, raiva e as demais) são vínculos: a shape keys nas malhas e, em arquivos VRM 1.0, também a cores de material e deslocamentos de textura. As shape keys chegam nas malhas; os vínculos ficam na aba VRM, e uma expressão que vincula um material aparece lá, não como shape key.
Os spring bones (cabelo, saias, caudas) são importados como dados na armação, mas o Blender não os simula como um app de VRM faz: o cabelo fica parado enquanto você posa. Isso não é um arquivo quebrado. A documentação da extensão descreve os spring bones nos termos do Unity e não oferece prévia do movimento deles; a exportação mantém os dados de spring, e o próximo app os balança de novo.
Cinco coisas que parecem quebradas
As que mais aparecem.
- O avatar parece escuro ou desbotado. O MToon é um shader toon; o view transform padrão do Blender, Filmic ou AgX, trata a imagem como uma fotografia. Render Properties → Color Management → View Transform: Standard, como recomenda a página de MToon da extensão. Os contornos só aparecem no Blender 3.3 e 3.5 ou mais recente.
- Superfícies rosa ou cinza. Rosa significa imagem de textura faltando: o arquivo referenciou uma que não continha, ou o .blend foi salvo sem empacotar. Cinza em todas as superfícies normalmente significa sombreamento Solid; mude a viewport para Material Preview.
- Ele olha para o lado errado, ou os braços vão para o lado errado ao posar. Avatares VRM 0.x olham para −Z no espaço glTF, avatares VRM 1.0 olham para +Z, e o arquivo não diz isso; a versão diz. O importador do Blender cuida da rotação, mas um script ou uma ferramenta de retarget que lê os eixos dos ossos precisa separar por versão, ou uma das duas vai levantar um braço onde deveria abaixá-lo. Nada a corrigir na malha.
- Ele fica em A-pose e a ferramenta quer T-pose, ou o contrário. A pose de repouso é a que o autor exportou. Posar a armação não faz mal. Mudar a pose de repouso (aplicar uma pose como novo repouso) precisa levar junto todas as shape keys, então faça isso antes de editar as expressões e teste cada expressão depois. A extensão também consegue exportar VRM 0.x a partir de uma T-pose que ela mesma monta.
- Os nomes dos ossos não são os que meu rig espera. O VRM guarda um mapa dos seus slots humanoides (hips, spine, leftUpperArm …) para o nome que os ossos tiverem; os nomes no arquivo podem ser do VRoid, do Mixamo ou em japonês. A aba VRM mostra o mapa, e a extensão consegue atribuir os slots humanoides automaticamente para os esquemas de nomes mais comuns. Não renomeie nada à mão antes de olhar lá.
Exportar de volta para VRM
File → Export → VRM (.vrm). O exportador verifica primeiro o mapa humanoide e se recusa a escrever um arquivo em que um osso obrigatório (hips, spine, head, os membros) não tem slot; preencha o mapa na aba VRM e defina lá também os metadados: título, autor, licença, para que o avatar pode ser usado. Um VRM sem licença é um VRM que ninguém pode usar legalmente.
Escolha a versão a escrever conforme o app de destino. O VSeeFace lê só VRM 0.x; os outros apps dizem nas próprias páginas qual versão aceitam. Se você acabar com a versão errada, o conversor de versão VRM troca um arquivo pronto entre as duas e lista o que não foi trazido.
| O que você quer | Exportar |
|---|---|
| VSeeFace | VRM 0.x |
| VRoid Hub, projetos UniVRM 1.x, apps em three.js | VRM 1.0 ou 0.x; a página do app diz qual |
| Projeto de jogo no Unity ou Unreal | FBX, pelo conversor VRM para FBX |
| Um arquivo para compartilhar, com a licença legível | VRM; confira no visualizador |
Quando o Blender é o desvio
Muitas vezes o objetivo real não é o Blender. Para um motor de jogo, o conversor VRM para FBX escreve um FBX binário com o rig, as blend shapes e as texturas como imagens separadas, que o Unity e o Unreal importam diretamente; o exportador de FBX do Blender, em comparação, só mapeia materiais Principled BSDF com nós de imagem, então os grupos de nós MToon saem sem as texturas. Na outra direção, um .blend pronto vai para VRM com o conversor Blender para VRM sem instalar nada.
Perguntas
- Quais versões do Blender funcionam?
- A plataforma Extensions lista o add-on para Blender 4.2 até a versão atual; o site do projeto tem ZIPs para 2.93 a 4.1. O Blender 2.8x não é suportado.
- Posso editar as shape keys e manter as expressões?
- Sim. As expressões referenciam as shape keys pelo nome, então edite as formas à vontade; renomeie ou apague uma e a aba VRM vai mostrar a expressão apontando para nada.
- Por que o cabelo não se mexe quando eu reproduzo uma animação?
- Os spring bones são dados para o runtime, não uma simulação do Blender. O arquivo exportado continua com eles; o app de VRM é quem os move.
- Posso exportar FBX do Blender em vez de VRM?
- Pode, mas os materiais MToon são grupos de nós que o exportador de FBX não mapeia, então o FBX sai sem as texturas deles. Exporte o VRM e use o conversor VRM para FBX, ou reconstrua antes os materiais como Principled BSDF com nós de imagem.
- A extensão muda a licença do meu arquivo?
- Não. Os metadados que você importa são os metadados que você exporta, e os nossos conversores VRM mantêm a licença que o arquivo já declara; um FBX não tem campo para ela. Confira a licença na aba VRM ou no visualizador antes de redistribuir um avatar modificado.
Precisa do FBX, não do projeto do Blender?
Arraste o .vrm e receba um FBX binário com o rig, as blend shapes e as texturas, pronto para o Unity ou o Unreal. Grátis, sem cadastro, os arquivos são apagados após 3 dias.
Abrir o conversor VRM para FBXA VRM as a binary FBX with its rig, blend shapes and textures, for Unity, Unreal or Blender.