https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AMapGetParentMapAPI:MapGetParentMap - Revision history2026-10-17T14:22:16ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:MapGetParentMap&diff=30599&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:47:09Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Map}}<br />
Returns the map one level above a given map, for example the pairing map that contains a zone.<br />
<br />
<pre><br />
parent = MapGetParentMap(mapLevel, mapNumber)<br />
</pre><br />
<br />
== Arguments ==<br />
;mapLevel : <code>number</code> – Level of the map, a <code>GameDefs.MapLevel</code> value.<br />
;mapNumber : <code>number</code> – Number of the map at that level, for example a zone id for <code>GameDefs.MapLevel.ZONE_MAP</code>.<br />
<br />
== Returns ==<br />
;parent : <code>table</code> – The parent map, or nothing if the map is unknown or has no parent.<br />
<br />
{| class="wikitable"<br />
! Key !! Type !! Meaning<br />
|-<br />
| <code>mapLevel</code> || <code>number</code> || Level of the parent map.<br />
|-<br />
| <code>mapNumber</code> || <code>number</code> || Number of the parent map.<br />
|}<br />
<br />
== Details ==<br />
* If the client's map data is not loaded, the function returns nothing.<br />
* The argument check names the wrong function: if an argument is missing or not a number, the ''Invalid Parameters'' message names <code>MapGetChildMaps</code>.<br />
* The function needs at least two arguments and only reads the last two.<br />
<br />
== Errors ==<br />
None besides the generic ''Invalid Parameters'' message (see Details).<br />
<br />
== Example ==<br />
From <code>default/ea_worldmapwindow/source/worldmapwindow.lua</code>:<br />
<pre><br />
function EA_Window_WorldMap.ZoomOut()<br />
local parentMap = MapGetParentMap(EA_Window_WorldMap.currentLevel, EA_Window_WorldMap.currentMap)<br />
<br />
if (parentMap ~= nil and parentMap.mapLevel ~= nil and parentMap.mapNumber ~= nil) then<br />
EA_Window_WorldMap.SetMap(parentMap.mapLevel, parentMap.mapNumber)<br />
end<br />
end<br />
</pre><br />
<br />
From <code>default/easystem_glyphdisplay/source/glyphdisplay.lua</code>:<br />
<pre><br />
local parentMap = MapGetParentMap( GameDefs.MapLevel.ZONE_MAP, zoneId )<br />
if parentMap ~= nil and parentMap.mapNumber < GameData.ExpansionMapRegion.FIRST and parentMap.mapNumber > 0<br />
then<br />
return true<br />
end<br />
</pre><br />
<br />
== See also ==<br />
* [[API:MapGetChildMaps|MapGetChildMaps]]<br />
* [[API:MapGetPlayerLocationMaps|MapGetPlayerLocationMaps]]<br />
* [[API:MapSetMapView|MapSetMapView]]</div>Maintenance script