LibTourist-3.0

Table of Contents

LibTourist is a library that provides information about zones, instances, transports and more.

For zones, instances, complexes (like Caverns of Time), arenas and battlegrounds, LibTourist can provide level range, faction, size, location and connections with other zones, as well as instance group sizes, instance entrance portal coordinates and battle pet level ranges, if applicable. LibTourist 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 can also be used for distance calculations between coordinates. Recently, data about flight nodes has been added.

An extensive API allows the addon developer to query LibTourist in many ways.

See the API Reference page for detailed information.

WoW 8.0.1

The World Map API has been replaced by the new C_Map API. LibTourist has been adapted but some changes to the library API have been unavoidable. Please read the recent Change Logs or check the API Reference page which is kept up to date as much as possible.

Note: Fishing skills

LibTourist used to provide minimum required fishing skills for each zone but this functionality is currently disabled because the values are obsolete (or at least outdated) and the game interface provides no way of retrieving this data. The original source of the fishing levels, El's Extreme Anglin', went offline years ago. Though the old site has been resurrected, the data has not been updated since WotLK.

Comments

Holobit
- Join Date: 8/12/2018
- Posts: 2
- Member Details
#46 Holobit

View User Profile

Send Message

Posted Aug 12, 2018
I have installed this lib and now I have Pet Level and Zone Leveling Info showing in the in-game map. Is there a way to also enable showing Zone Instances/Raids Info?

Last edited by Holobit: Aug 12, 2018

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#47 Odica

View User Profile

Send Message

Posted Aug 12, 2018
In reply to Holobit:

Hi Holobit,

This library only provides data for other addons, it does not add anything to the game by itself. The player level and battle pet level are displayed on the map by WoW by default. For additional info you'll need something like Cromulent, which relies on libtourist as data provider.

A version of Cromulent that is compatible with WoW 8.0 has just been released today. However, be aware this is an alpha version which still contains some issues.

Please check the Cromulent page for the latest developments:

https://www.wowace.com/projects/cromulent

Odica

Last edited by Odica: Aug 12, 2018

Rollback Post to Revision RollBack
Holobit
- Join Date: 8/12/2018
- Posts: 2
- Member Details
#48 Holobit

View User Profile

Send Message

Posted Aug 13, 2018
In reply to Odica:

I feel dumb now. :)

I could swear my map didn't show any pet level info before, but you are right, id does.

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#49 Odica

View User Profile

Send Message

Posted Aug 13, 2018
In reply to Holobit:

Never too old to learn ;-)

Rollback Post to Revision RollBack
Radoznali
- Join Date: 3/5/2007
- Posts: 60
- Member Details
#42 Radoznali

View User Profile

Send Message

Posted Aug 2, 2018
Is there any eta for this ? I realise thats big ask but i see lots of my broken adons using this lib .I only ask so i dont have to check for progress on my broken addons each day and to get some perspective how hard is to fix it when something so esential is broken with Blizz changes.

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#43 Odica

View User Profile

Send Message

Posted Aug 3, 2018
In reply to Radoznali:

Hi Radoznali,

I have been on vacation for a few days but this weekend I will continue working on LibTourist.

Can you please describe what problems you encounter with the library? Any specific functions causing trouble? Then I can address those with priority or try to advice you on a workaround.

Furthermore, keep an eye on the comments on Issue 47 and the ChangeLog of the latest alpha versions.

Thanks,

Odica

Rollback Post to Revision RollBack
Radoznali
- Join Date: 3/5/2007
- Posts: 60
- Member Details
#44 Radoznali

View User Profile

Send Message

Posted Aug 3, 2018
In reply to Odica:

Thanks for replay -i am no author so no problems that i can ask you to priorities. I am just big addon user and saw a lot of addons being broken by this world map changes.Most of of them happen to be maintianed by Torhal and i saw that those addons need to be completly changed but they depend on libs like libtourist.

I know a takes a lot of free time for addonsauthors to make fixis and I appreciate those efforts a lot but sometime authors forget to inform their fans/users about plans so natuarly we become little bit unpatient and that only reason i asked for eta.

Thanks for great work you are doing.

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#45 Odica

View User Profile

Send Message

Posted Aug 3, 2018
In reply to Radoznali:

I understand. Though I try as much as possible to avoid breaking the API of LibTourist, making some changes is inevitable. Addons using LibTourist will have to be adapted to that, even though the changes are few and minor. Besides that, new functionality has been added to facilitate using LibTourist's lookups with the new C_Map uiMapID, but addons need to be adapted to do so.

As you mention, addons using LibTourist, including the ones made by Torhal, also encounter other problems due to the changes Blizzard made; problems that are not related to LibTourist. These will have to be fixed by the addon author.

For example, I have been using Cartographer ZoneInfo (the predecessor of Cromulent) for testing purposes. I have managed to keep that ancient thing working for a very long time, but as of 8.0 it is really broken. It addresses the World Map so it can display an overlay frame containing the zone information. It also reads the highlight areas of the map. These parts of the game interface have changed as well and personally I don't know how to fix that. Torhal most likely does as he is a way more experienced addon developer than I am. Nevertheless, it is clear there is quite some work to be done for any addon that interacts with the world map.

I suggest you contact Torhal to ask for a status update about his addons that you are using. Meanwhile I will keep trying to get LibTourist as healthy as possible so he and others can keep using it for addon development.

Status: The content of LibTourist (r201) has been updated for 8.0.1 and most of the functionality should be OK. Two aspects of the library are currently not available: distance/position calculations and lookups by texture name. These are marked in red in the updated API Reference of LibTourist. All other functions should be working now.

Finally, thanks for the appreciation of my work :-)

Odica

Last edited by Odica: Aug 3, 2018

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#39 Odica

View User Profile

Send Message

Posted Jul 20, 2018
Quote from Blizzard regarding API changes in 8.0.1:

World Map Changes
The World Map has been almost entirely re-written, and all map API was removed. It’s being replaced but we are currently still transitioning. worldMapAreaID, dungeonMapID, dungeonFloor have all been removed and replaced with just uiMapID.

As you can imagine, this had quite some impact on LibTourist.

I am currently working on adapting LibTourist to these changes - please be patient...

Thanks,

Odica

Last edited by Odica: Jul 23, 2018

Rollback Post to Revision RollBack
txag
- Join Date: 9/30/2008
- Posts: 1
- Member Details
#40 txag

View User Profile

Send Message

Posted Jul 21, 2018
In reply to Odica:

This is fantastic news. Thank you!

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#41 Odica

View User Profile

Send Message

Posted Jul 24, 2018
In reply to txag:

I have posted a first alpha version: r199. Be sure to read the changelog carefully!

Any help on the open issues is appreciated.

Odica

Rollback Post to Revision RollBack
marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#29 marblex

View User Profile

Send Message

Posted Aug 31, 2017
Titan Rec Zone broken due to this file in 7.3:

2x ...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90190.lua:326: attempt to compare boolean with number
...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90190.lua:326: in function `GetLegionZoneLevel'
...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90190.lua:159: in function `UpdateCachedLegionZoneLevels'
...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90190.lua:132: in function <...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:120>
...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90190.lua:2584: in function <...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:2583>

Locals:
self = <table> {
GetUniqueZoneNameForLookup = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:255
TransposeZoneCoordinate = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:639
IterateEasternKingdoms = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1159
IsInKalimdor = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1351
GetBestZoneCoordinate = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:754
IterateAlliance = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1081
IterateSanctuaries = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1117
HasRecommendedInstances = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1261
GetInstanceZone = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:926
IsZoneOrInstance = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1288
IterateZoneInstances = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:886
IterateBrokenIsles = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1245
IsInstance = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1265
GetInstanceGroupSizeString = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1395
IterateHostile = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1095
IterateDraenor = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1230
IteratePvPZones = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1067
GetType = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1284
IterateContested = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1131
IterateComplexes = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1053
IsZone = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1270
GetLevelString = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:335
IterateZoneComplexes = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:906
DoesZoneHaveComplexes = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:966
IterateHorde = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1095
GetComplex = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1280
IterateArenas = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1039
GetEnglishZoneFromTexture = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1459
IterateZones = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:997
frame = LibTourist-3.0Frame {
}
GetFishingLevel = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:314
IsInBrokenIsles = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1379
IsComplex = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1298
IterateRecommendedZones = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1253
GetTexture = <function> defined @TitanRecZone\Libs\LibTou

Any chance of a fix??? TIA

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#30 Odica

View User Profile

Send Message

Posted Sep 2, 2017
In reply to marblex:

Looks like Titan Panel - [Rec Zone] is using an outdated version of LibTourist (r190). Besides that, the add-on has not been updated since 7.1.0.

You could try replacing its LibTourist with the latest version (r194). If that does not solve the problem I think you should contact the author of Titan Panel...

Rollback Post to Revision RollBack
marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#31 marblex

View User Profile

Send Message

Posted Sep 3, 2017
In reply to Odica: Thanks for the response and the update.

Prior to your upload, I did temporarily fix the Libtourist.lua file:

Changed everything after = in line starting with:

playerLevel =

to:

(level and level ~= true) and level or UnitLevel("player")

Thanks to benik30 and Veyska.

Cheers!

Last edited by marblex: 3 days ago

Last edited by marblex: Sep 3, 2017

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#32 Odica

View User Profile

Send Message

Posted Sep 4, 2017
In reply to marblex:

Hi,

I found the same bug myself due to simular errors from a different add-on that uses LibTourist. Should be fixed in r195!

Odica

Rollback Post to Revision RollBack
marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#33 marblex

View User Profile

Send Message

Posted Sep 4, 2017
In reply to Odica:

Thank you SO much! One doesn't realize how many of these libraries are in use! With over 250 addons it's hard to keep track.

Cheers!

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#34 Odica

View User Profile

Send Message

Posted Sep 4, 2017
In reply to marblex:

Thanks for the appreciation, you're welcome :-)

Does it work OK now?

Rollback Post to Revision RollBack
marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#35 marblex

View User Profile

Send Message

Posted Sep 5, 2017
In reply to Odica:

yes! Apparently the addon itself (rec zone) is completely dependent on your work. Functions perfectly now :D

Rollback Post to Revision RollBack
marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#36 marblex

View User Profile

Send Message

Posted Sep 8, 2017
In reply to Odica:

Just getting this error today:

2x ...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90178.lua:143: attempt to compare number with boolean
...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90178.lua:143: in function <...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:118>
...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0-90178.lua:2338: in function <...\TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:2337>

Locals:
self = <table> {
GetUniqueZoneNameForLookup = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:234
TransposeZoneCoordinate = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:580
IterateEasternKingdoms = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1097
IsInKalimdor = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1258
GetBestZoneCoordinate = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:695
IterateAlliance = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1019
IterateSanctuaries = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1055
HasRecommendedInstances = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1168
GetInstanceZone = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:864
IsZoneOrInstance = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1195
IterateZoneInstances = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:824
IsInstance = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1172
IterateHostile = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1033
GetInstanceAltGroupSize = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1286
IteratePvPZones = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1005
GetType = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1191
IterateContested = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1069
IterateComplexes = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:991
IsZone = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1177
GetLevelString = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:280
IterateZoneComplexes = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:844
DoesZoneHaveComplexes = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:904
IterateHorde = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1033
GetComplex = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1187
IterateArenas = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:977
GetEnglishZoneFromTexture = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1326
IterateZones = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:935
frame = LibTourist-3.0Frame {
}
GetFishingLevel = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:271
IsComplex = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1205
IterateRecommendedZones = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1160
GetTexture = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1290
IsArena = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:1215
DoesZoneHaveInstances = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist-3.0.lua:900
GetContinent = <function> defined @TitanRecZone\Libs\LibTourist-3.0\LibTourist

Rollback Post to Revision RollBack
Odica
Curse Premium
- Join Date: 3/21/2010
- Posts: 24
- Member Details
#37 Odica

View User Profile

Send Message

Posted Sep 10, 2017
In reply to marblex:

Don't know how you did it but this error seems te come from LibTourist version 178, which is almost three years old.

I suggest you scan your addons folder for other (outdated) copies of LibTourist. Remember, the lib is loaded only once even if there are multiple addons that reference it. It is rather unpredictable which copy of the lib will be loaded so it is important to keep all of them up to date.

Last edited by Odica: Sep 10, 2017

Rollback Post to Revision RollBack
To post a comment, please login or register a new account.