Solução de problemas do ElvUI: corrija UI, Lua e perfis

Solução de problemas do ElvUI: reproduza, isole e altere uma coisa

Para qualquer caso de solução de problemas do ElvUI, não comece apagando toda a pasta Interface ou WTF. Registre o que acontece: falta um painel, aparece um erro Lua, uma importação não muda nada ou um elemento aparece duas vezes. Recarregue uma vez, reproduza o mesmo sintoma e anote personagem, perfil e ramo do WoW. Um sintoma exato vira um teste verificável.

Depois identifique a camada que desenha o resultado. ElvUI, ElvUI_Libraries e ElvUI_Options são código do addon. Perfis e configurações do personagem ficam no WTF. Um módulo como Nameplates, Chat ou Aura Filters pode estar desativado dentro do ElvUI mesmo com a instalação correta. Alterar a camada errada cria ruído e dificulta o retorno.

Mantenha uma base funcional. Exporte o perfil, copie o WTF relevante e anote a versão instalada. O guia de perfis explica exportações seguras, e o guia de addons ajuda a conferir profundidade de pastas e plugins opcionais. Um backup transforma um reset arriscado em experimento controlado.

• Teste um sintoma visível por vez.
• Separe anotações de Retail, Classic e clientes antigos.
• Desative plugins opcionais antes de culpar o pacote base.
• Exporte o perfil antes de importar outro layout.
• Mantenha as pastas originais até o teste limpo passar.

Mapa da solução de problemas do ElvUI: classifique o sintoma

Um painel ausente e um erro Lua podem aparecer juntos sem ter a mesma causa. Veja se a lista de AddOns mostra as três pastas, se /ec abre e se o sintoma aparece em um perfil limpo. Se a janela de opções abre mas um módulo desapareceu, confira ativação, escopo do perfil e filtros. Se a janela inteira falha, comece por arquivos, dependências e pasta do cliente ativo.

Após uma atualização, compare a versão instalada com a página oficial da Tukui e a tag pública. O contexto atual confirmou v15.26 em 29 de agosto de 2026. O número de interface do jogo e a versão do ElvUI são diferentes; 12.1.0 não é uma versão do addon. O guia de atualização mostra a troca limpa que preserva o WTF.

Use a tabela para escolher o próximo teste pequeno. Ela é um mapa de decisão, não uma promessa de nomes idênticos em todos os ramos.

Siga um fluxo de solução de problemas do ElvUI em cinco passos

Um fluxo de solução de problemas do ElvUI precisa ser repetível. Ele deve indicar se a origem está nos arquivos, no perfil, em outro addon ou em uma API do ramo. Faça o teste fora de combate quando possível e anote cada alteração. Várias mudanças entre recargas escondem a causa.

Um perfil limpo não significa apagar o único perfil. Crie um perfil temporário ou copie os dados WTF antes. Compare uma base conhecida com uma variável e volte ao perfil original se o teste não ajudar.

Quando um teste funciona, adicione plugins e importações um por vez. Quando falha, restaure o backup e desça uma camada no mapa em vez de repetir o mesmo reset.

1. 1

   Registre o ambiente

   Anote ramo do WoW, personagem, versão do ElvUI, perfil ativo, atualização recente e sintoma exato. Diga se ocorre apenas em combate, após reload ou em todos os personagens.

2. 2

   Confirme os arquivos ativos

   Feche o WoW e abra a pasta iniciada pelo Battle.net. Em Interface/AddOns confirme ElvUI, ElvUI_Libraries e ElvUI_Options na profundidade correta e da mesma versão.

3. 3

   Teste o pacote base

   Desative plugins do ElvUI e addons não relacionados, inicie o jogo, digite /ec e verifique o módulo em um perfil temporário. Não importe um layout nesta etapa.

4. 4

   Altere um dono

   Ative o módulo, simplifique seu filtro ou restaure uma configuração padrão. Recarregue e reproduza o sintoma com a mesma unidade, alvo ou canal de chat.

5. 5

   Restaure e adicione devagar

   Se a base funcionar, recupere o perfil exportado e adicione plugins um por vez. Se falhar, mantenha as evidências e siga o caminho de arquivos, cliente ou suporte.

Corrija padrões comuns da solução de problemas do ElvUI

Se o ElvUI não aparece depois do download, revise a profundidade das pastas antes das configurações. Um arquivo do GitHub pode conter uma pasta externa como ElvUI-15.26; o WoW precisa das pastas reais um nível abaixo de AddOns. Confira também se você editou o cliente Retail ou Classic que o Battle.net inicia. O guia de instalação mostra o caminho esperado.

Para um erro Lua que começa após uma atualização, feche o jogo e troque as três pastas principais de modo limpo. Não misture pastas antigas e novas, pois módulos removidos podem continuar carregando. Teste sem plugins opcionais. Se o erro persistir em um perfil novo, guarde a primeira linha e confira o ramo antes de usar uma tag histórica.

Se um painel falta, mas a janela de opções funciona, confira o módulo, o escopo do perfil e a visibilidade. Nameplates, Chat, Cast Bar e Aura Filters têm guias próprios porque os donos são diferentes. Use os guias de Nameplates, Chat ou Aura Filters em vez de alterar UnitFrames sem relação.

Um reset de layout costuma ser um problema de perfil ou escala, não de instalação. Restaure o perfil exportado, confira resolução e escala, mova um quadro e recarregue. Se ele voltar, anote se o perfil global, de classe ou personagem é o dono. Nunca sobrescreva o único backup funcional.

Trate perfis, atualizações e ramos Classic com segurança

Perfis são dados de configuração; pastas são código executável. Faça backup do WTF antes de atualizar, mas substitua o código de modo limpo. O contexto oficial é v15.26 e a tag pública é a fonte estável dos links do site. Se a Tukui publicar uma versão posterior, compare a API oficial antes de chamá-la de atual.

Retail, MoP Classic, Classic Era e TBC Anniversary podem ter números de interface e comportamentos protegidos diferentes. Um perfil de um ramo pode conter campos ignorados por outro. Mantenha perfis separados, teste um layout simples e não copie configurações de uma captura sem saber cliente e versão.

Para um cliente arquivado ou servidor privado, verifique o build exato e use uma tag histórica rastreável apenas quando necessário. Um pacote antigo serve para reproduzir um ambiente, não para corrigir todo erro atual. Volte a uma versão compatível depois da comparação e mantenha o backup até um reload e logout completos.

• Faça backup do WTF antes de grandes mudanças.
• Mantenha código e dados de perfil como camadas de rollback.
• Anote o ramo junto a cada perfil exportado.
• Verifique versões na Tukui ou no repositório público.
• Trate tag antiga como artefato de teste, não garantia.

Quando parar a solução de problemas do ElvUI e reunir evidências

Resets repetidos raramente corrigem uma pasta de cliente errada, um addon companheiro ou uma API alterada. Pare quando o sintoma sobreviver a um teste limpo do pacote base com perfil temporário. Preserve o erro, ramo, versão e primeira ação reproduzível. Isso ajuda mais o suporte oficial do que dizer apenas que a UI quebrou.

Carregar um addon desatualizado não restaura compatibilidade; apenas esconde um aviso e não recria uma API removida. Não use mirror aleatório, string de perfil sem origem ou captura como prova de pacote seguro. Verifique a página do ElvUI na Tukui e o repositório público.

• Guarde a primeira linha do erro Lua e horário.
• Inclua ramo e versão no relatório.
• Mencione plugins e importações.
• Restaure o último backup bom antes de outro teste.