v1.2.8a
23 December 2009
(Written for Live Servers v3.3.0.11159)

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.

Quickstart:

Download and install:

• Routes
• GatherMate
• GatherMate_Data

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

Importing into GatherMate:

type: /gathermate

• Go to 'Import Data' and then to 'GatherMateData' (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 GatherMateData' 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 'GatherMate' 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,

Notes:

If you are using Carbonite and you are running into 'weird' errors using Routes related to 'Cartographer' (about HasModule), 'Cartographer_WayPoints', or 'TomTom' please turn of all 'Emulation' in Carbonite for these addons. If any error still exists after doing so, let us know so it can be fixed.

Features:

• 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!

Download:

The latest version of Routes is always available on this page... or at:
http://wow.curse.com/downloads/wow-addons/details/routes.aspx
http://www.wowinterface.com/downloads/info11401-Routes.html

Contact:

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

• Forum: http:forums.wowace.com/showthread.php?t=10369
• IRC : Grum or Xinhuan on irc:irc.freenode.org/wowace
• Email: Grum ( routes AT grum DOT nl ), Xinhuan ( xinhuan AT gmail DOT com )

Paypal donations are welcome ;)

Changes:

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)