Navigation menu
Personal tools
Not logged in
Talk
Contributions
Create account
Log in
Namespaces
WoW
Talk
English
Views
Read
Edit
History
More
Search
Navigation
Home
Random page
Help using wiki
Editions
for WoW
for WildStar
for Solar2D
Documentation
for WoW
for WildStar
Reference
WoW
⦁ FrameXML
⦁ AddOns
⦁ API
⦁ WoW Lua
WildStar
⦁ AddOns
⦁ API
⦁ WildStar Lua
Engine
Tools
What links here
Related changes
Special pages
Page information
Site
Recent Changes
Editing
WoW:API GetInstanceInfo
Jump to navigation
Jump to search
Warning:
You are not logged in. Your IP address will be publicly visible if you make any edits. If you
log in
or
create an account
, your edits will be attributed to your username, along with other benefits.
Anti-spam check. Do
not
fill this in!
{{wowapi}} __NOTOC__ Returns information about the current instances the player is in. name, type, difficultyIndex, difficultyName, maxPlayers, dynamicDifficulty, isDynamic, instanceMapId, lfgID = GetInstanceInfo() == Returns == # name (string) - the name of the instance (localized), otherwise the continent name (eg: Eastern Kingdoms, Kalimdor, Northrend, Outland) # type (string) - "none" if the player is not in an instance, "party" if in party, "raid" if in a raid, "pvp" for battlegrounds, "arena" for arenas. Many of following result values will be nil or otherwise useless in the case of "none". # difficultyIndex (number) - the difficulty of the instance (see Details) # difficultyName (string) - the difficulty of the instance ("10 Player", "25 Player (Heroic)", etc) # maxPlayers (number) - maximum number of players permitted inside # dynamicDifficulty (number) - For dynamic instances: 0=Normal 1=Heroic # isDynamic (Boolean) - If the instance difficulty can be changed while zoned in # instanceMapID (number) - [[InstanceMapID]] for the instance. not the same as [[MapID]]. # lfgID (number) == Details == == Notes == * difficultyIndex "difficulty level" is the difficulty mode like 10 / 25 player and described in [[API_GetInstanceDifficulty|GetInstanceDifficulty()]] * Is isDynamic is only useful in places like Icecrown Citadel where the difficulty mode can be changed on the fly. * mapID allows absolute identification of current instance without using localized names or other more complex means. == Patches == * Added in 3.2, additional return values added in 3.3 * In dynamic instances, difficultyIndex will only be 1 for 10man, or 2 25man. * In 5.0.4 dynamicDifficulty and difficultyIndex have changed. difficultyIndex is now used to determine a dynamic instance like heroic as well as 10 / 25 modes. dynamicDifficulty returns 0. * With 5.0.4 continents are considered 'instances', so when not inside an instance you are in a continent 'instance'. * mapID added in [[Patch 5.0.4]]
Summary:
Please note that all contributions to AddOn Studio are considered to be released under the Creative Commons Attribution-NonCommercial-ShareAlike (see
AddOn Studio Wiki:Copyrights
for details).
Submissions must be written by you, or copied from a public domain or similar free resource (see
AddOn Studio Wiki:Copyrights
for details).
Cancel
Editing help
(opens in new window)
Templates used on this page:
Template:Apinav
(
edit
)
Template:Editlink
(
edit
)
Template:Tocright
(
edit
)
Template:Wowapi
(
edit
)