WoW:Getting the current interface number: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Wrong build number)
Line 1: Line 1:
{{UIHowTo}}
{{UIHowTo}}
When loading the interface, the WoW client skips over any [[AddOn]]s 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. Each AddOn specifies (in its [[TOC format|.toc file]]) the interface version with which it complies. So an AddOn's .toc file most likely contains a line similar to:
The WoW 'interface number' is important for WoW [[AddOn]]s and can be difficult to find.
## Interface: 70000
 
Here, 70000 would mean that the AddOn is designed against the Patch 7.0.0 client (which doesn't technically exist, [[Patch 7.0.3]] is the pre-patch release). If the interface was only compatible with a specific release like Patch 7.0.3 it most likely contains a line similar to:
== 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.
 
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: 70000


== Reference ==
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.
 
== Finding the number ==
There are a number of ways to get the current interface version:
There are a number of ways to get the current interface version:
* See the latest '[[Patch 5.4.0|patch notes]]' and look for the 'Interface' number in the Patch box.
:: This is the most authoritative source on the Wiki.


* The '''current''' number probably is '{{API LatestInterface}}', from our WoWWIki 'Interface Version' template {{t|API LatestInterface}}
==== 1. Wiki patch notes ====
:: But this number is [[Template:API LatestInterface|maintained manualy]], so it ''might'' be out of date.
: See the latest '[[Patch 8.2.5|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'.
 
: 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. <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 [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>


* Its usually derrived exactly from 'major.minor' version
==== 5. From another AddOn ====
:: 2.4.0 (i.e. 2 being the major version number and .4 being the minor version number) is 20400, 5.4.0 is 50400 and, 5.4.1 (.1 being the sub-minor version) would likely be 50401 (however, [[Blizz]]ard doesn't appear to distinguish on the sub-minor version level, so you would still use 50400).
: 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.


* Extract FrameXML and check FrameXML.toc
==== 6. 'lastAddonVersion' in Config.wtf ====
:: See [[Extracting interface files]]
: Find the 'WTF/Config.wtf' file in your 'World of Warcraft/_retail_' or 'World of Warcraft/_classic_' folder, then the 'lastAddonVersion' [[CVar]]
:: or ''DEPRECATED, not updated since Oct. 2010'' You can 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>
: This is the most authoritative source for the interface number.


* Steal it from another AddOn
: Must run WoW at least once after install or patch for this to show up.
:: Recently updated AddOns, which are not listed as "out of date" by the client contain the latest Interface version in their toc tag.


* Use {{api|GetBuildInfo}}
==== 7. The Wow API GetBuildInfo ====
:: In particular, <code>/run print((select(4, GetBuildInfo())));</code> should output the correct version to your chat frame.
: 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.


* View FrameXML.toc online
==== 8. <s>WoW FrameXML.toc on the Web</s> ====
:: For instance at {{tlylink|FrameXML.toc}}<!--{{wdnlink|FrameXML/FrameXML.toc}}-->.
: View FrameXML.toc online (no longer works, interface number is no longer in the FrameXML.toc)
: For instance at {{tlylink|FrameXML.toc}}<!--{{wdnlink|FrameXML/FrameXML.toc}}-->.


== Notes ==
== Notes ==
* In the past Extract FrameXML and check FrameXML.toc
* In the past Extract FrameXML and check FrameXML.toc - ''DEPRECATED, not updated since Oct. 2010''
:: ''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>
:: You can 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]]
[[Category:World of Warcraft API]]

Revision as of 22:46, 9 October 2019

← HOWTOs

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

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.

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.

Finding the number

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

1. Wiki patch notes

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 {{API LatestInterface}}
But this number is 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'.
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

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

5. From another AddOn

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

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 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

View FrameXML.toc online (no longer works, interface number is no longer in the FrameXML.toc)
For instance at //www.townlong-yak.com/framexml/live/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 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=4986"