https://wiki.returnofreckoning.com/index.php?action=history&feed=atom&title=API%3AMapGetPlayerLocationMapsAPI:MapGetPlayerLocationMaps - Revision history2026-10-18T09:33:29ZRevision history for this page on the wikiMediaWiki 1.43.11https://wiki.returnofreckoning.com/index.php?title=API:MapGetPlayerLocationMaps&diff=30600&oldid=prevMaintenance script: UI Lua API import (WAR 1.4.8)2026-10-16T19:47:10Z<p>UI Lua API import (WAR 1.4.8)</p>
<p><b>New page</b></p><div>{{LuaApi|group=Map}}<br />
Returns the maps that contain the player's current position, one per map level.<br />
<br />
<pre><br />
maps = MapGetPlayerLocationMaps()<br />
</pre><br />
<br />
== Arguments ==<br />
None.<br />
<br />
== Returns ==<br />
;maps : <code>table</code> – Map numbers keyed by map level. Levels for which no map is found are missing.<br />
<br />
{| class="wikitable"<br />
! Key !! Type !! Meaning<br />
|-<br />
| <code>0</code> || <code>number</code> || World map: always <code>1</code>.<br />
|-<br />
| <code>1</code> || <code>number</code> || Pairing map: the pairing of the current zone (as from [[API:GetZonePairing|GetZonePairing]]). Missing if the zone has no pairing.<br />
|-<br />
| <code>2</code> || <code>number</code> || Zone map: the current zone id. Missing if the player has no zone.<br />
|-<br />
| <code>3</code> || <code>number</code> || Area map: the first area map in the client's map data that matches the player's location. Its number is the zone id × 1000 plus a sub-id. Missing if there is none.<br />
|}<br />
<br />
== Details ==<br />
* The keys are map levels; the stock UI indexes the table with <code>GameDefs.MapLevel</code> values (<code>WORLD_MAP</code>, <code>PAIRING_MAP</code>, <code>ZONE_MAP</code>, <code>AREA_MAP</code>).<br />
* Key 0 is not reached by <code>ipairs</code>. Index the table directly.<br />
* If the player or the client's map data is not available, an empty table is returned.<br />
<br />
== Errors ==<br />
None.<br />
<br />
== Example ==<br />
From <code>default/ea_worldmapwindow/source/worldmapwindow.lua</code>:<br />
<pre><br />
function EA_Window_WorldMap.ZoomIn()<br />
-- We're zooming to the child map which we're in.<br />
local playerMaps = MapGetPlayerLocationMaps()<br />
local newZoom = EA_Window_WorldMap.currentLevel+1<br />
<br />
if (newZoom <= GameDefs.MapLevel.ZONE_MAP and playerMaps[newZoom] ~= nil) then<br />
EA_Window_WorldMap.SetMap(newZoom, playerMaps[newZoom])<br />
end<br />
end<br />
</pre><br />
<br />
== See also ==<br />
* [[API:MapGetParentMap|MapGetParentMap]]<br />
* [[API:MapGetChildMaps|MapGetChildMaps]]<br />
* [[API:GetZonePairing|GetZonePairing]]</div>Maintenance script