Como Instalar Mods em World of Warcraft (2026)

Um guia sobre como baixar e instalar addons em World of Warcraft no Windows e macOS.

World of Warcraft os chama de addons em vez de mods, e é um dos poucos casos nestes guias em que o jogo foi construído para aceitá-los. A Blizzard fornece uma API de addons, uma tela de gerenciamento de addons na seleção de personagem, e uma política publicada cobrindo o que os addons podem e não podem fazer. Não há mod loader, nenhum injetor e nada para aplicar patch. Você coloca uma pasta no lugar certo e o jogo a carrega.

Nosso exemplo é o Details! Damage Meter, que com mais de 367 milhões de downloads é um dos addons mais instalados da história do jogo.

Requisitos

• Um PC rodando Windows 10 ou superior, ou um Mac. Ambos são totalmente suportados, e tudo neste guia funciona em qualquer um deles.
• World of Warcraft instalado através do launcher Battle.net.
• Muito pouco espaço em disco. Addons são arquivos de texto Lua e XML mais alguma textura ocasional, então mesmo uma coleção grande é pequena.
• Um extrator de arquivos se você instalar manualmente. Windows e macOS lidam nativamente com .zip.

Addons são oficialmente sancionados. A Blizzard publica uma UI Add-On Development Policy estabelecendo as regras, e não há risco de banimento ao usar addons que a sigam. O que não é permitido é automação que joga o jogo por você, e nenhum addon do CurseForge ou Wago vai fazer isso.

Como Funcionam os Addons do WoW

Um addon é uma pasta de scripts Lua, arquivos de layout XML e um manifesto .toc. O WoW escaneia uma pasta específica ao iniciar, lê cada .toc, e carrega o que encontra.

Não há framework para instalar por baixo. Nada para fazer hook no jogo, nada para injetar, nada que rode fora da própria sandbox de scripting do WoW.

Flavors

Essa é a parte que pega as pessoas, porque o WoW não é mais um único jogo.

Retail e cada linha Classic rodam clientes separados, com pastas de addons separadas e builds de addons separados. Uma página de addon no CurseForge lista quais flavors ela suporta, e o Details! atualmente cobre:

Flavor	O que é
Retail	A expansão atual, no cliente 12.x
Classic	Classic Era
Classic TBC	The Burning Crusade Classic
MoP Classic	Mists of Pandaria Classic
Titan Reforged Classic	A linha Classic mais nova

Baixar o flavor errado te dá um addon que ou não aparece de forma alguma ou aparece acinzentado como desatualizado. Os addon managers escolhem o certo por você com base em qual instalação você aponta para eles, o que é uma das melhores razões para usar um.

Onde os Addons Ficam

Cada flavor tem sua própria pasta dentro da sua instalação do WoW. No Windows, o Retail fica aqui:

C:\Program Files (x86)\World of Warcraft\_retail_\Interface\AddOns

No macOS:

/Applications/World of Warcraft/_retail_/Interface/AddOns

Os outros flavors usam o mesmo layout com um nome de pasta diferente, como _classic_era_ ou _classic_. Há também _ptr_ se você tiver o public test realm instalado.

Cada addon é uma pasta diretamente dentro de AddOns, nomeada igual ao addon. O Details! se instala como uma pasta chamada Details.

NOTA - Se a pasta AddOns ainda não existir, crie-a. Ela só é criada quando algo precisa dela.

Instalando Com o App CurseForge

A opção mais comum, e a que as páginas de addon do CurseForge assumem.

1. Baixe o app CurseForge. Há uma build standalone leve e uma build Overwolf com recursos in-game; ambas funcionam, e a standalone é a opção mais leve. Builds para Windows, macOS e Linux estão todas disponíveis.
2. Abra-o e deixe-o detectar suas instalações do WoW. Ele encontra cada flavor separadamente.
3. Abra a seção World of Warcraft e escolha o flavor ao qual deseja adicionar addons.
4. Procure por Details! Damage Meter e clique em Install.
5. O app baixa a build correta para aquele flavor e a coloca na pasta AddOns certa.

O app também lida com atualizações, que é a verdadeira razão para usá-lo. Os addons do WoW quebram a cada patch de conteúdo, e conseguir atualizar trinta deles de uma vez importa mais aqui do que na maioria dos jogos.

Instalando Com o WowUp

WowUp é um addon manager gratuito, open source, construído pela comunidade, com builds para Windows, macOS e Linux. Ele pode buscar de múltiplos sites de addons em vez de apenas um, o que é útil porque nem todo addon está no CurseForge.

1. Baixe o WowUp em wowup.io.
2. Na primeira execução ele escaneia por instalações do WoW e lista cada flavor que encontra.
3. Abra Get Addons, procure por Details! Damage Meter e instale-o.
4. Use My Addons para ver o que você tem e atualizá-lo.

O WowUp também pode adotar addons que você instalou manualmente, combinando-os com sua fonte para que comecem a receber atualizações. Se você tem uma pasta cheia de addons instalados manualmente de anos atrás, apontar o WowUp para ela é uma forma rápida de trazer tudo de volta sob gerenciamento.

Instalando Com o App Wago

Wago Addons é o outro grande host de addons, e as mesmas pessoas mantêm o wago.io para WeakAuras e outras strings de importação. O Wago App gerencia addons do catálogo deles.

1. Baixe o app em addons.wago.io/app.
2. Deixe-o encontrar suas instalações do WoW.
3. Navegue ou pesquise, e instale.

A verdadeira vantagem do Wago App é o resto do ecossistema Wago. Se você já está importando strings de WeakAuras ou pacotes de UI de lá, ter um único app que lida com os addons junto com eles é conveniente.

DICA - Evite rodar dois addon managers na mesma instalação, se puder. Ambos tentarão possuir as mesmas pastas e você terá addons duplicados ou parcialmente atualizados. Escolha um.

Instalando Manualmente

Vale a pena conhecer, e é genuinamente fácil no WoW.

1. Acesse a página do Details! Damage Meter na CurseForge.
2. Em Files, escolha o arquivo correspondente à sua flavor. Para a expansão atual, esse é o build Retail.
3. Baixe o .zip.
4. Extraia-o.
5. Copie a pasta extraída, Details, para dentro da sua pasta Interface\AddOns.
6. Reinicie o WoW se ele estiver aberto.

O resultado deve ser:

World of Warcraft\_retail_\Interface\AddOns\Details\

com o arquivo .toc do addon e seus arquivos Lua dentro.

AVISO - A pasta do addon vai diretamente dentro de AddOns, e o nome da pasta precisa corresponder ao que o addon espera. Uma pasta aninhada como AddOns\Details-v1.2.3\Details\ não vai carregar, e arquivos Lua soltos dentro de AddOns também não. Alguns addons vêm com várias pastas em um único zip, por exemplo um addon principal mais uma biblioteca, e todas elas vão para dentro de AddOns lado a lado.

O App do TMC

A última opção é a nossa, com a ressalva de que o WoW já é o jogo mais bem servido desta série de guias no quesito de gerenciadores. O App do TMC faz instalações com um clique, tem sandboxes (perfis de mods nomeados por jogo, cada um com seu próprio método de deployment), um navegador de servidores com gráficos de latência ao vivo e RCON.

World of Warcraft não está na sua lista de jogos suportados. Entre o app da CurseForge, o WowUp e o Wago App, o gerenciamento de addons já é um problema resolvido por aqui, então este fica mais abaixo na nossa lista do que jogos sem nenhuma ferramenta decente. Preferimos dizer isso a inflar a lista.

O app também está em desenvolvimento bem inicial. Seu README o descreve como parcialmente testado, e essa é uma descrição justa. Se você usa o app para outros jogos e gostaria de suporte ao WoW, dizer isso é a forma mais rápida de fazer isso subir na fila.

É open source sob a licença GPL-3.0 em github.com/modcommunity/tmc-app. Bugs, pedidos de recursos e "por favor, suportem este jogo" — tudo isso tem lugar no issue tracker, pull requests são bem-vindos, e adicionar um jogo acaba sendo só quatro arquivos JSON em vez de qualquer código, então contribuir com suporte ao WoW está bem ao alcance.

Instalando-o:

• Linux: uma linha, sem root e sem gerenciador de pacotes.

curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh

• Windows: o setup.exe ou setup.msi da página de releases. Há também um build portátil, embora ele não registre a entrada do launcher nem o manipulador de links tmc://.
• macOS: o .dmg da mesma página de releases.

Ativando Addons no Jogo

Instalar não é bem todo o trabalho.

1. Inicie o WoW e vá até a tela de seleção de personagem.
2. Clique em AddOns no canto inferior esquerdo.
3. Certifique-se de que seus addons estão marcados.
4. Entre no mundo.

Addons novos geralmente já vêm ativados por padrão, mas essa é a primeira coisa a verificar quando algo que você acabou de instalar não aparece.

A lista de addons é por personagem por padrão, com um menu suspenso All para aplicar sua seleção a todos. Isso é útil quando você quer um damage meter no seu personagem de raid, mas não na sua mula de banco.

Dentro do jogo, /reload recarrega a interface sem precisar deslogar, o que aplica alterações nos arquivos dos addons. Alguns addons também registram seu próprio comando de barra, e o Details! usa /details.

Configurações e Dados Salvos

As configurações dos addons não ficam armazenadas junto com o addon. Elas ficam na pasta WTF, junto com o resto da configuração da sua interface:

World of Warcraft\_retail_\WTF\Account\<ACCOUNT>\SavedVariables

com dados por personagem nas pastas do reino e do personagem abaixo dessa.

Isso traz duas consequências úteis. Atualizar ou reinstalar um addon não faz você perder sua configuração, já que ela fica em um lugar totalmente diferente. E fazer backup da sua pasta WTF faz backup de toda a sua configuração de UI, o que vale muito a pena antes de um patch grande.

Mantendo os Addons Funcionando Após um Patch

Todo patch de conteúdo do WoW aumenta a versão da interface, e todo addon cujo .toc ainda cite a versão antiga é marcado como desatualizado e desativado.

Quando isso acontece:

1. Atualize seus addons primeiro. A maioria dos autores lança um build compatível em poucas horas após um patch, e um gerenciador de addons resolve isso com um clique.
2. Se um addon ainda não foi atualizado, você pode marcar Load out of date AddOns na tela de AddOns da seleção de personagem. Muitas vezes funciona normalmente, já que a versão da interface é apenas uma declaração. Às vezes dá erro o tempo todo, e nesse caso desative-o e espere.
3. Patches de expansões grandes quebram mais coisas. Espere alguns dias para os addons se atualizarem, em vez de algumas horas.

DICA - Se sua UI aparecer quebrada depois de um patch, o diagnóstico mais rápido é desativar tudo, confirmar que a UI padrão está funcionando, e reativar em lotes.

Desinstalando

Usando um gerenciador, basta desinstalar da lista de addons e a pasta é removida.

Manualmente, apague a pasta do addon em Interface\AddOns.

De qualquer forma, as variáveis salvas do addon permanecem na WTF. Isso é proposital, para que reinstalar traga suas configurações de volta. Se você quiser um recomeço realmente limpo, apague também o arquivo .lua correspondente na pasta SavedVariables.

Solução de Problemas

O addon não aparece na lista de AddOns. A estrutura de pastas está errada. Verifique se há uma pasta aninhada, ou seja, AddOns\Details\Details.toc em vez de AddOns\Details-12.1\Details\Details.toc.

Ele aparece na lista, mas acinzentado. Está desativado, ou marcado como desatualizado. Marque-o, e marque Load out of date AddOns se necessário.

Instalado na flavor errada. Muito comum. Certifique-se de que seu gerenciador está apontado para _retail_ e não para uma instalação Classic, ou vice-versa.

Erros de Lua por toda parte após um patch. Atualize seus addons. Se algum insistir em dar problema, desative-o e verifique sua página na CurseForge em busca de um build compatível.

O addon carrega, mas sua janela sumiu. Muitos addons têm uma opção de travar ou esconder, e alguns guardam uma posição fora da tela. Verifique primeiro as próprias opções do addon; /details para o Details!. Como último recurso, apague o arquivo de variáveis salvas dele para resetá-lo.

Dois gerenciadores brigando entre si. Ambos estão gerenciando a mesma pasta. Escolha um e desinstale o outro.

As configurações de UI da Blizzard foram redefinidas. Verifique se você excluiu ou moveu algo da pasta WTF. Essa pasta guarda tanto as configurações da Blizzard quanto os dados dos addons.

Conclusão

Os addons do WoW são a instalação mais simples de todo este conjunto de guias. Não há loader, o jogo já vem com uma tela de gerenciamento integrada, e um gerenciador como o CurseForge app ou o WowUp reduz tudo a pesquisar e clicar em instalar.

As duas coisas que realmente causam problemas são as flavors e os patches. Certifique-se de estar instalando para o cliente correto, e espere gastar alguns minutos atualizando addons após cada patch de conteúdo.

Para os jogos que são menos bem atendidos do que este, o TMC App é o nosso. Ele é open source, está em estágio inicial de desenvolvimento, e feedback sobre ele é sempre bem-vindo.

Veja Também

• Addons de World of Warcraft na CurseForge
• Wago Addons
• WowUp
• Código-fonte do Details! Damage Meter no GitHub
• Discord oficial de World of Warcraft
• TMC App

Mantemos este guia o mais atualizado possível, mas tanto os patches do WoW quanto os gerenciadores de addons mudam com frequência. Se alguma instrução aqui não corresponder mais ao que você está vendo, por favor, reporte ou abra um pull request no repositório GitHub deste guia.

Junte-se ao nosso servidor do Discord se tiver alguma dúvida ou quiser ajuda com qualquer coisa relacionada a modding!