Criando um fnf personagem do zero
A base é o Character Editor do próprio FNF ou ferramentas como o Funkin' Character Builder. O que a maioria das pessoas não entende na hora de começar é que a hierarquia dos arquivos precisa estar exatamente certa, senão o jogo ignora o personagem silenciosamente e simplesmente não carrega. Eu passei duas noites tentando entender por que um personagem customizado aparecia como um cubo rosa no jogo, só para descobrir que estava faltando um arquivo de animação na pasta correta. O log do jogo não mostra erro nenhum, o que é irritante.
O que você precisa antes de começar
Você precisa ter os assets prontos: sprite sheet com as poses padrão (idle, left, right, up, down), animações de canto em 8-bit ou 16-bit dependendo do padrão do mod, e o arquivo de definição em JSON ou Lua. O FNF original usa uma estrutura baseada em Character.hx para definir nome, paths das imagens, e velocidade de animação. Modos mais modernos usam a API HScript, que é mais flexível mas exige que você saiba ler a documentação do código fonte no GitHub. As pastas precisam seguir essa ordem: assets/shared/images/characters/ para os sprites, scripts/ para o arquivo de definição, e o mod deve ter o arquivo modchart.json ou content.json listando o personagem corretamente. Se faltar uma linha nessa lista, o jogo nem tenta carregar o arquivo de sprite.
Passo a passo prático
Primeiro, gere seus sprites. Existe o FNF Spriter Tool que exporta direto para o formato que o jogo lê, mas eu prefiro usar o Aseprite com um script de importação que já divide o canvas em frames individuais. O resultado é muito mais limpo e você evita artefatos que aparecem quando o engine tenta interpolar frames que não deveriam ser interpolados. Depois, crie o arquivo de definição. Um mínimo funcional fica assim:
name = "NomeDoPersonagem"
images = "assets/shared/images/characters/NomeDoPersonagem"
looped = false
updateHit = true Coloque esse arquivo na pasta scripts/ com extensão .hx ou .lua dependendo da versão do modloader que você está usando. A versão mais comum hoje em dia é a Revolution ou Liminal, que exigem arquivos .lua, enquanto versões mais antigas usam .hx diretamente.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Por fim, atualize o content.json. Adicione uma entrada no array de characters com o caminho correto. Sem isso, o jogo não reconhece o personagem na seleção de rota.
Problema específico que encontrei
Tive um caso em que um personagem simplesmente não entrava em modo de ataque quando a música atingia o refrão. A animação de idle funcionava, mas qualquer chamada de animação dinâmica era ignorada. O problema era que o arquivo de sprites tinha uma dimensão de frame errada — eu tinha exportado em 360x360 pixels quando o padrão do jogo esperava 350x350. O FNF não reclama, ele só desenha fora do lugar ou corta o sprite. Mudei para 350x350 e o personagem funcionou perfeitamente. Esse detalhe de resolução nunca é mencionado em tutoriais, mas é a causa mais comum de sprites que não aparecem direito.
Recursos úteis
O repositório oficial de ferramentas fica em github.com/FunkinCrew/funkin. A comunidade também mantém um wiki em github.com/IGINetwork/Funkin-Character-Editor com templates prontos. Para downloads de sprites, o site newgrounds.com ainda é o lugar mais confiável — pesquise por "fnf personaje" ou "funkin character sprites" e filtre por data recente para achar artes que já estão no formato certo.
O que funciona e o que não funciona
Personagens com muitas animações (mais de 20 frames por pose) tendem a travar em hardware mais fraco, especialmente em mobile. O jogo não é otimizado para carregar mais de 12 sprites ao mesmo tempo sem perder FPS. Se você está fazendo um mod para rodar em qualquer dispositivo, mantenha o total de animações abaixo disso. Também evite usar PNGs com transparência em camadas excessivas — cada layer extra aumenta o tempo de loading e pode causar freezes na transição entre cenas. Se o seu objetivo é só adicionar um personagem rápido sem mexer no código, existe o Character Generator do próprio FNF Plus, que cria um pacote pronto para importar. Vale a pena testar primeiro antes de escrever código manualmente, porque gera bastante retrabalho se o layout dos frames vier desalinhado.
