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, location and connections with other zones, as well as instance group sizes, instance entrance portal coordinates, battle pet level ranges and required fishing skills, if applicable.

Color-coding for level ranges and zone names is available.

Relationships between zones can be provided, i.e. which instances are located in a specific complex, and in which zone resides the complex, vice versa.

The library contains information about known cross-zone transports: zeppelins, boats, portals etcetera. It can also be used for distance calculations between coordinates.

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

LibTourist supports localization.

See the API Reference page for detailed information.

__________________

A few notes about the fishing skills in LibTourist:

- All fishing skills are now set to the skill required to fish 100% junk-free. If your skill, including the effect of lures and other enhancements, is below that, you will catch a certain percentage of junk, which can be up to 100%.

- These values are valid for open water, because fishing pools requires skill 1 since WoW patch 3.3.0, regardless of the zone they're in.

- If multiple values apply for a zone, generally the lowest is used. For example, for Northern Stranglethorn a higher skill is required to fish the South Seas (300) compared to other waters (150), so it's value in LibTourist is set to 150.

- Zones that have a fishing skill of 1, allow fishing in lava or acid only. Don't expect to catch anything useful here, except for an incidental Elemental Fire from lava.

- Zones without a fishing skill should contain no fishable water.

- Fishing in Draenor works differently. Depending on your skill you will catch Small, 'normal' or Enormous fish. For all Draenor zones the fishing skill is set to 950, which is the skill required to catch nothing but Enormous Fish.

- Currently it is assumed the mechanism used in Draenor also applies to the zones on the Broken Isles continent (WoW Legion).

Source: El's Extreme Anglin'

Comments

marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 55
- 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: 17
- 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: 55
- 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: 17
- 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: 55
- 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: 17
- 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: 55
- 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: 55
- 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: 17
- 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
marblex
- Location: L.A.
- Join Date: 1/10/2008
- Posts: 55
- Member Details
#38 marblex

View User Profile

Send Message

Posted Sep 11, 2017
In reply to Odica:

so far only found fishing ace that uses it, but i don't load it with every toon. Nevertheless, I updated the Lib.Tourist addon :D TY SO much :)

Rollback Post to Revision RollBack
Bisaz
- Join Date: 5/21/2005
- Posts: 4
- Member Details
#28 Bisaz

View User Profile

Send Message

Posted Aug 7, 2016
Thank you Odica :)

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

View User Profile

Send Message

Posted Aug 2, 2016
@Bisaz

An alpha version has been released which will hopefully satisfy your needs ;-)

Rollback Post to Revision RollBack
Bisaz
- Join Date: 5/21/2005
- Posts: 4
- Member Details
#26 Bisaz

View User Profile

Send Message

Posted Jul 18, 2016
Nice to read, thank you Odica :)

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

View User Profile

Send Message

Posted Jul 18, 2016
@Bisaz

I am currently in the middle of moving to the other side of my country, but I still maintain the lib and will release an update as soon as I can. Please be a bit patient, though, it will take some time... ;-)

Rollback Post to Revision RollBack
Bisaz
- Join Date: 5/21/2005
- Posts: 4
- Member Details
#24 Bisaz

View User Profile

Send Message

Posted Jul 18, 2016
Can't wait to see this lib for Legion :)

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

View User Profile

Send Message

Posted Nov 10, 2014
@burny_dd

You are right, I will add it to the next release. Thanks for the reminder :-)

Rollback Post to Revision RollBack
burny_dd
Curse Premium
- Join Date: 8/11/2009
- Posts: 5
- Member Details
#22 burny_dd

View User Profile

Send Message

Posted Nov 8, 2014
It seems to me that Siege of Orgrimmar instance is missing in the lib. Or am I mistaken?

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

View User Profile

Send Message

Posted Nov 28, 2012
@twobits

Hm... I have no clue why this was originally built this way. If you meet the required minimum level, you can enter a BG, all the way up to the game level cap, as far as I know. No idea what the fmod construction is for, so I removed it and replaced it with a straight-forward low/high-check :-) Also, I have upped the high value for all BG's to 90 to make that check work for players above 85.

See r156...

Would you be so kind to check if this results in the expected behaviour? Thanks! ;-)

Odica

Last edited by Odica: Nov 28, 2012

Rollback Post to Revision RollBack
twobits
- Join Date: 10/30/2008
- Posts: 5
- Member Details
#20 twobits

View User Profile

Send Message

Posted Nov 28, 2012
@Odica

Ah, well that may explain why the IterateRecommendedInstances no longer works as they used to for BGs.
It used to be if you had a character that was the right level for say, WSG and AB you would get these returned and no other BGs. At max level you would get all of them. I no longer am seeing recommended BGs on low level characters. I was proposing that instead of fixing RecommendedInstances a new RecommendedBGs that behaves like it used to , but just for BGs be added.

I have and was looking at Wow-5.0-beta2 of LibTourist. I see code like

zones[BZ["Warsong Gulch"]] = { low = 10, high = 85, continent = Kalimdor, paths = isHorde and BZ["Northern Barrens"] or BZ["Ashenvale"], groupSize = 10, type = "Battleground", texture = "WarsongGulch",

and for other BGS that seem to set the high to 85., so the high is being set to only 85, then just ignored in the code it seems?

Also,

if playerLevel >= low and (playerLevel == MAX_PLAYER_LEVEL or math.fmod(playerLevel, 10) >= 6) then

seem to be an attempt to only recommend BGs when you are x6-x9, but that is not accurate for the current brackets as it misses recommending x4
Last edited by twobits: Nov 28, 2012

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

View User Profile

Send Message

Posted Nov 21, 2012
@alsuko

Hi Alsuko,

I have compared the Pandaria zone levels to what the game itself suggests. Turns out that 88-89 for Towlong Steppes is correct.

However, 87-88 for Dread Wastes is incorrect, this should be 89-90. It will be corrected in the next release of LibTourist.

Thanks!

Odica

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