Een gids over het downloaden en installeren van addons in World of Warcraft op Windows en macOS.
World of Warcraft noemt ze addons in plaats van mods, en het is een van de weinige gevallen in deze gidsen waarbij de game speciaal is gebouwd om ze te accepteren. Blizzard levert een addon API, een addon-beheerscherm bij de karakterselectie, en een gepubliceerd beleid dat vastlegt wat addons wel en niet mogen doen. Er is geen mod loader, geen injector en niets om te patchen. Je plaatst een map op de juiste plek en de game laadt hem.
Ons voorbeeld is Details! Damage Meter, dat met meer dan 367 miljoen downloads een van de meest geïnstalleerde addons uit de geschiedenis van de game is.
Vereisten
- Een pc met Windows 10 of nieuwer, of een Mac. Beide worden volledig ondersteund, en alles in deze gids werkt op beide.
- World of Warcraft geïnstalleerd via de Battle.net-launcher.
- Zeer weinig schijfruimte. Addons zijn Lua- en XML-tekstbestanden plus af en toe een textuur, dus zelfs een grote verzameling is klein.
- Een bestandsuitpakker als je handmatig installeert. Windows en macOS kunnen beide
.zipvan nature verwerken.
Addons zijn officieel toegestaan. Blizzard publiceert een UI Add-On Development Policy die de regels uiteenzet, en er is geen bankrisico bij het gebruik van addons die dit beleid volgen. Wat niet is toegestaan, is automatisering die het spel voor je speelt, en geen addon van CurseForge of Wago doet dat.
Hoe WoW-addons werken
Een addon is een map met Lua-scripts, XML-layoutbestanden en een .toc-manifest. WoW scant een specifieke map bij het opstarten, leest elk .toc-bestand, en laadt wat het vindt.
Er is geen framework om eronder te installeren. Niets om de game te haken, niets om te injecteren, niets dat buiten WoW's eigen scripting-sandbox draait.
Flavors
Dit is het onderdeel waar mensen op vastlopen, omdat WoW niet langer één game is.
Retail en elke Classic-lijn draaien op afzonderlijke clients, met afzonderlijke addon-mappen en afzonderlijke addon-builds. Een CurseForge-addonpagina vermeldt welke flavors worden ondersteund, en Details! ondersteunt momenteel:
| Flavor | Wat het is |
|---|---|
| Retail | De huidige expansion, op de 12.x-client |
| Classic | Classic Era |
| Classic TBC | The Burning Crusade Classic |
| MoP Classic | Mists of Pandaria Classic |
| Titan Reforged Classic | De nieuwere Classic-lijn |
Het downloaden van de verkeerde flavor geeft je een addon die ofwel helemaal niet verschijnt, ofwel grijs weergegeven wordt als verouderd. Addon managers kiezen automatisch de juiste voor je, gebaseerd op welke installatie je aanwijst, wat een van de betere redenen is om er een te gebruiken.
Waar addons zich bevinden
Elke flavor heeft zijn eigen map binnen je WoW-installatie. Op Windows staat Retail hier:
C:\Program Files (x86)\World of Warcraft\_retail_\Interface\AddOns
Op macOS:
/Applications/World of Warcraft/_retail_/Interface/AddOns
De andere flavors gebruiken dezelfde structuur met een andere mapnaam, zoals _classic_era_ of _classic_. Er is ook _ptr_ als je de public test realm hebt geïnstalleerd.
Elke addon is één map die direct in AddOns staat, met dezelfde naam als de addon. Details! installeert zich als een map genaamd Details.
NOTE - Als de AddOns-map nog niet bestaat, maak hem aan. Hij wordt alleen aangemaakt zodra iets hem nodig heeft.
Installeren met de CurseForge App
De meest voorkomende optie, en degene waar CurseForge-addonpagina's van uitgaan.
- Download de CurseForge app. Er is een lichte standalone build en een Overwolf-build met in-game functies; beide werken, en de standalone versie is de lichtere keuze. Windows-, macOS- en Linux-builds zijn allemaal beschikbaar.
- Open de app en laat hem je WoW-installaties detecteren. Hij vindt elke flavor apart.
- Open de World of Warcraft-sectie en kies de flavor waar je addons aan wilt toevoegen.
- Zoek naar Details! Damage Meter en klik op Install.
- De app downloadt de juiste build voor die flavor en plaatst hem in de juiste
AddOns-map.
De app regelt ook updates, wat de echte reden is om hem te gebruiken. WoW-addons breken bij elke content-patch, en de mogelijkheid om er dertig tegelijk te updaten weegt hier zwaarder dan in de meeste andere games.
Installeren met WowUp
WowUp is een gratis, open source, door de community gebouwde addon manager met Windows-, macOS- en Linux-builds. Hij kan van meerdere addon-sites tegelijk putten in plaats van slechts één, wat handig is omdat niet elke addon op CurseForge staat.
- Download WowUp van wowup.io.
- Bij de eerste keer opstarten scant hij naar WoW-installaties en toont hij elke flavor die hij vindt.
- Open Get Addons, zoek naar Details! Damage Meter en installeer hem.
- Gebruik My Addons om te zien wat je hebt en om het te updaten.
WowUp kan ook addons overnemen die je handmatig hebt geïnstalleerd, door ze te koppelen aan hun bron zodat ze weer updates gaan ontvangen. Als je een map vol handmatig geïnstalleerde addons van jaren geleden hebt, is WowUp daarop richten een snelle manier om het hele stel weer onder beheer te brengen.
Installeren met de Wago App
Wago Addons is de andere grote addon-host, en dezelfde mensen beheren wago.io voor WeakAuras en andere importstrings. De Wago App beheert addons uit hun catalogus.
- Download de app van addons.wago.io/app.
- Laat hem je WoW-installaties vinden.
- Blader of zoek, en installeer.
Het echte voordeel van de Wago App is de rest van het Wago-ecosysteem. Als je daar al WeakAuras-strings of UI-pakketten vanaf importeert, is het handig om één app te hebben die ook de addons ernaast beheert.
TIP - Draai indien mogelijk niet twee addon managers tegelijk op dezelfde installatie. Ze zullen allebei dezelfde mappen willen beheren en je krijgt dubbele of half-geüpdatete addons. Kies er één.
Handmatig installeren
Goed om te weten, en in WoW echt eenvoudig.
- Ga naar de Details! Damage Meter-pagina op CurseForge.
- Kies onder Files het bestand dat bij jouw flavor past. Voor de huidige expansion is dat de Retail build.
- Download de
.zip. - Pak het uit.
- Kopieer de uitgepakte map,
Details, naar jeInterface\AddOns-map. - Herstart WoW als het draait.
Het resultaat zou dit moeten zijn:
World of Warcraft\_retail_\Interface\AddOns\Details\
met daarin het .toc-bestand van de addon en de bijbehorende Lua-bestanden.
WAARSCHUWING - De addon-map komt direct in AddOns, en de mapnaam moet overeenkomen met wat de addon verwacht. Een geneste AddOns\Details-v1.2.3\Details\ zal niet laden, en losse Lua-bestanden die los in AddOns staan ook niet. Sommige addons leveren ook meerdere mappen in één zip, bijvoorbeeld een hoofdaddon plus een library, en die gaan allemaal naast elkaar in AddOns.
De TMC App
De laatste optie is de onze, met het voorbehoud dat WoW al de best bediende game in deze reeks gidsen is als het om managers gaat. De TMC App doet one-click installs, sandboxes (per game benoemde mod-profielen met hun eigen deployment-methode), een server browser met live latency-grafieken, en RCON.
World of Warcraft staat niet in de lijst van ondersteunde games. Tussen de CurseForge app, WowUp en de Wago App is addonbeheer hier al een opgelost probleem, dus deze staat lager op onze lijst dan games zonder fatsoenlijke tooling. Dat zeggen we liever dan de lijst kunstmatig op te vullen.
De app bevindt zich ook in een zeer vroeg ontwikkelingsstadium. De README noemt hem gedeeltelijk getest en dat is een eerlijke omschrijving. Als je hem voor andere games gebruikt en WoW-ondersteuning zou willen, is dat laten weten de snelste manier om het hoger op de wachtlijst te krijgen.
Het is open source onder GPL-3.0 op github.com/modcommunity/tmc-app. Bugs, featureverzoeken en "steun deze game alsjeblieft" horen allemaal in de issue tracker, pull requests zijn welkom, en het toevoegen van een game blijkt vier JSON-bestanden te zijn in plaats van code, dus het bijdragen van WoW-ondersteuning is goed haalbaar.
Installeren:
- Linux: één regel, geen root en geen packagemanager nodig.
curl -fsSL https://raw.githubusercontent.com/modcommunity/tmc-app/main/scripts/install.sh | sh
- Windows: de
setup.exeofsetup.msivan de releasespagina. Er is ook een portable build, die registreert echter geen launcher-item of detmc://-linkhandler. - macOS: de
.dmgvan dezelfde releasespagina.
Addons inschakelen in-game
Installeren is niet helemaal het hele verhaal.
- Start WoW en ga naar het karakterselectiescherm.
- Klik op AddOns linksonder.
- Zorg dat je addons zijn aangevinkt.
- Ga de wereld in.
Nieuwe addons zijn meestal standaard ingeschakeld, maar dit is het eerste wat je moet checken wanneer iets dat je net hebt geïnstalleerd niet verschijnt.
De addonlijst is standaard per karakter, met een All-dropdown om je selectie overal toe te passen. Dat is handig wanneer je een damage meter wilt op je raidkarakter maar niet op je bank-alt.
Eenmaal in-game herlaadt /reload de interface zonder uit te loggen, wat wijzigingen aan addonbestanden oppikt. Sommige addons registreren ook hun eigen slash command, en Details! gebruikt /details.
Instellingen en opgeslagen data
Addon-instellingen worden niet bij de addon zelf opgeslagen. Ze leven in de WTF-map, samen met de rest van je interfaceconfiguratie:
World of Warcraft\_retail_\WTF\Account\<ACCOUNT>\SavedVariables
met per-karakterdata onder de realm- en karaktermappen daaronder.
Dit heeft twee handige gevolgen. Het updaten of opnieuw installeren van een addon verliest je configuratie niet, omdat de config op een heel andere plek staat. En het backuppen van je WTF-map backupt je hele UI-setup, wat zeker de moeite waard is voor een grote patch.
Addons werkend houden na een patch
Elke WoW-contentpatch verhoogt de interfaceversie, en elke addon waarvan de .toc nog de oude versie noemt, wordt gemarkeerd als verouderd en uitgeschakeld.
Wanneer dat gebeurt:
- Update eerst je addons. De meeste auteurs brengen binnen enkele uren na een patch een compatibele build uit, en een addonmanager brengt je daar met één klik.
TIP - Als je UI kapot lijkt na een patch, is de snelste diagnose om alles uit te schakelen, te bevestigen dat de standaard UI werkt, en vervolgens in batches weer in te schakelen.
Verwijderen
Via een manager verwijder je de addon uit de addonlijst en wordt de map verwijderd.
Handmatig verwijder je de map van de addon uit Interface\AddOns.
In beide gevallen blijven de opgeslagen variabelen van de addon achter in WTF. Dat is bewust zo, zodat herinstalleren je instellingen terugbrengt. Als je echt een schone lei wilt, verwijder dan ook het bijbehorende .lua-bestand uit de SavedVariables-map.
Probleemoplossing
De addon verschijnt niet in de AddOns-lijst. De mapstructuur klopt niet. Controleer op een geneste map, dus AddOns\Details\Details.toc in plaats van AddOns\Details-12.1\Details\Details.toc.
Hij staat in de lijst maar is grijs. Hij is uitgeschakeld, of gemarkeerd als verouderd. Vink hem aan, en vink Load out of date AddOns aan indien nodig.
Geïnstalleerd voor de verkeerde flavor. Zeer gebruikelijk. Controleer of je manager naar _retail_ wijst en niet naar een Classic-installatie, of omgekeerd.
Overal Lua-fouten na een patch. Update je addons. Als eentje blijft weigeren, schakel hem uit en check zijn CurseForge-pagina voor een compatibele build.
De addon laadt, maar het venster is verdwenen. Veel addons hebben een lock- of hide-toggle, en sommige onthouden een positie buiten het scherm. Controleer eerst de eigen opties van de addon; /details voor Details!. Als laatste redmiddel kun je het opgeslagen variabelenbestand verwijderen om hem te resetten.
Twee managers blijven elkaar tegenwerken. Ze beheren allebei dezelfde map. Kies er één en verwijder de andere.
Blizzards eigen UI-instellingen resetten. Controleer of je iets hebt verwijderd of verplaatst uit WTF. Die map bevat Blizzards instellingen én addon-data.
Conclusie
WoW-addons zijn de makkelijkste installatie in deze hele reeks gidsen. Er is geen loader, de game heeft een ingebouwd beheerscherm, en een manager zoals de CurseForge app of WowUp reduceert het hele proces tot zoeken en op installeren klikken.
De twee dingen die daadwerkelijk problemen veroorzaken zijn flavors en patches. Zorg dat je voor de juiste client installeert, en houd rekening met een paar minuten om addons bij te werken na elke content-patch.
Voor games die minder goed bediend worden dan deze, is de TMC App de onze. Het is open source, vroeg in ontwikkeling, en feedback erop wordt gewaardeerd.
Zie Ook
- World of Warcraft addons op CurseForge
- Wago Addons
- WowUp
- Details! Damage Meter bron op GitHub
- Officiële World of Warcraft Discord
- TMC App
We houden deze gids zo actueel mogelijk, maar zowel WoW-patches als addon managers veranderen voortdurend. Als een instructie hier niet meer overeenkomt met wat je ziet, meld dit dan of open een pull request op de GitHub-repository van deze gids.
Kom naar onze Discord-server als je vragen hebt of hulp wilt bij iets modding-gerelateerds!

