Wowpedia

We have moved to Warcraft Wiki. Click here for information and the new URL.

READ MORE

Wowpedia
Register
Advertisement

The .TOC file format defines information about each addon installed, as well as specify which .xml file needs to be loaded. It is currently required for an addon to be recognized, show up in the addons list and be loaded. The TOC filename must match the folder name in order for it to be recognized by WoW.

WoW reads up to the first 1024 characters of each line only. Additional characters are ignored and do not cause an error.

Where

 World of Warcraft/Interface/AddOns/MyAddon/MyAddon.toc

Recognized Comments

Interface - The interface number is a way of telling WoW which version of the client it was made for. If there is a version mismatch, the AddOn is disabled by default. However, if the user explicitly turns off version checking the AddOn will continue to function regardless of what the interface version number in the .TOC file says. To get what # to put read HOWTO: Get Current Interface Number

 ## Interface: 1800

Title - This text is what is displayed in the AddOns list located during user selection. It also appears when you mouseover the name of the AddOn in the WoW Addons list. Localized versions can be included by appending a hyphen followed by the localization label. The appropriate label will be shown to the user.

## Title: My Addon
## Title-deDE: Titel
## Title-frFR: Titre

Notes - The message that appears under the AddOn name when you mouseover the name of the AddOn in the WoW AddOns list. Localized versions can be included by appending a hyphen followed by the localization label. The appropriate label will be shown to the user.

## Notes: This is my first AddOn.
## Notes-deDE: Informationen
## Notes-frFR: Texte

RequiredDeps - This metatag is to force the WoW client to only load this AddOn if a functional dependency exists on the system. Some AddOns make use of 3rd party libraries and AddOns in order to function properly. If any of the required dependencies are missing, the AddOn will fail to function.

## Dependencies: someAddOn, someOtherAddOn
alternative use:
## RequiredDeps: someAddOn, someOtherAddOn

OptionalDeps: Optional dependencies are external libraries or AddOns which can be used by the AddOn to use and implement their functionality if they exist. If the optional dependencies are not found on the system, the AddOn will continue to function, however, the AddOn using Optional dependencies must be written to work without these dependencies in order for the AddOn to function without them.

## OptionalDeps: someAddOn, someOtherAddOn

LoadOnDemand - As of patch 1.7, AddOns can be loaded on demand rather than always loaded when the user first logs in. If this is enabled, this addon must be loaded by another addon at some later point. This is useful in saving memory by avoiding loading special-purpose addons.

## LoadOnDemand: 1

LoadWith - New since patch 1.9. Together with LoadOnDemand, this gets your AddOn loaded when one of these AddOns (which would usually be Blizzard UI modules like Blizzard_AuctionUI) is loaded.

## LoadWith: someAddOn, someOtherAddOn

SavedVariables - Saved variables is now the current way of storing data in between sessions. These variables are loaded when the client is started, or when the UI is reloaded. The SavedVariables metatag now replaces the function RegisterForSave which is now no longer supported by the WoW client. Note that saved variables are not completely loaded during the OnLoad event and thus must be assumed to contain nil values until the event VARIABLES_LOADED has been invoked.

## SavedVariables: someVariable, someOtherVariable
## SavedVariablesPerCharacter: somePercharVariable

DefaultState - Determines whether or not this addon is enabled by default when installed. If it is set to disabled, the user must explicitly turn it on in the AddOns interface located during user selection.

## DefaultState: enabled

Non-Standard Comments

It is possible to add more information using the ## directive, and some 3rd party programs even make use of some information provided. Below are some commonly used in addons.

Author - The name of the Author. Used by some Tools like WoW Addon Manager.

## Author: MyName

eMail - The eMail Address of the Author - Used by WoW Addon Manager.

## eMail: Author@Domain.com

URL - The Homepage address of the Author or Addon - Used by WoW Addon Manager.

## URL: http://wow.mywebsite.com/

Version - The version number is a way of telling WoW Addon Manager or other Tools which version of the Addon is installed. It is used to check if a newer version is available and if an update is necessary.

## Version: 1.0

Example .toc file

## Interface: 1800
## Title : My AddOn
## Notes: This AddOn does nothing but display a frame with a button
## Author: My Name
## eMail: Author@Domain.com
## URL: http://www.wowwiki.com/
## Version: 1.0
## Dependencies: Sea
## OptionalDeps: Chronos
## DefaultState: enabled
## SavedVariables: settingName, otherSettingName
myAddOn.xml
MyFrame.xml
MyButton.xml

See Also

Advertisement