49
edits
no edit summary
mNo edit summary |
No edit summary |
||
| Line 1: | Line 1: | ||
{{ | {{uiaddon}} | ||
This document describes the WoW [[UI Customization]] aspect of load order for loading addons. It covers when the WoW client first starts up, when AddOns load for the first time, and when user or WoW reloads the [[UI]]. The availablity of the Lua environment at various points in the process is also detailed. | |||
== General steps == | |||
# Intial Scan - When the WoW client first starts, a list of files and addon dependencies is built. | |||
# When the client first starts, | # AddOn Load - Addon code is executed after the player selects a character and chooses to enter the world. | ||
# Addon code is executed after the player selects a character. | |||
# After all addon code has been loaded, the saved variables are executed. ADDON_LOADED fires after each addon's SVs have been loaded. | # After all addon code has been loaded, the saved variables are executed. ADDON_LOADED fires after each addon's SVs have been loaded. | ||
== | === Initial Scan === | ||
First, the WoW client scans through all of the folders in the '''Interface\AddOns''' directory, looking for sub-folders containing a valid [[TOC file]] with a '.toc' extension, and in turn then loads each AddOn's TOC file into memory. TOC files that were not found during this step cannot be loaded by the game later and only happens on client start-up. This makes it impossible to install additional addons, or load updated TOC files, without restarting the client. For a AddOn to be considered valid, it must have a single word folder directly in the '''Interface\AddOns''' folder, and must have a matching named '.toc' file, such as a 'MyAddon' folder with a 'MyAddOn.toc' underneath it. That is all that is requred. | |||
=== AddOn Load === | |||
AddOn loading occurs when the player logs in. The dependency information in the .toc files is used, in part, to compute the order in which the addons files will be loaded, as well as the natural order in which the AddOns were discovered during hte scan process. For AddOns with dependancies, an individual addon may '''not''' assume that all of the other addons that it depends on will be loaded first, without taking specific steps to ensure its dependancies are already loaded and available. When WoW loads a particular AddOn it uses the information in its [[TOC file]] discovered during initial scan and loads each file in order that it is found inside the TOC. | |||
== Inside the TOC file == | |||
Files within an addon are loaded in the order they're listed in the addon's .toc file. Files included through XML <Include file="src.xml" /> or <Script file="src.lua" /> are loaded at the time the tag is encountered while parsing. XML OnLoad script handlers execute when all of a widget's children have been created. | Files within an addon are loaded in the order they're listed in the addon's .toc file. Files included through XML <Include file="src.xml" /> or <Script file="src.lua" /> are loaded at the time the tag is encountered while parsing. XML OnLoad script handlers execute when all of a widget's children have been created. | ||