O que é macaco das super poderosas
macaco das super poderosas é basicamente um framework experimental de geração de assets procedurais que nasceu como um projeto de estudo em renderização em tempo real no Brasil e foi crescendo de forma bem orgânica. A ideia original era criar modelos 3D de personagens com habilidades animadas usando apenas configuração JSON, sem precisar passar por um pipeline de rigging manual. Funciona sim, mas não é mágica.
Baixando e instalando macaco das super poderosas
O repositório oficial tá no GitHub sob o nome do projeto. Você baixa o ZIP, extrai, e roda o instalador que vem na pasta root. Ele pede Python 3.10 ou superior e Node 18. Se você tentar rodar no 3.9, o build quebra na etapa de compilação do backend gráfico. Isso já foi corrigido nas versões mais novas, então atualize antes de reclamar nos fóruns. O download principal pode ser encontrado aqui: https://github.com/macacosuperpoderosas/framework/releases/latest. Tem a versão standalone com tudo incluído e a versão developer, que só precisa do pacote npm se você já tem um ambiente configurado. Eu recomendo começar pela standalone, especialmente se você nunca mexeu com isso antes.
Configuração básica
Depois de instalar, rode o comando de inicialização. Ele vai criar a pasta de configuração em ~/.config/macaco-sp/. Dentro dela tem o arquivo config.json, onde você define o renderer padrão, o caminho dos assets, e as credenciais de API se for usar a nuvem para armazenamento. Uma coisa que muita gente perde tempo: o motor de renderização por padrão vem como webgl2, mas se sua máquina tiver uma GPU dedicada da NVIDIA ou AMD, mude para vulkan no config.json. O ganho de performance costuma ser entre 30% e 50% em cenas com múltiplos personajes ativos. Eu descobri isso depois de testar em uma máquina com RX 6700 XT e WebGL travava em exportações com mais de oito bonecos na tela.
Como gerar seu primeiro asset
A estrutura de um projeto no macaco das super poderosas é baseada em camadas. Cada personagem é definido por um arquivo de configuração principal e um conjunto de sprites ou malhas 3D organizados em pastas por skill. O comando básico de geração é: macaco-sp generate --config meu-personagem.json --output dist/
Isso processa a configuração e exporta os assets prontos. O tempo varia muito dependendo da complexidade, mas num setup médio, leva entre dois e cinco minutos por personagem com três skill slots preenchidos.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Problema real que eu encontrei
A questão mais chata que eu tive com macaco das super poderosas foi quando exportei um personagem que tinha duas skills do tipo projétil. O sistema gerou os assets corretamente, mas na hora de rodar a animação combinada, os hitboxes das duas skills entravam em colisão e o motor descartava uma delas. O problema é conhecido e tem um workaround que funciona: Você precisa adicionar o campo disable_overlap_check como true dentro do objeto skill da configuração. Isso desativa a verificação de sobreposição de hitbox durante a exportação. Não é ideal do ponto de vista de balanceamento se for pra jogo competitivo, mas pra prototipagem ou projetos indie funciona perfeitamente. Eu gastrei quase uma tarde inteira debugando isso até achar a solução nos issues do GitHub.
Conceitos avançados que poucos explicam
O sistema de blending de skills no macaco das super poderosas não é linear como a maioria pensa. Cada skill tem um peso interno que determina como ela se mistura com outras quando ativadas simultaneamente. O problema é que esse peso é calculado pela ordem de definição no JSON, não pela prioridade visual. Se você colocar a skill de ataque primeiro e a de defesa depois, o motor vai tratar a defesa como secundária e ela pode não ativa quando você espera que ative. Outra pegadinha: o cache de textura. Por padrão, o motor mantém um cache de texturas na memória RAM que cresce sem limite durante sessões longas. Em sessões de teste de três horas ou mais, isso pode consumir mais de dois gigabytes de RAM. A solução é configurar o parâmetro max_cache_size no config.json para algo como 512MB e habilitar o flush automático a cada quinze minutos.
Limitações que ninguém fala
O macaco das super poderosas não é adequado para projetos que precisam de precisão frame a frame em esportes ou jogos de luta. O motor de animação usa interpolação suave entre frames, o que introduce um atraso de cerca de meio frame em comparações rigorosas. Se o seu jogo depende de hit detection preciso, você vai precisar de uma camada extra de validação manual ou usar outro engine como base. Também não tem suporte nativo a exportação para Unreal Engine 5 ou Unity 2023+. O formato de exportação suportado é GLB e PNG sequencial. Se você precisa integrar com esses engines, terá que fazer uma conversão intermediária, o que adiciona ao pipeline e pode introduzir perda de qualidade nas texturas.
Para quem quer algo mais robusto e com suporte a motores AAA, o Godot com seus próprios assets procedurais ou o Blender com add-ons de rigging automático são alternativas mais estáveis. O macaco das super poderosas serve bem para protótipos rápidos, jogos indie, e testes de conceito, mas não substitui ferramentas estabelecidas no mercado profissional.
Dicas práticas que economizam tempo
Se você tá começando agora com macaco das super poderosas, mantenha o primeiro projeto simples. Crie um personagem com uma única skill e vá adicionando complexidade gradualmente. Quanto mais skills você coloca de uma vez, mais difícil é isolar problemas de colisão e blending. Também não use nomes de arquivo com acentos ou espaços — o parser do motor não lida bem com caracteres especiais e isso gera erros silenciosos que demoram pra ser identificados. Mantenha o config.json organizado com comentários. O motor ignora comentários no JSON, mas ajuda você e qualquer outra pessoa que for dar manutenção no projeto meses depois. Eu recomendo manter uma cópia de cada configuração que funcione antes de fazer alterações, só por segurança.
