LibTourist Classic (Cataclysm)
LibTourist Classic (Cataclysm) is a library that provides information about zones, instances, transports and more for WoW Classic Cataclysm.
LibTourist-3.0 was first released in september 2007, based on "Tourist-2.0", its predecessor. One could say the library is almost as old as WoW itself. These days, World of Warcraft goes back to its roots with WoW Classic. LibTourist does the same with LibTourist Classic-1.0.
For zones, instances, complexes and battlegrounds in Azeroth, Outland and Northrend, LibTourist Classic can provide level range, faction, size, location and road connections with other zones, as well as instance group sizes and instance entrance portal coordinates. LibTourist Classic supports localization. Color-coding for level ranges and zone names is available.
Relationships between continents, zones and instances can be provided, i.e. which instances are located in a specific complex, in which continent resides a zone and so on. In addition, a large number of iterations is available allowing addons to browse through subsets of the zone data.
The library contains information about connections between zones, including transports like zeppelins, boats and portals. These connections can be used to calculate a route between two zones. LibTourist Classic can also be used for distance calculations between coordinates.
Furthermore, LibTourist Classic can provide information about Herbs and Mining nodes, telling which node types can be found within a zone and in which zones a type of node can be found, as well as the minimum required skill to gather a specific type of node. Also, the gathering difficulty color can be calculated based on skill level or node type.
Note: LibTourist does not provide the coordinates of individual nodes.
An extensive API allows the addon developer to query LibTourist Classic in many ways.
See the API Reference page for detailed information.
NOTE: LibTourist should not be installed separately as it does not add anything to the game on its own. LibTourist is not an addon but a library, to be referenced and used by addons (like ZoneInfo Classic).
WoW Classic Era:
Please refer to the LibTourist Classic Era project page for the Classic Era version of LibTourist.
WoW Retail:
Please refer to the LibTourist-3.0 project page for the retail version of LibTourist.
There is a minor issue with the method "IteratePath", since Wotlk there is no more a boat between Menethil and Auberdine, it has been moved to Stormwind.
In reply to Drigtime:
Hi, thanks for the feedback :-) I've moved the Darkshore boat to Stormwind City. This will be included in the next release, though I don't know yet when that will be.
I assume the Dustwallow Marsh and Howling Fjord boats still depart from Menethil?
Odica
In reply to Odica_Jaedenar:
Thank you very much :)
Your assumption is correct, Dustwallow Marsh and Howling Fjord boats still depart from Menethil.
In reply to Drigtime:
You're welcome :-) As it happens a bug was reported which I fixed right away, resulting in a new release, which also contains the updated boat connection.
No longer works as of June 26 with Titan Panel Classic Recommended Zone. Here is the lua error I'm getting
Using the 2019 release of RZ:
2x ...Libs\LibTouristClassic-1.0-90240/LibTouristClassic-1.0.lua:2052: bad argument #3 to '?' (string expected, got nil)
[C]: in function `?'
...Libs\LibTouristClassic-1.0-90240/LibTouristClassic-1.0.lua:2052: in main chunk
Locals:
(*temporary) = "%s - %s Boat"
(*temporary) = "Darkshore"
(*temporary) = nil
(*temporary) = "string expected, got nil"
In reply to marblexavier:
I will look into it but I think you should contact the author of Titan Panel. This addon is outdated, assuming you are playing Burning Crusade Classic.
In reply to Odica_Jaedenar:
Oh I am playing (actual) Classic Vanilla, not TBC. And I definitely will contact the author of Titan Panel. Thank you for looking into it. :)
In reply to marblexavier:
Okay, if you are playing Classic Era, the addon should be in _classic_era_\Interface\AddOns.
The LibTourist version to be used is the 1.13.5 release version, which is compatible with 1.13.7.
You can download it here:
https://www.wowace.com/projects/libtourist-classic/files/3033418
Try to combine that with your 2019 version of RZ, in the _classic_era_ environment.
In reply to Odica_Jaedenar:
OK using the linked LibTourist file with the 10/13/19 Recommended Zone Release (ver 1.0.0.5) and version 1.2.8.11306 of Titan Panel Classic produces the same error:
5x ...Libs\LibTouristClassic-1.0-90240/LibTouristClassic-1.0.lua:2052: bad argument #3 to '?' (string expected, got nil)
[C]: in function `?'
...Libs\LibTouristClassic-1.0-90240/LibTouristClassic-1.0.lua:2052: in main chunk
Locals:
(*temporary) = "%s - %s Boat"
(*temporary) = "Darkshore"
(*temporary) = nil
(*temporary) = "string expected, got nil"
Is this information helpful?
In reply to marblexavier:
It looks like there is a problem with a Darkshore boat. For TBC, a boat connection to Azuremyst Isle was added to LibTourist, and Azuremyst is unknown in Classic Era.
This might be the cause of the problem if a TBC version of LibTourist is loaded.
Are you sure the 1.13.5 version of LibTourist is the one that has been loaded? There might be another addon installed that uses a newer version of the Library. If that addon is loaded first, that will be the LibTourist used by RZ.
You can test this by disabling all addons except RZ, make sure RZ is using the 1.13.5 version and see if the error still occurs.
I have tested Titan Panel Classic 1.2.8.11306 + Recommended Zone 1.0.0.5 on Classic Era and could not reproduce the problem.
In reply to Odica_Jaedenar:
OK I cannot tell you how much your help is appreciated. Turns out, the problem was Fishing Buddy, of all things, which also contains a "libtourist" file and several of its components. Disabling this addon and loading what I already had fixed the problem.
I will contact Fishing Buddy and let them know...
Thank you for all your help :D
In reply to marblexavier:
Yeah, I have been in contact with Sutorix, the author of fishing buddy. He was not aware that TBC en Classic have separate addon environments, which caused problems for him getting the proper version of LibTourist loaded. So, he should already be working on this issue ;-)
Meanwhile, you coud replace the LibTourist that came with Fishing Buddy by the 1.13.5 version as a workaround.
And, no problem, you're welcome ;-)
In reply to Odica_Jaedenar:
Believe me, much appreciated. It's so funny how dependent I am on these addons I've been using since 2005. LOL. Make sure yours are update for Wrath LOL!
Hey! Im using your lib and noticed that difficulty colors for nodes not accuarate, they differ from original colors that you get in your gametooltip when you hover mining/herb node. (talking about GetGatheringSkillColor() method)
I haven't managed to find special globals for gathering nodes, but there is some gobals for quest difficulty which is pretty much the same as we get while hovering the herb/mine in world, think you can use them instead.
Also it seems that there is missing Flame Cap herb info.
PS.: And feature request if possible: Add data and methods for UNITS which can be gathered / mined. Like Bog Giant for herbalism and so on. :P
Thank you!
In reply to MickeyPickey:
Hi Mickey,
Thanks for your feedback, it's appreciated!
I will look into the difficulty colors to see if I can make them match the colors used by the game.
You are right, Flame Cap is currently not in the herbs list. For now, I decided to include only herbs that are crafting reagents. Herbs like Flame Cap or Fel Blossom cannot be used for crafting, instead they give a buff when used.
If such herbs are included, things tend to get a bit fuzzy because what to do with herbs that are quest-related or herbs that can be gathered by non-herbalists? However, if those buff-giving herbs yield herbalism skill when gathered, it might be useful to mention those.
If herbs can be gathered from units, this generally does not change which herbs can be found in which zones. Also, if this data is to be included, an extra layer has to be added to the herb data to be able to distinguish sources (types of nodes and units). I have to gather this information manually from fan sites and that's a lot of work. Ragveil, for example, can be gathered from 13 different units... and those units have to be known by LibTourist as well.
In short: a load of work for not much added value if consider that the goal was to provide information on which herb can be found in which zone...
Regards,
Odica
In reply to MickeyPickey:
FYI: the difficulty colors have been corrected :-)
I am not sure which addon does it, but I have LibTourist Classic and LibStub in my addon files now...
I am not worried if it helps all the addons ...
Any comment...
In reply to comicus13:
You mean LibTourist is installed as a stand-alone addon? That's not supposed to happen, as LibTourist does not add anything to the game on its own. Also, an outdated version installed there might cause problems in other addons that use LibTourist.
You are not the first one to report this, though, so I suspect there is an addon that incorrectly puts LibTourist Classic directly in the Addons folder.
I have checked the zip file of ZoneInfo Classic (an addon I maintain myself which uses LibTourist) but it's composed correctly.
Can you try and find the addon that installs LibTourist in the Addon folder? I think you should be able to find it by looking at the modification timestamps of the addon folders. Once identified, the addon author should be notified that the packaging is incorrect.
Thanks,
Odica
Azshara fishing level is somewhat wrong, as the subzone Bay of Storms has a minimum fishing level of 330.
In reply to Logoth:
Some subzones have higher minimum levels but LibTourist does not make that distinction. So, it returns the minimum level required to fish and avoid get-aways for the zone. In case of Azshara, you can fish in (most of) the zone after reaching fishing skill 205.