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 being developed and a beta version has been released. See the LibTourist Classic 1.0 project page:

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

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.

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

Odica_Jaedenar
Curse Premium
- Join Date: 3/21/2010
- Posts: 52
- 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: 52
- 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: 52
- 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: 52
- 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: 52
- 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: 90
- 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: 52
- 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: 90
- 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: 52
- 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: 52
- 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
jgunntamu
- Join Date: 9/30/2008
- Posts: 1
- Member Details
#59 jgunntamu

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

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

themainliner

Location: London
Join Date: 5/30/2008
Posts: 2
Member Details

#57 Posted Nov 30, 2017

Thanks for your time and effort!

Date: 2017-11-30 14:33:22
ID: 1
Error occured in: Global
Count: 1
Message: ...ns\FishingAce\Libs\LibTourist-3.0\LibTourist-3.0.lua line 143:
   attempt to compare number with boolean
Debug:
   [C]: ?
   ...ns\FishingAce\Libs\LibTourist-3.0\LibTourist-3.0.lua:143:
      ...ns\FishingAce\Libs\LibTourist-3.0\LibTourist-3.0.lua:118
   ...ns\FishingAce\Libs\LibTourist-3.0\LibTourist-3.0.lua:2338:
      ...ns\FishingAce\Libs\LibTourist-3.0\LibTourist-3.0.lua:2337
Locals:

AddOns:
  Swatter, v7.5.5724 (TasmanianThylacine)
  AskMrRobot, v55
  AucAdvanced, v7.5.5724 (TasmanianThylacine)
  AucFilterBasic, v7.5.5724 (TasmanianThylacine)
  AucFilterOutlier, v7.5.5724.5459(7.5/embedded)
  AucMatchUndercut, v7.5.5724.5585(7.5/embedded)
  AucStatHistogram, v7.5.5724 (TasmanianThylacine)
  AucStatiLevel, v7.5.5724 (TasmanianThylacine)
  AucStatPurchased, v7.5.5724 (TasmanianThylacine)
  AucStatSales, v7.5.5724.5598(7.5/embedded)
  AucStatSimple, v7.5.5724 (TasmanianThylacine)
  AucStatStdDev, v7.5.5724 (TasmanianThylacine)
  AucStatWOWEcon, v7.5.5724.5613(7.5/embedded)
  AucUtilAHWindowControl, v7.5.5724.5575(7.5/embedded)
  AucUtilAppraiser, v7.5.5724.5719(7.5/embedded)
  AucUtilAskPrice, v7.5.5724.5599(7.5/embedded)
  AucUtilAutoMagic, v7.5.5724.5686(7.5/embedded)
  AucUtilCompactUI, v7.5.5724.5715(7.5/embedded)
  AucUtilEasyBuyout, v7.5.5724.5576(7.5/embedded)
  AucUtilFixAH, v7.5.5724 (TasmanianThylacine)
  AucUtilItemSuggest, v7.5.5724.5651(7.5/embedded)
  AucUtilPriceLevel, v7.5.5724.5633(7.5/embedded)
  AucUtilScanButton, v7.5.5724.5631(7.5/embedded)
  AucUtilScanFinish, v7.5.5724.5720(7.5/embedded)
  AucUtilScanProgress, v7.5.5724.4979(7.5/embedded)
  AucUtilScanStart, v7.5.5724.5347(7.5/embedded)
  AucUtilSearchUI, v7.5.5724.5721(7.5/embedded)
  AucUtilSimpleAuction, v7.5.5724.5705(7.5/embedded)
  AucUtilVendMarkup, v7.5.5724.4828(7.5/embedded)
  Babylonian, v5.1.DEV.332(/embedded)
  Bartender4, v4.7.10
  BeanCounter, v7.5.5724 (TasmanianThylacine)
  BrokerEverything, v2.22.2-release
  BrokerKeystones, v7.3-11
  ChocolateBar, vv3.0.5
  Configator, v5.1.DEV.431(/embedded)
  DBMCore, v7.3.7
  DBMDefaultSkin, v
  DBMStatusBarTimers, v
  DBMVPVEM, v7.3.3
  DebugLib, v5.1.DEV.337(/embedded)
  Decursive, v2.7.5.7
  Enchantrix, v7.5.5724 (TasmanianThylacine)
  EnchantrixBarker, v7.5.5724 (TasmanianThylacine)
  FishingAce, v0.8.5
  GTFO, v4.43.7
  Hekili, vc433c96
  HereBeDragons10, v1.19-release
  HideRaidFrame, vv1.9
  Informant, v7.5.5724 (TasmanianThylacine)
  LibExtraTip, v5.12.DEV.430(/embedded)
  OmniCC, v7.3
  PetTracker, v7.3.0
  PetTrackerBreeds, v7.3.0
  PetTrackerSwitcher, v7.3.0
  PetTrackerUpgrades, v7.3.0
  Postal, vv3.5.8
  Quartz, v3.3.6
  QuartzProcs, v3.49
  Skada, v1.7.2
  Stubby, v7.5.5724 (TasmanianThylacine)
  TipHelper, v5.12.DEV.405(/embedded)
  TomTom, vv70300-1.0.0
  WhichBossesAreLeft, vv3.2
  WorldQuestsList, v48
  ZPerl, v5.4.6
  ZPerlArcaneBar, v
  ZPerlParty, v
  ZPerlPartyPet, v
  ZPerlPlayer, v
  ZPerlPlayerBuffs, v
  ZPerlPlayerPet, v
  ZPerlRaidAdmin, v
  ZPerlRaidFrames, v
  ZPerlRaidHelper, v
  ZPerlRaidPets, v
  ZPerlTarget, v
  ZPerlTargetTarget, v
  BlizRuntimeLib_enUS v7.3.2.70300 <none>
  (ck=a85)

Last edited by themainliner: Nov 30, 2017

_ForgeUser428762
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#47 _ForgeUser428762

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

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
_ForgeUser428762
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 54
- Member Details
#49 _ForgeUser428762

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 _ForgeUser428762: Sep 3, 2017

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