AddOn: Difference between revisions

From AddOn Studio
Jump to navigation Jump to search
(Category UI again)
No edit summary
 
(72 intermediate revisions by 44 users not shown)
Line 1: Line 1:
{{breadcrumb1|Interface Customization}} {{tocright}}
:''See [[wo:AddOn]] for the World of Warcraft AddOn reference.''
== What is an AddOn? ==
:''See [[WildStar AddOn]] or [[ws:AddOn]] for the WildStar AddOn reference.''
<div style="margin-left: 3%;">


AddOns are generally self-contained User Interface (UI) modification components. However, some AddOns can be dependent on other AddOns to work, and some AddOns are actually collections of other AddOns. There is no size restriction on AddOns - you can actually implement a whole AddOn collection as one big Lua+XML chunk.
AddOns are self-contained components that change the behavior of a program.


In plain English, it's just something you can put in your game folder that can (theoretically) improve your interaction with the World of Warcraft game (i.e. make it easier to play, or give you more information about what's going on in the game).
== Summary ==
An AddOn for a game is generally a collection files you can put in your game folder, that can enhance interaction with the game. AddOns can perform a wide variety of tasks, including adding new buttons to the screen, altering or adding windows, replacing or adding significant functionality, or adding whole new programs.


== Details ==
Some AddOns can be dependent on other AddOns to work, and some AddOns can be just collections of other AddOns. Some AddOns are standalone, able to run without any additional software. Others are built on libraries. For example, in WoW, the old [[wo:Sea (AddOn)|Sea]] or [[wo:Ace (AddOn)|Ace]] libraries. Others such as the old WoW [[wo:Cosmos (AddOn)|Cosmos]] addon, are compilations of many individually-developed mods or addons.


Often the name '''modification''' (or "mod" for short) is used interchangeably with '''AddOn'''. More specifically, mod is a third-party [[AddOn]] that alters or enhances some aspect of World of Warcraft's interface. Mods can perform a wide variety of tasks, including adding new buttons to the screen, altering the built-in player and party frames, and automating certain aspects of spell casting. In extreme cases, mods completely supplant the standard WoW [[UI|interface]], usually offering more advanced functionality.


Some mods are standalone, able to run without any additional software. Others are built on libraries such as [[Earth]] or [[Sea]]. Still others, such as [[Cosmos]], are compilations of many individually-developed mods.
[[Category:AddOn]]
 
[[Category:Interface customization]]
 
* '''See [[Hosted AddOn Pages]] for a list of AddOn pages on the wiki.'''
* '''For a good introduction and explanation, please see [[UI FAQ|The Definitive AddOn and Macro FAQ]].'''
 
 
 
</div>
 
== How do I create an AddOn? ==
<div style="margin-left: 3%;">
 
First of all, you need to create a new directory in Interface\AddOns. The name of this directory is kind of important, as it is what other AddOns use to refer to your AddOn (in dependencies).  Therefore, using version numbers in your AddOn directory name can be a bad idea; you will run the risk of having other AddOns "break" when you change the version.  This will probably lead to people either not depending on your AddOn or, worse, that they'll keep using an old version.
 
Major version numbers as part of AddOn directory names might work, though.
 
 
</div>
 
== What is this .toc file? ==
<div style="margin-left: 3%;">
 
{{infobox|'''.toc''' is short for "table of contents".}}
A functioning AddOn will need a file named <code>&lt;YourAddOnDirectoryName&gt;.toc</code> in "<code>Interface\AddOns\YourAddOnDirectoryName\</code>".
 
This file needs to have two things - an interface keyword with a correct interface number, and the name(s) of one or more files to load. However, Blizzard asks that you include at least these four lines:
 
## Interface: 11100
## Title: My Add On
## Notes: A short description of my addon
YourAddOnDirectoryName.xml
 
* Tip: Make sure you do not have any extra spaces at the end of the line with the filename specified. If you do, the extra space is taken as part of the filename and will cause your AddOn to silently fail to load.
 
The interface number can be seen in the WoW login screen, at the lower left. The number in the .toc file must match the current build or the add on will not be loaded/active. (Unless the user has explicitly told WoW to load out-of-date AddOns.)
 
===Special case : [[Bindings.xml]]===
 
If you include a [[Bindings.xml]] file, it does not have to be included in your .toc list of files to load - WoW loads this file automatically. This file is used to set key bindings specific to the AddOn.
 
===What other keywords are there in the .toc file?===
 
Please check out [[The TOC Format]] for a more detailed list.
 
 
</div>
 
== See Also ==
<div style="margin-left: 3%;">
 
* [[UI Beginners Guide]] has plenty of reference links
* [[The TOC Format]]
* [[Bindings.xml]] for creating key bindings
* [[UI FAQ/AddOns]]
* [[UI FAQ/AddOn Author Resources]]
* [[Troubleshooting a mod]]
 
</div>
 
 
[[Category:Interface Customization]]
[[Category:AddOns| ]]
[[Category:UI]]
[[Category:UI]]
[[Category:Acronyms]]

Latest revision as of 06:56, 15 August 2023

See WoW:AddOn for the World of Warcraft AddOn reference.
See WildStar AddOn or WildStar:AddOn for the WildStar AddOn reference.

AddOns are self-contained components that change the behavior of a program.

Summary[edit]

An AddOn for a game is generally a collection files you can put in your game folder, that can enhance interaction with the game. AddOns can perform a wide variety of tasks, including adding new buttons to the screen, altering or adding windows, replacing or adding significant functionality, or adding whole new programs.

Details[edit]

Some AddOns can be dependent on other AddOns to work, and some AddOns can be just collections of other AddOns. Some AddOns are standalone, able to run without any additional software. Others are built on libraries. For example, in WoW, the old Sea or Ace libraries. Others such as the old WoW Cosmos addon, are compilations of many individually-developed mods or addons.

Retrieved from "https://addonstudio.org/mw/index.php?title=AddOn&oldid=20963"