Minion Beta! - Help us test our new AddOn updater. Get it now!
(283 Kb)
Updated: 12-17-11 08:24 AM
File Info
Updated:12-17-11 08:24 AM
Created:10-25-08 06:06 PM

Routes  Popular! (More than 5000 hits)

Version: v1.4.2
by: Xinhuan, Grum, Kagaro

17 December 2011
(Written for Live Servers v4.3.0.15050)

Routes allow you to draw lines on the worldmap linking nodes together into an efficient farming route from existing databases. The route will be shown (by default) on the minimap and zone map as well.

Use /routes to begin.

See spikey star-shaped routes?

You haven't optimized the route yet. Go into the route you created and optimize it. Instructions below.


Download and install:

Start up World of Warcraft and make sure all addons are marked to be loaded (in the addon selection screen).

Importing into GatherMate2:

Type: /gathermate
  • Go to 'Import Data' and then to 'GatherMate2Data' (left side)
  • If you already have herbs/mines of yourself, select 'Merge' from the 'Import Style' dropdown, otherwise 'Overwrite' is ok.
  • Select which sources you want to import (ea: Mining/Herbalism) and tick their respective boxes.
  • Hit the 'Import GatherMate2Data' button on the bottom.

Creating your first route:

Type: /routes
  • Go to 'Add' (left side)
  • Type the name of your route (and press 'Okay' or enter)
  • Now select the zone you want to create a route in from the 'Select Zone' dropdown.
  • Make sure the 'GatherMate2' source has it's checkbox ticked.
  • Select which nodes (ea: what type of herbs/mines/fish) should be used to create your route.
  • Hit the 'Create Route' button.
  • Done! you can now go to the zone and follow the generated 'route' on your minimap.

You can change the color in the 'Line Settings' tab (and also completely hide the route)

Open your worldmap on the zone you just created a route in, and you will see a massive whirling of lines (light-redish).

Changing/Optimizing your route:

Type: /routes
  • Go to 'Routes' and then the zone you made your route in and finally to the route you created. This has taken you to the 'Information'-tab of this route.
  • Click on the 'Optimize Route' tab.
  • Hit the 'Cluster' button, this is usually advisable as most zones contain large amounts of nodes. Clustering will group 'nearby' nodes onto 1 point and the default distance is easily viewable on the minimap.
  • Hit the 'Foreground' button, this will try an optimization of the length of your route (you can see it being updated after it finishes if you use a map addon like Mapster).
  • Keep hitting the 'Foreground' button to try and make the route smaller,

  • Select node-types to build a line upon. The following are supported
    • GatherMate (Author's preference)
    • Cartographer_Fishing
    • Cartographer_Mining
    • Cartographer_Herbalism
    • Cartographer_ExtractGas
    • Cartographer_Treasure
    • Gatherer
    • HandyNotes
  • Optimize your route using the traveling salesmen problem (TSP) ant colony optimization (ACO) algorithm
  • Background (nonblocking) and foreground (blocking) optimization
  • Select color/thickness/transparency/visibility for each route
  • For any route created, finding a new node will try to add that as optimal as possible
  • Quick clustering algorithm to merge nearby nodes into a single traveling point
  • Quickly mark entire areas/regions as "out of bounds" or "taboo" to Routes, meaning your routes will ignore nodes in those areas and avoid cross them
  • Fubar plugin available to quickly access your routes
  • Cartographer_Waypoints and TomTom support for quickly following a route
  • Works with Chinchilla's Expander minimap and SexyMap's HudMap!
  • Full in-game help file and FAQ, guiding you step by step on what to do!


The latest version of Routes is always available on this page... or at:


If you find any bugs or have any suggestions, you can contact us on:

Paypal donations are welcome

Changes from v1.4.1 to v1.4.2 (17 December 2011)
  • Updated TOC
  • Updated LibMapData (so the new zones work properly)
  • Fixed division by zero errors from occurring in the future (the PTR servers disabled it the Lua language settings in PTR 4.3).
  • Fixed background processing so that it no longer acts like foreground processing (WoW changed the behavior of GetTime() function).
  • Fixed timers from reporting the wrong time when doing foreground and background route optimization.
  • Add Brazilian Portuguese localization files. The translations are only partially done.

Changes from v1.4.0 to v1.4.1 (30 June 2011)
  • Updated TOC
  • Update LibMapData (so the new zones work properly)

Changes from v1.3.3 to v1.4.0 (6 May 2011)
  • Fixed Routes to work with TomTom 4.1 (which has some API changes). Reduced reliance on TomTom's API. That is, we no longer use Astrolabe in TomTom anymore.
  • Fixed issues with map phasing interfering with Routes in Uldum, Hyjal, Twilight Highlands, Gilneas, Gilneas City and The Lost Isles.
  • Routes will no longer error on finding invalid node data in GatherMate2 and will just ignore them.
  • Add "Recreate Route" button for routes (found next to "Delete" route button). This recreates the route using the same creation settings, but only works for data from GatherMate2 and Gatherer. It even works for a route created in one of them, you switch addons, and then recreating it from the other!
  • Improvements submitted by Mikk.
    • Improve route optimizing speed by 10% by not using table recycling.
    • Improve background route optimizing speed by 30% by checking execution time and yielding less often (resulting in more stable FPS).
    • Progress of background execution is now shown in the status bar of the Routes configuration if it is open.

Changes from v1.3.2 to v1.3.3 (13 December 2010)
  • Fix issue in Hyjal, Twilight Highlands, Uldum (and also Gilneas and The Lost Isles which have no collectible nodes) zones. These zones contained map phasing where the map shown to you depends on which phase you were in. Routes treated these different phase maps as separate zones, resulting in a potential "no data found" depending on which phase you logged on your character in. This has been fixed.

Changes from v1.3.1 to v1.3.2 (11 December 2010)
  • Fix for errors when using Routes with Gatherer and TomTom.

Changes from v1.3.0 to v1.3.1 (10 December 2010)
  • Updated for patch 4.0.3 live servers. Happy farming in the new Cataclysm zones! You may need to restart your WoW client completely after updating Routes.

Changes from v1.2.8a to v1.3.0 (18 October 2010)
  • Updated for patch 4.0.1 live servers (not closed beta!)
  • We won't complain anymore about Carbonite pretending to be Cartographer.
  • We will now register the /routes slash command for non-English users too
  • Fix a long standing obscure bug where a route would be created with node types that aren't selected.
  • Significantly reduce memory usage of Routes. Roughly 13kb less per route so if you have say 50 routes, that's 650kb less. This update has no effect on CPU usage or FPS.
  • Fix up errors caused by patch 4.0.1 changes to professions and skills. Add Archaeology to the node types to support GatherMate2 (but note that while GatherMate2 is usable on the Cataclysm beta, Routes currently is not)
  • Add support for GatherMate2. Please stop using GatherMate. GatherMate is now only maintained for China-wow and is not Cataclysm compatible.

Changes from v1.2.7 to v1.2.8a (23 December 2009)
  • Updated TOC for 3.3.0.
  • No functional changes (when will people finally learn to simply check the stupid 'Load out of date Addons' box?)

Changes from v1.2.6 to v1.2.7 (13 August 2009)
  • Added new zone (Hrothgar's Landing).
  • Updated TOC for 3.2.0.

Changes from v1.2.5 to v1.2.6 (29 April 2009)
  • Fixed another cause of the SetTexCoord error. Thanks everyone for helping out, especially [[|Kazragore]].

Changes from v1.2.4 to v1.2.5 (28 April 2009)
  • Maintenance, fixed line endings and version generation in TOC.

Changes from v1.2.3 to v1.2.4 (26 April 2009)
  • Fixed SetTexCoord bug which was annoying everyone since 3.1.0. (all arguments must be between -10000 and 10000)

Changes from v1.2.2 to v1.2.3 (18 April 2009)
  • Updated for 3.1.0's GetPlayerFacing (for rotating minimaps).
  • Upgraded to wowace's localization system.

Changes from v1.2.1 to v1.2.2 (8 November 2008)
  • Fix possible loading order issue caused by Blizzard bug with optdep and reqdeps.
  • Hopefully fix most cases of Routes producing routes that cross over itself.
  • Add support for reparenting to Chinchilla's Expander or SexyMap's HudMap.

Changes from v1.2 to v1.2.1 (26 Oct 2008)
  • Moved 'Edit Route Manually' to a =tab.
  • Moved 'Create Bare Route' button to the top of 'Add Route'.
  • Reworked the 'source data' multiselect to be more verbose.
  • Added a second 'Create Route' button.
  • Update URL of forum thread in the FAQ to the new wowace forums.

Changes from v1.1.1 to v1.2 (25 Oct 2008)
  • Fix "No data found" until you toggle the "Select sources of data" checkboxes issue.
  • The zone dropdown list (both taboo and route creation) will now list ALL zones instead of just the outland ones and the one you are in/viewing.
  • Update FAQs.
  • Add HandyNotes support to Routes. You can now make routes from your own HandyNotes!
  • Add "Note" category to Auto show/hide module.
  • Remove old style taboo editing. Implement new GoogleMaps style taboo shape editing.
  • Implement manual editing of any route that is not clustered.
  • Editing a taboo/route will now open the map to the correct zone.
  • Fix issue where Routes would fail to work with GatherMate if AddonLoader is present (which causes GatherMate to be LoD-delayed)

Changes from v1.1 to v1.1.1
  • Fix taboo region creation menus and menuitems to work.
  • Remove embeds.xml/locales.xml and move them into the TOC.
  • Fix the Dalaran data login spam.

Routes key changes in the past:
  • Add TomTom Support (3rd June 2008)
  • Add initial route decrossing generation from Polarina (5th may 2008)
  • Added a comprehensive help file (4th May 2008)
  • Reduce route generation time by 20% via coding optimizations (26th April 2008)
  • Patch 2.4 (26th March 2008)
  • Taboo Regions feature added (10 February 2008)
  • Conversion to Ace3 from Rock framework complete (4th February 2008)
  • Add node clustering algorithms (25th January 2008)
  • Add support for Gatherer (24th January 2008)
  • Add FAQ (22 January 2008)
  • Conversion to Ace3 begins, and to drop Cartographer/Graph/Babble dependency, and add GatherMate support (20 January 2008)

Cartographer_Routes key changes in the past:
  • Add Cartographer_Waypoints support (27 December 2007)
  • Add Cartographer_ExtractGas support (24 December 2007)
  • Add Cartographer_Treasure support (14 December 2007)
  • First release (14 October 2007)
  • Initial joint project development from individual lines of work (3rd October 2007)
Optional Files (0)

Archived Files (11)
File Name
06-30-11 03:18 PM
05-06-11 08:12 AM
12-12-10 03:59 PM
12-11-10 04:25 AM
12-09-10 08:03 PM
10-17-10 05:21 PM
12-23-09 09:27 PM
08-30-09 12:07 PM
05-08-09 06:29 PM
04-26-09 04:36 PM
11-08-08 04:27 PM

Post A Reply Comment Options
Unread 09-12-12, 01:01 AM  
A Kobold Labourer
slippycrits's Avatar

Forum posts: 0
File comments: 11
Uploads: 0
Getting this error on logging into the game with routes loaded. Doesn't matter if the zone I'm logged in has a route or not.


8x Routes-v1.4.2\Modules\AutoShow.lua:21: table index is nil
Routes-v1.4.2\Modules\AutoShow.lua:21: in main chunk



I logged off in the middle of farming a route, and upon logging in the route was hidden. Through some tinkering I found that checking Show Indoors showed the route. So I went indoors and back out and the route was showing as normal again.

Also, in Hellfire Peninsula the lines on the minimap seem to be moving slightly as I move. The lines on the world map are fine.

edit: Just relogged in Hellfire, the moving lines on the minimap have corrected themselves and it didn't register as indoors. I should mention that the indoor problem was occurring in Swamp of Sorrows, Alterac Mountains, and Arathi Highlands. The moving lines problem occurred in Hellfire after making a new route.
Last edited by slippycrits : 09-12-12 at 01:06 AM.
slippycrits is offline Report comment to moderator  
Reply With Quote
Unread 10-08-12, 09:26 PM  
A Kobold Labourer
AddOn Author - Click to view AddOns

Forum posts: 0
File comments: 3
Uploads: 1
Getting this error every time I log in on a character

Doesn't matter if there is a route in the zone or even if that character has a gathering profession:

Date: 2012-10-08 22:23:52
ID: 1
Error occured in: Global
Count: 1
Message: ..\AddOns\Routes\Modules\AutoShow.lua line 21:
table index is nil
[C]: ?
Routes\Modules\AutoShow.lua:21: in main chunk

teflaime is offline Report comment to moderator  
Reply With Quote
Unread 10-31-12, 03:40 AM  
The Great Equalizer
eqsanctum's Avatar
Premium Member

Forum posts: 143
File comments: 44
Uploads: 0
Not sure why anyone is posting here for routes....

Carbonite Supporter - ZAM Network Supporter - Official Ai-Art Rep - EQInterface OG
eqsanctum is offline Report comment to moderator  
Reply With Quote
Unread 12-09-12, 09:47 PM  
A Kobold Labourer

Forum posts: 1
File comments: 1
Uploads: 0
Is it possible to add a route based on a Wowhead coordinate string? Something that looks like "[35.8,57.4],[35.8,57.8],[36.4,46.2],[36.4,55.2],[36.6,45.2],[36.6,59.2],[36.8,53.8],[36.8,59.8]"

If it's not possible to do from the UI, would it be possible by manipulating a saved data file? If so, where does Routes store its data?
Last edited by sartoreus : 12-09-12 at 09:47 PM.
sartoreus is offline Report comment to moderator  
Reply With Quote
Unread 03-14-13, 10:44 PM  
A Cyclonian
Fiercy's Avatar
AddOn Author - Click to view AddOns

Forum posts: 40
File comments: 139
Uploads: 15
Originally Posted by sartoreus
Is it possible to add a route based on a Wowhead coordinate string? Something that looks like "[35.8,57.4],[35.8,57.8],[36.4,46.2],[36.4,55.2],[36.6,45.2],[36.6,59.2],[36.8,53.8],[36.8,59.8]"

If it's not possible to do from the UI, would it be possible by manipulating a saved data file? If so, where does Routes store its data?
I was just about to ask the same question. Is there a slash command for waypoints or maybe add current location? Thx in advance.
There are countless ingredients that make up the human body and mind, like all the components that make up me as an individual with my own personality. Sure, I have a face and voice to distinguish myself from others, but my thoughts and memories are unique only to me, and I carry a sense of my own destiny. Each of those things are just a small part of it. I collect information to use in my own way. All of that blends to create a mixture that forms me and gives rise to my conscience.
Fiercy is offline Report comment to moderator  
Reply With Quote
Unread 03-29-13, 12:19 PM  
A Kobold Labourer

Forum posts: 1
File comments: 1
Uploads: 0
Unhappy I can't make a route !!!Help Please!!!

When i type in the route name and hit enter nothing happens. Also the create bare routes button doesn't even show up. I don't mean it stays grey its just not there, neither is anything below it. Any ideas on how to fix it?
Kairosonna is offline Report comment to moderator  
Reply With Quote
Unread 07-22-13, 10:52 AM  
A Fallenroot Satyr
Fonjask's Avatar
AddOn Author - Click to view AddOns

Forum posts: 22
File comments: 265
Uploads: 6
This addon is being updated right now at wowace.


Fix for the Gatherer module (get if you want Gatherer to work with this addon):
Fonjask is offline Report comment to moderator  
Reply With Quote
Unread 10-15-14, 03:02 AM  
A Cyclonian

Forum posts: 40
File comments: 18
Uploads: 0
Anyone know if this will be updated to work in 6.0?

Gives this error:

Date: 2014-10-15 02:03:02
ID: 1
Error occured in: Global
Count: 1
Message: ..\AddOns\Routes\Libs\AceDB-3.0\AceDB-3.0.lua line 263:
   bad argument #1 to 'sub' (string expected, got nil)
   [C]: sub()
   Routes\Libs\AceDB-3.0\AceDB-3.0.lua:263: in main chunk
(*temporary) = nil
(*temporary) = 1
(*temporary) = 2
(*temporary) = "string expected, got nil"

  Swatter, v5.21.5490 (SanctimoniousSwamprat)
  WowheadLooter, v60005
  AGT, v
  AskMrRobot, v2
  AucAdvanced, v5.21.5490 (SanctimoniousSwamprat)
  AucFilterBasic, v5.21.5490 (SanctimoniousSwamprat)
  AucFilterOutlier, v5.21.5490.5459(5.21a/embedded)
  AucMatchUndercut, v5.21.5490.5364(5.21a/embedded)
  AucStatHistogram, v5.21.5490 (SanctimoniousSwamprat)
  AucStatiLevel, v5.21.5490 (SanctimoniousSwamprat)
  AucStatPurchased, v5.21.5490 (SanctimoniousSwamprat)
  AucStatSales, v5.21.5490.5476(5.21a/embedded)
  AucStatSimple, v5.21.5490 (SanctimoniousSwamprat)
  AucStatStdDev, v5.21.5490 (SanctimoniousSwamprat)
  AucStatWOWEcon, v5.21.5490.5323(5.21a/embedded)
  AucUtilAHWindowControl, v5.21.5490.5347(5.21a/embedded)
  AucUtilAppraiser, v5.21.5490.5462(5.21a/embedded)
  AucUtilAskPrice, v5.21.5490.5447(5.21a/embedded)
  AucUtilAutoMagic, v5.21.5490.5443(5.21a/embedded)
  AucUtilCompactUI, v5.21.5490.5444(5.21a/embedded)
  AucUtilEasyBuyout, v5.21.5490.5458(5.21a/embedded)
  AucUtilFixAH, v5.21.5490 (SanctimoniousSwamprat)
  AucUtilItemSuggest, v5.21.5490.5417(5.21a/embedded)
  AucUtilPriceLevel, v5.21.5490.5458(5.21a/embedded)
  AucUtilScanButton, v5.21.5490.5403(5.21a/embedded)
  AucUtilScanFinish, v5.21.5490.5347(5.21a/embedded)
  AucUtilScanProgress, v5.21.5490.4979(5.21a/embedded)
  AucUtilScanStart, v5.21.5490.5347(5.21a/embedded)
  AucUtilSearchUI, v5.21.5490.5481(5.21a/embedded)
  AucUtilSimpleAuction, v5.21.5490.5452(5.21a/embedded)
  AucUtilVendMarkup, v5.21.5490.4828(5.21a/embedded)
  Babylonian, v5.1.DEV.332(/embedded)
  BonusRollPreview, v50400.20-Release
  Configator, v5.1.DEV.359(/embedded)
  DBMCore, v
  DBMDefaultSkin, v
  DBMStatusBarTimers, v
  DebugLib, v5.1.DEV.337(/embedded)
  Gatherer, v<%version%>
  GTFO, v4.35
  KillTrack, vv2.6.7
  LibExtraTip, v5.12.DEV.363(/embedded)
  Malkorok, v
  MobCount, v1.0
  Molinari, v50400.30-Release
  QuickRoutes, v5.0-Release1
  Routes, vv1.4.2
  SlideBar, v5.21.5490 (SanctimoniousSwamprat)
  Stubby, v5.21.5490 (SanctimoniousSwamprat)
  TipHelper, v5.12.DEV.351(/embedded)
  BlizRuntimeLib_enUS v6.0.2.60000 <none>
Last edited by Ashkir : 10-15-14 at 03:12 AM.
Ashkir is offline Report comment to moderator  
Reply With Quote
Unread 10-15-14, 10:55 PM  
A Rage Talon Dragon Guard
Fizzlemizz's Avatar
AddOn Author - Click to view AddOns

Forum posts: 321
File comments: 286
Uploads: 10
If this is the only error then download the latest Ace Library and replace in Routes.

Originally Posted by Ashkir
Anyone know if this will be updated to work in 6.0?
FizzleMizz Maintainer of Discord Unit Frames and Discord Art.
Author of FauxMazzle
Last edited by Fizzlemizz : 10-15-14 at 11:03 PM.
Fizzlemizz is offline Report comment to moderator  
Reply With Quote
Post A Reply

Category Jump:

Support AddOn Development!

You have just downloaded by the author . If you like this AddOn why not consider supporting the author? This author has set up a donation account. Donations ensure that authors can continue to develop useful tools for everyone.