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 Classic

A version of LibTourist for World of Warcraft Classic is available. See the LibTourist Classic project page.

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.

Update May 7, 2020: a new mechanism to provide fishing skill info has been implemented in the latest alpha version, see release notes.

Comments

DarkLimpan
- Location: Avesta
- Join Date: 1/3/2008
- Posts: 60
- Member Details
#74 DarkLimpan

View User Profile

Send Message

Posted May 29, 2020
Any ideas why the twitch app won't seem to register that I updated this addon (or that it just doesn't update correctly)? The version twitch say I have are the alpha r238 and the latest are 8.3-beta2, and it appears to be the same r238 when I try to download the beta2 version from this page.

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#75 Odica_Jaedenar

View User Profile

Send Message

Posted May 29, 2020
In reply to DarkLimpan:

Hi there,

I am not familiar with the Twitch updater so I am not sure how it compares versions.

But, LibTourist-3.0 is under SVN and when under SVN the way to create a beta release is to tag an existing release (in this case alpha r238) "as beta". So, the files in r238 and 8.3-beta2 are indeed equal. The same file has effectively been released twice, once as alpha and once as beta. In other words: Twitch is right, you already have the latest version.

I will remove r238 from the release list to avoid others from running into the same issue.

Hope this answers your question,

best regards,

Odica

Rollback Post to Revision RollBack
DarkLimpan
- Location: Avesta
- Join Date: 1/3/2008
- Posts: 60
- Member Details
#76 DarkLimpan

View User Profile

Send Message

Posted May 29, 2020
In reply to Odica_Jaedenar:

Hi again.

I just tried to have the twitch updater do it again and when I refresh, it tells me r238-alpha is installed and beta2 is available in the main window. But when I click its page in the app, r238 is gone from the list (as you removed it) and beta2 is not installed. It's like it doesn't register the update or something? It's just going in a loop.

Last edited by DarkLimpan: May 29, 2020

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#77 Odica_Jaedenar

View User Profile

Send Message

Posted May 29, 2020
In reply to DarkLimpan:

Please be aware that LibTourist is not an addon, it's a library that can provide data for other addons. There is no need to install it separately because LibTourist in itself does not add anything to WoW. Instead, it is used by other addons and included in their install packages if required.

The only reason for downloading LibTourist separately, is if you are an addon developer and want to use the functionalities of LibTourist in one of your addons. Even then, there is no need to install LibTourist as an addon, as it is supposed to be used as a part of the source code of the addon you're developing.

In other words: you might as well uninstall it.

An example of an addon that uses LibTourist as data provider is ZoneInfo 2, which requires LibTourist to function. If you install ZoneInfo, the latest version of LibTourist will come along with it.

Hope this helps :-)

Odica

Rollback Post to Revision RollBack
DarkLimpan
- Location: Avesta
- Join Date: 1/3/2008
- Posts: 60
- Member Details
#78 DarkLimpan

View User Profile

Send Message

Posted May 29, 2020
In reply to Odica_Jaedenar:

I understand now. I do have addons that use this lib (iLocation for example), I just didn't know I didn't need to have it installed seperately. XD

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#79 Odica_Jaedenar

View User Profile

Send Message

Posted May 29, 2020
In reply to DarkLimpan:

You're welcome ;-)

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#73 Odica_Jaedenar

View User Profile

Send Message

Posted Sep 20, 2019
Quote from mytwobits >>

Any version of this for Classic floating around yet?

Yes: https://www.wowace.com/projects/libtourist-classic

Rollback Post to Revision RollBack
mytwobits
- Join Date: 10/30/2008
- Posts: 25
- Member Details
#69 mytwobits

View User Profile

Send Message

Posted Aug 30, 2019
Any version of this for Classic floating around yet?

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#70 Odica_Jaedenar

View User Profile

Send Message

Posted Aug 30, 2019
In reply to mytwobits:

Not yet but we're working on it.

Rollback Post to Revision RollBack
mytwobits
- Join Date: 10/30/2008
- Posts: 25
- Member Details
#71 mytwobits

View User Profile

Send Message

Posted Aug 30, 2019
In reply to Odica_Jaedenar:

I have not messed with addons/lua in a few years. Did the api for IterateRecommendedInstantces/Zones change at all since 6.0?

Was taking a quick stab at adding back in fishing and changing the zone levels, but the basic display seems to also no longer work.

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#72 Odica_Jaedenar

View User Profile

Send Message

Posted Aug 31, 2019
In reply to mytwobits:

Hi, I have tested IterateRecommendedZones and IterateRecommendedInstances and both still work. The API didn't change since 6.0 but the behavior has changed because zone levels are now scaled (within certain ranges). Therefore, the function now returns the names of the zones that scale exactly to the player's current level.

I am not sure what you mean by 'basic display'. Are you referring to an addon that uses LibTourist as a library?

Last edited by Odica_Jaedenar: Aug 31, 2019

Rollback Post to Revision RollBack
Holobit
- Join Date: 8/12/2018
- Posts: 2
- Member Details
#65 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_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#66 Odica_Jaedenar

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_Jaedenar: Aug 12, 2018

Rollback Post to Revision RollBack
Holobit
- Join Date: 8/12/2018
- Posts: 2
- Member Details
#67 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_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#68 Odica_Jaedenar

View User Profile

Send Message

Posted Aug 13, 2018
In reply to Holobit:

Never too old to learn ;-)

Rollback Post to Revision RollBack
Air10000
- Join Date: 3/5/2007
- Posts: 93
- Member Details
#61 Air10000

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_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#62 Odica_Jaedenar

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
Air10000
- Join Date: 3/5/2007
- Posts: 93
- Member Details
#63 Air10000

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_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#64 Odica_Jaedenar

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_Jaedenar: Aug 3, 2018

Rollback Post to Revision RollBack
Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 72
- Member Details
#58 Odica_Jaedenar

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_Jaedenar: Jul 23, 2018

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