WoW:Getting the current interface number: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Added "Start WoW")
m (Move page script moved page Getting the current interface number to Getting the current interface number without leaving a redirect)
 
(26 intermediate revisions by 20 users not shown)
Line 1: Line 1:
There are a few reasons why you might need the most current Interface version number.  Usually you are a mod author and need to specify it in your [[The TOC Format|.TOC file]]. It would look like:
{{wow/uihowto}}
The WoW 'interface number' is important for WoW [[AddOn]]s and can be difficult to find.


  ##Interface: 11000
== Interface number basics ==
The WoW 'interface number' is the current version for the actual UI in WoW. AddOns use this number in their own [[TOC file]] to denote the WoW user interface they were created for.


But how do you get this number?  If you boot up WoW, there is a version number displayed '''but this number is wrong'''.
By default the WoW client skips over any AddOns whose interface version does not match its own. This is an effort to keep the client's behavior free of errors due to changes in the API.


== Current ==
In the AddOn TOC file:
The current Interface version number for WoW 2.0.3 on January 9th, 2007 is:{{ref}}
  20003


== Steal It ==
  ## Interface: 70000
Chances are someone else has beaten you to it, and already updated their addon to the latest version, and you might already have the updated version, especially for addon packages with a .exe updater.  Simply open one of their addon's .toc files to see the valid interface number.  


This number might be wrong, or you may not have any up to date addons, '''or you may feel horrible for ripping someone else's hard work'''.
Interface number 70000 would mean that the AddOn is compatible with WoW Patch 7.0.3. The same interface number can be used for a series of WoW patches, usually until the next 'minor' release version. For example for with WoW Patch 7.1.0, 70100 would likely be the new interface version number.


== Start WoW ==
== Editions, patches and PTRs ==
Start WoW. There's an version number in the lower left-hand corner of the login screen that will look like this: 2.0.6.6854 (major.minor.alpha.build). Just picture it like this: 2.00.06 (ignore the build number) and take out the dots (.). You are left with 20006. It's really not that complicated as the "Do it yourself" section would suggest.
With the addition of WoW Classic and now having two different WoWs, there are now multiple TOC interface version numbers "live" at the same time. WoW 'Classic' uses the older versions similar to the versions of the original game, starting with 1.X, and has differently numbered versions from 'Retail' which is the name for regular WoW.


== Do it yourself ==
The truth is that there are were always multiple versions of WoW, as far as PTRs, betas and so forth. But each version now has its own distinct folder under the World of Warcraft install folder, like '_retail_', '_classic_', '_ptr_'. Each of those folders has a its own set of 'WTF', 'Interface/AddOns', and other files and folders. Keep this in mind when using the following ways below.
This is a bit more tricky. What you want is to find the interface number in Blizzard's FrameXML.toc file after a patch -- but this file is buried in a MPQ archive!  While blizzard provides an [http://www.blizzard.com/support/wow/?id=aww01669p Extraction Tool] it will extract all the current files!  If you want to save on diskspace, read on:


You need to grab [http://www.blizzard.com/support/wow/?id=aww01669p WinMPQ] '''but wait'''!  Because WoW's patch.MPQ file is so big, the old WinMPQ program will crash with a 'overflow' error!  Instead you need to grab this [http://www.wowinterface.com/downloads/fileinfo.php?id=3990 patched WinMPQ] program.
=== Two versions ===
If an addon is released for both classic and retail, and wanted matching numbers for each to load without the out-of-date warning, there need to be two copies. There would need to be a retail release with the retail TOC version, and classic release with the classic TOC version.


Install it, then open:
== Finding the number ==
  World of Warcraft\enUS\locale-enUS.MPQ
There are a number of ways to get the current interface version:


From there, find the line that says:
==== 1. Wiki patch notes ====
  Interface\FrameXML\FrameXML.toc
: See the latest 'patch notes' and look for the 'Interface' number in the Patch box.
: This is the most authoritative source on the Wiki.


==== 2. 'API LatestInterface' wiki template ====
: The WoWWiki 'Interface Version' template {{t|API LatestInterface}}
: But this number is [[Template:API LatestInterface|maintained manualy]], so it ''might'' be out of date.


==== 3. WoW major minor version ====
: The interface number is usually derived exactly from WoW 'major.minor' version. Sometimes is derived from 'major.minor.release'.


click it, then click extract.  Put it somewhere you can access, and open it in your favorite text editor. Look the ##Interface line, and voila!  The newest interface version number is in your hands, to be used in all your addons. Please remember that just changing the ##Interface line does not mean the mod will work, the code, structure and functions for addons can change after a patch, so check the patch notes and your favorite UI forums to see if you need to update any of your code before re-releasing your addon!
: In 2.4.0, where 2 is the major version number, and .4 is the minor version number, is 20400. 5.4.0 is 50400 and, 5.4.1 (.1 being the 'sub-minor' or 'release' version) would likely be 50401. However, [[Blizzard]] doesn't often distinguish on the sub-minor version level, so you would still use 50400. However with patch 8.2.5, for example, the interface number is actually 80205.


* OR, just view the latest [{{wdnlink|FrameXML/FrameXML.toc}} FrameXML.toc] on-line, courtesy http://wdn.wowinterface.com
==== 4. <s>WoW FrameXML.toc</s> ====
: Extract and check FrameXML.toc (no longer works, interface number is no longer in the FrameXML.toc). See [[Extracting WoW user interface files]].
: or ''DEPRECATED, not updated since Oct. 2010'' You can download Blizzard's  User Interface Customization tool], use it to extract interface data, and peek at 'World of Warcraft\Blizzard Interface Data (usUS)\FrameXML\FrameXML.toc'. See [[Interface AddOn Kit]] for history of the tool kit.


{{references|body=
==== 5. From another AddOn ====
# [http://ui.worldofwar.net/lowbandwidth/ui.php?id=3386 Bongos at ui.worldofwar.net]
: Steal it from another AddOn
}}
: Recently updated AddOns, which are not listed as "out of date" by the client contain the latest Interface version in their toc tag.
[[Category:HOWTOs|Get Current Interface Number]]
 
==== 6. 'lastAddonVersion' in Config.wtf ====
: Find the 'WTF/Config.wtf' file in your 'World of Warcraft/_retail_' or 'World of Warcraft/_classic_' folder, then the 'lastAddonVersion' [[CVar]]
: This is the most authoritative source for the interface number.
 
: Must run WoW at least once after install or patch for this to show up.
 
==== 7. The Wow API GetBuildInfo ====
: Use {{api|GetBuildInfo}} to verify the 'major.minor' version number.
: <pre>/run print((select(4, GetBuildInfo())))</pre>
: Above should output the WoW build version to your chat frame.
 
==== 8. <s>WoW FrameXML.toc on the Web</s> ====
: View FrameXML.toc online (no longer works, interface number is no longer in the FrameXML.toc) For example: {{WoW/reslink|FrameXML.toc}}.<!--{{tlylink|FrameXML.toc}} {{wdnlink|FrameXML/FrameXML.toc}}-->
 
== Notes ==
* In the past Extract FrameXML and check FrameXML.toc - ''DEPRECATED, not updated since Oct. 2010''
* In the past you could also download Blizzard's [https://us.battle.net/support/en/article/33747 User Interface Customization tool], use it to extract interface data, and peek at <code>World of Warcraft\Blizzard Interface Data (usUS)\FrameXML\FrameXML.toc</code>
[[Category:World of Warcraft API]]

Latest revision as of 04:48, 15 August 2023

← HOWTOs

The WoW 'interface number' is important for WoW AddOns and can be difficult to find.

Interface number basics[edit]

The WoW 'interface number' is the current version for the actual UI in WoW. AddOns use this number in their own TOC file to denote the WoW user interface they were created for.

By default the WoW client skips over any AddOns whose interface version does not match its own. This is an effort to keep the client's behavior free of errors due to changes in the API.

In the AddOn TOC file: 

## Interface: 70000

Interface number 70000 would mean that the AddOn is compatible with WoW Patch 7.0.3. The same interface number can be used for a series of WoW patches, usually until the next 'minor' release version. For example for with WoW Patch 7.1.0, 70100 would likely be the new interface version number.

Editions, patches and PTRs[edit]

With the addition of WoW Classic and now having two different WoWs, there are now multiple TOC interface version numbers "live" at the same time. WoW 'Classic' uses the older versions similar to the versions of the original game, starting with 1.X, and has differently numbered versions from 'Retail' which is the name for regular WoW.

The truth is that there are were always multiple versions of WoW, as far as PTRs, betas and so forth. But each version now has its own distinct folder under the World of Warcraft install folder, like '_retail_', '_classic_', '_ptr_'. Each of those folders has a its own set of 'WTF', 'Interface/AddOns', and other files and folders. Keep this in mind when using the following ways below.

Two versions[edit]

If an addon is released for both classic and retail, and wanted matching numbers for each to load without the out-of-date warning, there need to be two copies. There would need to be a retail release with the retail TOC version, and classic release with the classic TOC version.

Finding the number[edit]

There are a number of ways to get the current interface version:

1. Wiki patch notes[edit]

See the latest 'patch notes' and look for the 'Interface' number in the Patch box.
This is the most authoritative source on the Wiki.

2. 'API LatestInterface' wiki template[edit]

The WoWWiki 'Interface Version' template {{API LatestInterface}}
But this number is maintained manualy, so it might be out of date.

3. WoW major minor version[edit]

The interface number is usually derived exactly from WoW 'major.minor' version. Sometimes is derived from 'major.minor.release'.
In 2.4.0, where 2 is the major version number, and .4 is the minor version number, is 20400. 5.4.0 is 50400 and, 5.4.1 (.1 being the 'sub-minor' or 'release' version) would likely be 50401. However, Blizzard doesn't often distinguish on the sub-minor version level, so you would still use 50400. However with patch 8.2.5, for example, the interface number is actually 80205.

4. WoW FrameXML.toc[edit]

Extract and check FrameXML.toc (no longer works, interface number is no longer in the FrameXML.toc). See Extracting WoW user interface files.
or DEPRECATED, not updated since Oct. 2010 You can download Blizzard's User Interface Customization tool], use it to extract interface data, and peek at 'World of Warcraft\Blizzard Interface Data (usUS)\FrameXML\FrameXML.toc'. See Interface AddOn Kit for history of the tool kit.

5. From another AddOn[edit]

Steal it from another AddOn
Recently updated AddOns, which are not listed as "out of date" by the client contain the latest Interface version in their toc tag.

6. 'lastAddonVersion' in Config.wtf[edit]

Find the 'WTF/Config.wtf' file in your 'World of Warcraft/_retail_' or 'World of Warcraft/_classic_' folder, then the 'lastAddonVersion' CVar
This is the most authoritative source for the interface number.
Must run WoW at least once after install or patch for this to show up.

7. The Wow API GetBuildInfo[edit]

Use GetBuildInfo to verify the 'major.minor' version number.
/run print((select(4, GetBuildInfo())))
Above should output the WoW build version to your chat frame.

8. WoW FrameXML.toc on the Web[edit]

View FrameXML.toc online (no longer works, interface number is no longer in the FrameXML.toc) For example: FrameXML.toc [tly].

Notes[edit]

  • In the past Extract FrameXML and check FrameXML.toc - DEPRECATED, not updated since Oct. 2010
  • In the past you could also download Blizzard's User Interface Customization tool, use it to extract interface data, and peek at World of Warcraft\Blizzard Interface Data (usUS)\FrameXML\FrameXML.toc
Retrieved from "https://addonstudio.org/mw/index.php?title=WoW:Getting_the_current_interface_number&oldid=20352"