Usage sample

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 all 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.


You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of Bisaz Bisaz Jul 18, 2016 at 18:40 UTC - 0 likes

    Nice to read, thank you Odica :)

  • Avatar of Odica Odica Jul 18, 2016 at 17:03 UTC - 0 likes

    @Bisaz: Go

    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... ;-)

  • Avatar of Bisaz Bisaz Jul 18, 2016 at 16:27 UTC - 1 like

    Can't wait to see this lib for Legion :)

  • Avatar of Odica Odica Nov 10, 2014 at 16:37 UTC - 0 likes

    @burny_dd: Go

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

  • Avatar of burny_dd burny_dd Nov 09, 2014 at 03:03 UTC - 0 likes

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

    The first rule of Tautology Club is the first rule of Tautology Club.

  • Avatar of Odica Odica Nov 28, 2012 at 22:01 UTC - 0 likes

    @twobits: Go

    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! ;-)


    Last edited Nov 28, 2012 by Odica
  • Avatar of twobits twobits Nov 28, 2012 at 07:00 UTC - 0 likes

    @Odica: Go

    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?


    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 Nov 28, 2012 by twobits
  • Avatar of Odica Odica Nov 21, 2012 at 20:36 UTC - 0 likes

    @alsuko: Go

    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.



  • Avatar of Odica Odica Nov 21, 2012 at 20:27 UTC - 0 likes

    @twobits: Go

    Hi Twobits,

    I don't quite understand how battlegrounds can be recommended, as they have level brackets which make them accessible for all player levels that meet the minimum level requirement for the BG. Furthermore, the max level is not set to 85 but to MAX_PLAYER_LEVEL, which is supplied by WoW (currently 90).


  • Avatar of alsuko alsuko Nov 19, 2012 at 09:49 UTC - 0 likes

    I use elvui location +, it use your library. I see a mistake for the townlong steppes for the level of this zone. It must be to appear 89-90.

    Thank you (i'm frensh)


Date created
Jul 20, 2008
Last update
Jul 17, 2015
Development stage
  • enUS
MIT License
Curse link
Reverse relationships
Recent files
  • A: r181 for 6.2.0 Jul 17, 2015
  • A: r180 for 6.1.0 Feb 25, 2015
  • R: WoW-6.0-release1 for 6.0.3 Dec 16, 2014
  • A: r178 for 6.0.3 Dec 16, 2014
  • A: r177 for 6.0.3 Dec 10, 2014



Embedded library