Hello there! We are conducting a survey to better understand the user experience in making a first edit. If you have ever made an edit on Gamepedia, please fill out the survey. Thank you!

Porting older addons to Classic

From Wowpedia
Jump to: navigation, search

Addons for Retail will in most cases work on Classic with removal of any non-Classic API. For Vanilla there is a bit more work involved however.


Globe can tell you which API functions/events in an addon have been removed in Classic, if the TOC is set to the Retail version and with Globe: check-classic

For example: https://www.townlong-yak.com/globe/#h:2a8385bff94e98a6bad8f5f09b45a148-reads

## Interface: 80200
## Globe: check-classic


There is a list of Classic-specific API and a complete list of Classic API.

The TOC version is 11302

You can use the WOW_PROJECT_ID global variable to write conditional code for classic vs BfA.

old: PlaySound("igMainMenuOptionCheckBoxOn")
old: PlaySoundFile("Sound/Spells/LevelUp.ogg")
new: PlaySoundFile(569593)


Maps were reworked in Patch 8.0.1 and the stateful API was changed to be stateless.

Combat Log

The combat log was reworked in Patch 2.4.0

Frame Scripts

Most Vanilla addons still define their frames in XML, since CreateFrame() was only added in Patch 1.10

  • Parameters like this, event, arg1, arg2, arg3 are no longer globals for the script handler. This was changed in Patch 4.0.1
    They are now passed like so OnEvent(self, event, ...) or OnEvent(self, event, someVar1, someVar2, someVar3)
  • The this parameter was unique to WoW frame scripts. It can generally be replaced with self even though they are separate concepts.

Quick fix

There are multiple ways to handle frame scripts in XML. For simplicity's sake we will only describe a quick fix in blue text.

  • Lua
function SomeAddon_OnLoad(self)

function SomeAddon_OnEvent(self, event, addon)
	print(self, event, addon)
  • XML
<Frame name="SomeAddon">
			SomeAddon_OnEvent(self, event, ...)

Lua only

It's also possible to create a frame and handle the scripts in Lua without use of XML, depending on how simple the addon is.

local function OnEvent(self, event, addon)
	print(self, event, addon)

local f = CreateFrame("Frame")
f:SetScript("OnEvent", OnEvent)