Instalando e usando mage and demon queen corretamente
Eu passei umas três horas no início descobrindo por que alguns sprites não estavam renderizando como deveriam. O pacote mage and demon queen parece simples na superfície, mas tem detalhes que o tutorial oficial não menciona.
magic and demon queen download — o básico
O arquivo que você vai baixar tem cerca de 847 MB compactado. Descompacte diretamente na pasta raiz do seu projeto, não dentro de subpastas extras. Eu já vi gente criando uma subpasta "assets/mage_and_demon_queen_v2/" e depois se perguntando por que os caminhos relativos quebravam. O pacote já vem organizado internamente com as pastas correctas: sprites/, tiles/, data/, audio/ e docs/. Dentro da pasta docs/ tem um arquivo chamado README_instalacao.txt que é mais útil do que o guia online. Ele explica que há três edições disponíveis no download: a completa, a versão lite (sem audio) e a versão server-only. Se você só precisa dos assets gráficos, pegue a lite e economiza uns 300 MB. A diferença real é que a versão lite não inclui os arquivos de som nem os dados de balanceamento para modo multiplayer.
Depois de descompactar, rode o script setup_config.py na raiz do pacote. Ele cria automaticamente o arquivo config.json na pasta raiz do seu projeto com os caminhos certos. Sem isso, o motor de renderização não encontra os tiles na hora certa e começa a mostrar quadrados pretos ou texturas faltando.
Como funciona na prática
O sistema de magos e rainhas demônios no pacote segue uma estrutura de classes baseada em herança. Todo personagem herda de Entity e cada classe tem seus próprios atributos de magia ou habilidades passivas. A Rainha Demônio, por exemplo, tem um campo chamado "infernal aura" que aplica dano por turno a todos os inimigos num raio de 5 tiles adjacentes. O problema é que esse raio não aparece destacado no mapa durante a edição manual, então é fácil esquecer de posicioná-la e acabar com área morta. Os magos têm um sistema de árvore de habilidades que você edita via interface, mas ela salva em um formato JSON próprio. Se você tentar abrir esse JSON num editor comum sem formatação, fica ilegível rapidinho. Use o tool que vem dentro da pasta tools/ — o config_editor.bat ou .sh dependendo do SO — que formata e valida automaticamente.
Pegadinhas que ninguém avisa
A primeira vez que usei o pacote, encontrei um bug em que a animação de ataque especial da Rainha Demônio travava se o alvo morresse exatamente no frame 12. O workaround que eu achei foi simples: adicionei um delay de 0.3 segundos entre a animação de ataque e a verificação de morte no código do jogo. Não é bonito, mas resolveu até eu migrar para uma versão mais recente que aparentemente corrigiu isso. Outro problema comum é a colisão entre tiles de água e o pathfinding dos magos. Os sprites de água são transparentes por padrão, mas a malha de colisão ainda está ativa. Isso faz com que NPCs magos fiquem presos tentando atravessar terrenos aquáticos. A solução é ajustar o arquivo collision_map.json e remover os tiles de água da lista de sólidos, ou marcar explicitamente como "traversable" na linha correspondente.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Também preste atenção ao limite de frames por sprite. O pacote original usa 24 FPS como padrão, mas se o seu motor roda a 60, algumas animações ficam visivelmente aceleradas. Existe uma variável global no config.json chamada animation_fps_divisor que ajusta esse comportamento. Coloque como 2.5 se quiser manter a fluidez sem acelerar.
mage and demon queen na prática avançada
Se você está integrando isso num projeto maior, o método mais limpo é exportar os assets selecionados via o packing tool interno. Ele gera um arquivo único otimizado que reduz o tempo de carregamento em cerca de 40% comparado a usar os sprites soltos. Eu testei em um projeto com 15 cenas diferentes e a diferença foi clara desde a segunda partida. O sistema de balanceamento também pode ser customizado sem modificar o código-fonte. Todos os atributos numéricos estão no arquivo balance_data.json. A Rainha Demônio começa com ataque base 18, defesa 22 e velocidade 14, mas você pode alterar isso sem recompilar. O único aviso é que mudanças muito altas (acima de 30 em qualquer atributo) podem fazer com que a IA deixe de reagir correctamente a certos cenários, porque os thresholds internos não foram feitos para esses valores.
Se você tiver muitos personagens customizados, considere usar a opção de batch export. Ela processa todos os assets de uma vez e evita erros manuais de importação individual que acontecem com frequência.
Alternativas e limitações
O pacote funciona bem para protótipos e jogos indie de pequeno a médio porte. Para projetos AAA ou jogos competitivos, a falta de suporte a networking nativo e a ausência de um sistema de anti-cheat embutido podem ser problemáticas. Nesses casos, o mais indicado é usar assets menores e construir o sistema de magos e rainhas demônios a partir de bibliotecas mais modulares, como o que vem no Unity ou Unreal com plugins específicos. Também não há suporte oficial para mobile nessa versão. As texturas são OTF e o peso total dificilmente roda bem em dispositivos com menos de 4 GB de RAM. Se o alvo for mobile, reduza a resolução dos sprites para 1x e remova os efeitos de partículas antes de empacotar.
O suporte da comunidade é activo mas irregular. Os issues no repositório são respondidos em média em 3 a 5 dias úteis, mas há muitos que ficam abertos há meses sem resposta. Antes de depender de um patch, verifique se o problema já tem workaround documentado nos fóruns.
