← Back to Blog
Guides February 1, 2024

How to Install Addons on a Vanilla WoW 1.12.1 Client

Installing addons on a 1.12.1 vanilla WoW client is straightforward once you know the process. This guide walks you through it step by step, from downloading an addon to seeing it in-game.

What You Need

  • A working 1.12.1 World of Warcraft client
  • An addon ZIP file downloaded from VanillaWoW Addons
  • A file extraction tool (Windows has one built in; Mac uses Archive Utility)

Step 1: Find Your WoW Directory

Your WoW installation folder contains a folder called Interface, which contains a folder called AddOns. This is where all addons live. The full path typically looks like:

  • Windows: C:\World of Warcraft\Interface\AddOns\
  • Mac: /Applications/World of Warcraft/Interface/AddOns/

If the AddOns folder doesn't exist, create it. The folder name is case-sensitive on Mac and Linux.

Step 2: Download the Addon

Browse the addon library on this site and click "Download Latest" on any addon page. You'll download a .zip file named after the addon.

Step 3: Extract the ZIP

Right-click the downloaded ZIP file and choose "Extract All" (Windows) or double-click it (Mac). You'll get a folder containing the addon files — typically a folder with the addon name containing .lua and .toc files.

Step 4: Copy to AddOns Folder

Copy or move the extracted addon folder into your Interface/AddOns/ directory. The folder structure should look like:

Interface/
  AddOns/
    Questie/
      Questie.toc
      Questie.lua
      ...
    Bagnon/
      Bagnon.toc
      ...

Important: Make sure the folder is named correctly. Some ZIP files extract with a folder name like Questie-master — rename it to just Questie to match the .toc file name inside.

Step 5: Enable in WoW

Launch WoW and get to the character select screen. Click the "AddOns" button in the bottom left corner. Make sure your addon is checked/enabled. If it shows as "out of date", check the "Load out of date AddOns" checkbox at the top.

Log into your character. Your addon should now be active. Most addons have a slash command — type /questie, /bagnon, or similar to access settings.

Troubleshooting

Addon not showing in the list

The folder name must exactly match the name inside the .toc file. Open the .toc file in a text editor — the filename (without .toc) and the folder name must be identical.

Addon shows as "Interface action failed"

The addon has a Lua error. Type /console ScriptErrors 1 to see the error message. Some addons have known issues with certain server configurations.

Addon works but UI looks broken

Some UI addons like pfUI or CTMod replace the default interface entirely. You may need to configure them. Type /pfui for pfUI settings, or look for the addon's configuration command.

Multiple Addons

You can install as many addons as you want — just repeat the process for each one. Keep in mind that large addon packs can increase load time. If WoW takes a long time to load your UI, you may want to disable addons you don't actively use.