Wowpedia

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

READ MORE

Wowpedia
Register
m (moved HOWTO: Get Started to Getting started with writing addons)
(Revamp of the page to make it more beginner friendly.)
Line 1: Line 1:
 
{{breadcrumb1|Interface Customization}} {{tocright}}
 
{{breadcrumb1|Interface Customization}} {{tocright}}
  +
== Getting Started ==
== So You Want To Write an Addon ==
 
 
<div style="margin-left: 3%;">
 
<div style="margin-left: 3%;">
  +
The idea of picking up any programming language can be daunting, and when you have to tie your program into someone else's APIs it can be nearly overwhelming. Creating your own addon will be a difficult process for novice coders, but the end satisfaction is worth it.
This article is designed to be a launching off point to the many points of helpful information that exist out there, as well as supplement that information.
 
  +
  +
=== First Step ===
  +
Before anything else you need to get the Custom UI tools from the Blizzard site. This will give you access to all of their XML files (can't change something without know what it's called). They will also give you two tutorials to get you started.
  +
  +
=== Plan Your Addon ===
  +
Figure out what you want your addon to do. Don't try and get into the details too much, just decide what you want the overall goal to be. I usually start by asking myself these questions:
  +
:*Whats my end goal?
  +
:*What information will I need from WoW for my addon to work?
  +
:*Will I need to make custom frames?
  +
:*Will I need to interact with Blizzard's frames?
  +
:*Do I know the functions needed to do everything I want to do?
  +
  +
=== Get Your Information: The WoW API ===
  +
Getting information from WoW is critical to making your addon function. The [[World of Warcraft API]] has a list of functions that will give you that information. These are your building blocks, and if you don't have a block you need (or thought you needed) then you'll have to find another way to get information for your addon. Don't be discouraged, as with any programming language there are many different ways to accomplish your goal, so keep looking until you find a way.
  +
 
</div>
 
</div>
   
 
== Editing Tools ==
 
== Editing Tools ==
 
<div style="margin-left: 3%;">
 
<div style="margin-left: 3%;">
Before you can write any sort of code, you'll want to have a tool that lets you edit you addon files. All addon files are plain text files, meaning even Notepad will do. You can also get LUA and XML specific text editors, which is recommended.
+
Before you can write any sort of code, you'll want to have a tool that lets you edit you addon files. All addon files are plain text files, meaning even Notepad will do. You can also get LUA and XML specific text editors, which will highlight syntax for you, in turn making your coding a lot easier.
 
 
To review the list of tools and get one you'd like, head to the [[Lua editors]] page.
 
To review the list of tools and get one you'd like, head to the [[Lua editors]] page.
 
</div>
 
</div>
Line 59: Line 73:
 
</div>
 
</div>
   
  +
</div>
  +
  +
== Start Coding! ==
  +
<div style="margin-left: 3%;">
  +
Start with the tutorials WoW supplies (through the custom UI editor). The [[HOWTOs]] here has a ton of great examples to help you learn. Don't be shy to dig through someone else's addon for help, just be sure not steal code and give credit where credit is due.
 
</div>
 
</div>
   
 
== Slash Commands ==
 
== Slash Commands ==
 
<div style="margin-left: 3%;">
 
<div style="margin-left: 3%;">
  +
A slash command is one way for the user to interact with your addon. These will be the easiest way for a beginner to let the user supply command and change options.
 
The [[HOWTO: Create a Slash Command]] page covers this pretty well.
 
The [[HOWTO: Create a Slash Command]] page covers this pretty well.
 
</div>
 
</div>
Line 68: Line 88:
 
== A Basic UI Frame ==
 
== A Basic UI Frame ==
 
<div style="margin-left: 3%;">
 
<div style="margin-left: 3%;">
Honestly, the [[XML User Interface]] page really does cover a lot of great basics.
+
The [[XML User Interface]] page covers a lot of a great basics.
 
</div>
 
</div>
   

Revision as of 15:29, 28 November 2007

Template:Breadcrumb1

Getting Started

The idea of picking up any programming language can be daunting, and when you have to tie your program into someone else's APIs it can be nearly overwhelming. Creating your own addon will be a difficult process for novice coders, but the end satisfaction is worth it.

First Step

Before anything else you need to get the Custom UI tools from the Blizzard site. This will give you access to all of their XML files (can't change something without know what it's called). They will also give you two tutorials to get you started.

Plan Your Addon

Figure out what you want your addon to do. Don't try and get into the details too much, just decide what you want the overall goal to be. I usually start by asking myself these questions:

  • Whats my end goal?
  • What information will I need from WoW for my addon to work?
  • Will I need to make custom frames?
  • Will I need to interact with Blizzard's frames?
  • Do I know the functions needed to do everything I want to do?

Get Your Information: The WoW API

Getting information from WoW is critical to making your addon function. The World of Warcraft API has a list of functions that will give you that information. These are your building blocks, and if you don't have a block you need (or thought you needed) then you'll have to find another way to get information for your addon. Don't be discouraged, as with any programming language there are many different ways to accomplish your goal, so keep looking until you find a way.

Editing Tools

Before you can write any sort of code, you'll want to have a tool that lets you edit you addon files. All addon files are plain text files, meaning even Notepad will do. You can also get LUA and XML specific text editors, which will highlight syntax for you, in turn making your coding a lot easier. To review the list of tools and get one you'd like, head to the Lua editors page.

File Types

There are three primary types of files that you'll need to worry about with addon editing:

  • TOC File - This file is required for any addon. This is the file supplies WoW with information about your addon and what file are required for your addon to work.
  • LUA Files - This contains all the programing for your addon.
  • XML Files - This holds the layout of frames you have created for your addon.

TOC File

This is the file that instructs WoW in some basics about your addon and what other files you want loaded. Here's a short example of one:

## Interface: 20000
## Title : My AddOn
## Notes: This AddOn does nothing but display a frame with a button
## Author: My Name
myAddOn.xml

You can read more about what you need or can put in a TOC over at The TOC Format

LUA Files

Lua files contain functional pieces of code. You may choose to only have one of these or break up your code into multiple files for a specific purpose. Here's a short example of one:

function MyAddon_OnLoad()
	SlashCmdList["MyAddon"] = MyAddon_SlashCommand;
	SLASH_MYADDON1= "/myaddon";
	this:RegisterEvent("VARIABLES_LOADED")
end

XML Files

XML files are used to specify what the visual style of your frames. More importantly though a frame allows you to easily pass events to your Lua files. Check out XML User Interface for details. Here's a short example of one:

Script file="MyAddon.lua"/>

<Frame name="MyAddon"> 
	<Scripts> 
		<OnLoad> 
			MyAddon_OnLoad();
		</OnLoad>
	</Scripts>
</Frame>

Start Coding!

Start with the tutorials WoW supplies (through the custom UI editor). The HOWTOs here has a ton of great examples to help you learn. Don't be shy to dig through someone else's addon for help, just be sure not steal code and give credit where credit is due.

Slash Commands

A slash command is one way for the user to interact with your addon. These will be the easiest way for a beginner to let the user supply command and change options. The HOWTO: Create a Slash Command page covers this pretty well.

A Basic UI Frame

The XML User Interface page covers a lot of a great basics.

SavedVariables

The HOWTO: Save Variables Between Game Sessions covers the key points. For folks new to Addons but not other programming languages, just bear in mind that:

  • The SavedVariables is only read from on UI loading, not real time, and only saved to on UI unloading. This will generally be from a user logging in or logging out.
  • Basically, WoW makes a SavedVariables file for you named after your addon. You only get to specify in your TOC *which* variables get saved into that file.

Localization

It's a good idea to plan from as early as possible to have your addon be localizable, even if you yourself only speak one language. Review this great article for some things to think about: HOWTO: Localize an AddOn.