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 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'

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

  • Avatar of Bisaz Bisaz Aug 07, 2016 at 15:11 UTC - 0 likes

    Thank you Odica :)

  • Avatar of Odica Odica Aug 02, 2016 at 14:18 UTC - 1 like

    @Bisaz: Go

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

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

    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.




Date created
Jul 20, 2008
Last update
Oct 19, 2016
Development stage
  • enUS
MIT License
Curse link
Reverse relationships
Recent files
  • A: r189 for 7.0.3 Oct 19, 2016
  • A: r188 for 7.0.3 Oct 18, 2016
  • B: Wow-7.0-beta1 for 7.0.3 Oct 01, 2016
  • A: r186 for 7.0.3 Sep 22, 2016
  • A: r185 for 7.0.3 Sep 03, 2016



Embedded library