Thanks for your interest in improving Jame’s Leveling Guide: Addon Version!
There are two ways to help out with the leveling guide: testing and revising.
Testing doesn’t require anything but the newest addon files and a character of the appropriate level. Simply take detailed notes as you play through the guide and post any mistakes you find using our Bug Reporting page. An administrator will link it to the known mistakes, and it will be corrected next time that section is worked on.
Revising guide files requires a little knowledge of the syntax (language) the addon is written in. The language is actually pretty simple and easy to learn. This guide will provide that knowledge. Both testing and revising are needed to make this guide great, but most useful if you can edit the files yourself rather than just pointing out the mistakes.
Communication is key! Make sure you use the systems in place when helping us to test or revise the guides. This keeps people from editing the same guide at once and causing confusion! Post a comment on the works in progress page every time you start something or change something, to keep everyone in the loop!
- Glossary of Terms
- Getting Started
- Formatting Guidelines
- Common Mistakes
- Testing Your Guide
- Uploading Your Guide
- Nuzz’s TourGuide Editor
Syntax – This refers to how the guide files are written in.
Step – An individual objective in the guide.
Tag – An addition to the step that adds detail and essential information.
QID – the Quest ID, a unique number the game and addons use to identify a specific quest.
1. Download the addon and it’s dependencies.
You can find the addon and supporting files, along with instructions on how to download and use theme, on the General Info Page. Familiarize yourself with the way the guide works in game before you start working on the code.
2. Decide on an editing program.
I highly recommend Notepad ++ as an editing program. It organizes things very nicely and has some basic features that help with coding, and is free to download. However, you can use the basic notepad programs that come with your computer if you prefer.
3. Find a section to work on.
Go to the List of works in progress and find a guide you want to work on, that no one is currently signed up for. Leave a comment that you would like to work on that guide, and a moderator or admin will add your name to the list. Make sure you check in at least once a week with your status, or we may give that section to someone else to work on.
4. Open up the file and get to work!
First, you’ll need to find the section you want to work on in the addon files. The naming format is as follows: « 002_43_44_Jame_Dustwallow_Marsh », where the first number is just a placeholder (ignore it), the second is the starting level, the third is the ending level, and the last is the zone name.
It is probably easiest to edit guides with WoW running in windowed mode. This is a mode for WoW that you can get to through your video options in game. I usually have one browser window open with a tab for the written guide and a tab or two for WoWhead, my Notepad ++ window, and WoW all running at once, and alt+tab between them.
Now you should be ready to start editing!
As you write or revise a guide, the most important thing to realize is that the WoW-Pro addon works in steps rather than paragraphs. This can sometimes make it a little difficult to translate Jame’s guides into addon form. Follow the formatting guidelines below if you get confused.
Most of the time you will be revising a guide already in place. However, if you want to create a new guide, you’ll need to start off by inputting the following code:
WoWPro:RegisterGuide("[WoW-Pro|Jame] Dragonblight (73-75)", "[WoW-Pro|Jame] Grizzly Hills (75-77)", "Horde", function() return [[ <insert guide here> ]] end)
This will of course have to be modified to accommodate the guide you’re writing.
then save it as a .lua file with the name formated like:
Each step in Jame’s guides must fall under one of the following types. Each step must also have it’s own line in the guide. You can separate them with blank lines (this can really help readability for people revising the guide), but make sure that those lines have NOTHING on them. It will keep the guide from loading if they have anything other than the following types of steps.
A – Quest Accept
A Wanted: Dreadtalon |QID|12091|N|From the Wanted Poster just outside the door.|
Use this every time you direct the player to accept a step. Usually coordinates are not needed for these steps, since Lightheaded is a required part of the addon package and should have almost every accept and turn in coordinate in it’s database.
C – Quest Complete
C Blood Oath of the Horde |QID|11983|N|Talk to the Taunka'le Refugees and go through the text until you complete the quest.|
Use this when the player is completing all of the steps of a quest at once. If you are planning to split up the quest complete steps, you’ll need to use a note or kill step instead with quest objective tags on it. For most quests you will not need coordinates as the game provides those to us, but sometimes they don’t do the job well enough. In these cases use a |NOPOI| tag and make your own coordinates.
T – Quest Turn-in
T The Flesh-Bound Tome |QID|12057|N|Back at Agmar's Hammer.|
Use this every time you direct the player to turn in a step. For most quests you will not need coordinates as the game provides those to us, but sometimes they don’t do the job well enough. In these cases use a |NOPOI| tag and make your own coordinates.
R – Run
F – Fly
b – Boat/Zeppelin
H – Hearth
H Warsong Hold |QID|11686|U|6948|
These steps are all really variations on the same type – a location change. The step auto-completes when the subzone or zone name matches the specified one (in the example above, the step would complete when the character enters Warsong Hold). Coordinates are useful for this step, so that players can see where to run, or where the flight master is if flying. Make sure to include the zone tag if needed.
h – Set Hearth
h Warsong Hold |QID|11598|N|(41.9,54.5)|
Make sure to spell the town’s name exactly correctly, or it won’t auto complete correctly. Auto-completes on the message » is now your home. » Also provide a Note tag with coords.
f – Get Flight Point
f Moa'ki Harbor|QID|11585|N|(48.5,74)|Z|Dragonblight|
Most of the time a flight point is fairly easy to spot, but occasionally they can be a bit out of the way. In these cases, use this step to ensure the player finds it.
K – Kill
K Fjord Crows |QID|11227|L|33238 5|N|Until you have 5 Crow meat.|
This is one of the few steps that you might not have auto-complete, since there are times in Jame’s guide when he has you kill everything of a certain type in an area but not necessarily stay there to complete the quest. However, whenever possible add a loot or quest objective tag so that this step will auto-complete.
N – Note
N Burn The Kur Drakkar |QID|11656|QO|The Kur Drakkar destroyed: 1/1|U|34830|N|To the north, just next to The Serpent's Maw.|
Note steps are used when none of the above steps fit, always try to add some kind of tag to allow this to auto-complete.
B – Buy
U – Use
B Fresh Pound of Flesh |QID|11309|L|33612|N|Anton patrols along the road between New Agamand and the Ancient Lift. If he's dead, he respawns at (53,74).|
I find these two to be mostly cosmetic as you can do the same job using a Note step with a Loot and Use tag.
|QID|####| – Quest ID
This tag is REQUIRED for every step that has anything to do with a specific quest. This includes but is not limited to: Accept, Complete, and Turn-in steps, and steps with the Quest Objective tag
Even on a step that has nothing to do with any quest (e.g. Hearth steps) it is still recommended to have this tag there as well. For these use the QID of the next Accept step.
|QO|Some Mob slain: 10/10| – Quest Objective
N Watchtower Burned |QID|11285|QO|Winterskorn Watchtower Burned: 1/1|U|33472|N|The watchtower is directly to your west, burn it.| N Bridge Burned |QID|11285|QO|Winterskorn Bridge Burned: 1/1|U|33472|N|Head behind the tower and go west to the bridge, burn it.| N Dwelling Burned |QID|11285|QO|Winterskorn Dwelling Burned: 1/1|U|33472|N|Over the bridge, just west, is a small building, set it alight as well.| N Barracks Burned |QID|11285|QO|Winterskorn Barracks Burned: 1/1|U|33472|N|The final structure is to the northwest, careful not to aggro the elite when you light it up.|
A |QID| tag is required for this tag to function. This is used for quests where you won’t be completing all objectives at the same time or when the objective locations are very specific and static. In the example above, coords are not needed as they are provided to us by the game.
|O| – Optional
This tag makes the step optional and will only show if the player has the quest in their quest log. Use this on an Accept step with a Use tag and it will only show if the player has the item in their bags, useful for quests that come from items.
|PRE|Quest Name| – Prerequisite
This is used with the Optional tag to only show the step if the player has Turned-in the quest used in this tag. Use this only on Accept steps.
Every Complete, Turn-in, and Quest Objective get its coords from the built-in POI system that was added in 3.3. There will only be one point on the map per quest, if a quest has mutiple objectives it will choose the one closest to you, if the objective is spread over an area it will create a blob on the map and the point will be in the center.
Sometimes these are not optimal, in these cases you can use this tag to fall back to note coords to provide your own. NOTE this should only be used if the guide assumes the player will be at a specific location.
|L|####| – Loot
Used when you need to make sure the player has a specific item or amount of an item in their bags. Add the quantity after the item number with a space in between. If you only need one of an item, you do not need to specify a quantity.
|U|####| – Use
This will create a movable button for the item specified so you don’t have to dig through your bags to find it. This is mandatory for every Hearthstone step (item #6948)
|C|Priest,Mage,…| – Class
|R|Orc,Troll,…| – Race
These will only show the step if you are playing the specified class/race, these can be listed.
|N|…| – Note
A general note for the step to add additional information. If a step need coords they will go here in parentheses (xx.xx, yy.yy).
|Z|Zone Name| – Zone
Use this tag if the step goes outside the zone for the guide.
In a post on his blog, Jame clearly outlined the standards of quality he is looking for in the leveling addon. I’ll go over what he said here and add a few other pointers as well.
1. Auto-complete whenever possible
If it’s at all possible to set a step to auto-complete, do so. Sometimes this means breaking something into multiple small steps. Try to put things in a logical order, and use the |N| note tag to remind players of other objectives.
2. Use an arrow whenever possible
Anytime you can provide an arrow for the player to follow, it greatly improves the guide. Rather than making them read a huge block of text as directions, just have them « follow the arrows » and list a series of coordinates. Try to be as exact as possible, since you want the series to flow naturally, so put the steps in places the player would naturally run. Make sure you test these series, since sometimes TomTom will jump to the nearest coordinate rather than the next in the series.
You can even use these arrows for steps you wouldn’t initially think of, such as sell/repair, hearthstone setting, flight paths, or docks/zeppelin towers.
3. Be short and to the point
Try to keep it to one sentence notes when possible. The less reading, the faster leveling! Remember, use arrows instead of wordy directions.
4. Include class quests
Using the |C| class tag, you can incorporate class quests into the guide wherever they would best fit. The goal is to include all necessary class quests – please note that some are definitely NOT necessary, such as the druid poison quest or the paladin sense undead quest.
5. Include optional quests
use the |O| optional tag to allow players the choice of small optional circuits. This is great for people leveling in a group who might be able to tackle mobs that are too hard for the normal leveling crowd.
6. Always provide a |U| use tag when applicable
Use the |U| use tag to help players complete quests without digging through their bags to locate quest items.
7. Warn for accidentally selling quest items
Using the |B| buy tag after a sell/repair step to check if the player still has the necessary item in his or her back, and provide text warning them to buy it back if the step does not auto-complete. The warning will automatically disappear once they buy it back.
8. Code in « paragraphs »
Leave blank lines between steps when the location changes. This really helps when revising code.
1. Quests with the same name
When you have a quest with several follow ups with the same name, you MUST add (Part 1) (Part 2) (Part 3) etc tags in the step description, or it won’t work.
For example, in the 1-12 Night Elf guide:
A The Balance of Nature |QID|456| C The Balance of Nature |QID|456| T The Balance of Nature |QID|456| A The Balance of Nature |QID|457|
Needs to be:
A The Balance of Nature (Part 1) |QID|456| C The Balance of Nature (Part 1) |QID|456| T The Balance of Nature (Part 1) |QID|456| A The Balance of Nature (Part 2) |QID|457|
2. You MUST include a |Z| zone tag for coordinates not in the zone listed in the guide’s title.
If you don’t do this, the coordinates will point back to the title zone. Note that you do not have to provide this tag for quest turn ins or accepts, since Lightheaded tells TomTom/Cartographer the correct zone for those.
Okay, so you’ve written your guide, and now what? Playtest it.
If this is a new guide, first make sure it is inside the WoW-Pro/Horde or WoW-Pro/Alliance folder. Then, open up the Guides.xml file in that folder. This file is basically an index that tells the addon which guides to load. The syntax is:
<script file="file name"/>
What you need to do is add your guide into this file. That’s it, then you can fire up the game and it should load, ready for testing.
It’s often very useful to revise the guide while playing. When you make a revision, you can reload the addon without logging out by using the following macro:
Once you have your guide up to snuff, it’s time to upload it and share it with the wow-pro community.
- First, make a zip or rar file and put all the guide files in your guide into this file (this is only applicable if there are multiple files for one guide, like for Jame’s old world leveling guide chapters).
- Once you have your file ready, you need to upload it somewhere. Unfortunately you can’t upload it directly to WoW-Pro due to file type constraints. Some sites that are commonly used include FileFront, MediaFire, and Google Sites.
- When your guide is uploaded, leave a comment on the Works in Progress page with a link to the download for the file. A moderator will put this into the table, so that anyone wanting to work on that guide before the next addon version comes out will be able to use your updated file.
Download Here – Updated for WotLK (January 22nd 2009)
Writeup from Nuzz:
The good thing about this program: It provides an efficient way for creating TourGuide files quickly. Since you will be working quickly, you will be less likely to cut corners and leave out things such as coordinates or item/quest IDs.
The bad thing about this program: It is not perfect, and you cannot currently edit TourGuide files that have already been made by other people. The compilation process is one-way.
This is a program that will compile TourGuide LUA files on the fly. It was designed for the purpose of creating or tweaking TourGuide scripts, while playing the game at the same time. It was also designed to simplify the process of creating TourGuide scripts. Instead of learning the syntax for the code, and typing everything in by hand, you can use this program’s form to fill in fields. A listbox displays all of the objective for the current ‘guide’, and there is a guides tab with another list box containing all of the ‘guides’ for the project. You can export your project to a folder, and the folder will have all of the LUA files you need, a text file to insert into the main list of guides, as well as a text-file with instructions for how to do this (and a pop-up with the same instructions will appear). When editing these objectives, you can copy and paste either the quest name, or the quest ID, and the quest ID will automatically be filled in if there is one match, otherwise you will get a list of quest IDs to choose from (I usually look it up on a site such as thottbot if I cannot find the quest).
The quick, non-detailed process for converting traditional « text-based guides » to addons is:
- Time Spent (editing the guide and testing it together in part two): roughly 50% gameplay, 50% guide editing, depending on your style and performance
While not in-game, read through the guide and use the TourGuide editor to create as accurate of a TourGuide representation of it as possible, in the least amount of time possible.
The items to focus on in this phase are (in order of importance):
- Quest Accept, Quest Do, Quest Complete Objectives (coords are only needed on Quest Do)
- Quick, simple instructions (note section) for what is needed to complete the quest
- Make sure that you use a run/fly/boat/hearth objective to make sure your character is in that current zone before the objectives for that zone will be executed. The author of the editor did not intend for the guides to use the Zone objective. A side effect of this is that sometimes when logging onto the game, the arrow direct will be given for the world map’s coordinates and not the current zone’s coordinates. To fix this in-game, open and close the world map, then check/uncheck the current objective as completed.
- Time Spent (during in-game only): roughly 80% gameplay, 20% tweaking the guide
I usually do the above part several levels at a time, but not the entire thing. Just enough so that I can stay ‘ahead’ of where my character is. At this point, I will export the guide and install it as part of the addon, then go in-game and run through it with my character. I will make corrections as needed, and update each coordinate as needed with exact measurements (To the nearest 0.1).
- Time Spent: roughly 98% gameplay, 2% tweaking the guide
When I make a pass a second time with another character, I will tweak the guide again, but this requires a minimum of adjustments. I usually am leveling very fast by then, and can even spend time doing other things, or play very little, and still manage to level up at a reasonable speed.