UESPWiki:ESO Map Design

The ESO map is currently undergoing heavy development and testing. Not all features are currently enabled or working correctly. The below documentation is rough and may be out of date or incorrect.
 

The UESP:Elder Scrolls Online Map is a map similar to the previous UESP game maps but has been custom created from scratch to meet the specific demands of ESO.


Basic Usage
Basic usage of the map is similar in operation to Google maps or comparable map sites:

:* Zooming -- Use the mouse scroll wheel to zoom in and out or use the +/- buttons in the upper right.
:* Panning -- Click and hold the left mouse button to drag the map around or use the arrow buttons in the upper right.
:* Location Info -- Click a location icon, text, or area to display a popup showing more information on that location.
:* Map List -- Click the Map Name at the top of the screen to see a list of all maps. You can use the Group and Alpha buttons at the top of the map list to choose between a map grouped by area or maps sorted alphabetically. You can right-click to return the parent of the current map if it is defined.
:* Teleporting -- Clicking on some locations will teleport you to another map or you can use the Jump to Destination link in the location popup. You can jump to the parent map (if any) by right-clicking anywhere on the map.
:* Searching -- Use the input box on the upper left to search for one or more terms. Matching worlds will be displayed in bold along with any matching locations. Currently up to 100 search results can be displayed. You can also look for types of locations by using type:iconname where iconname matches the name of icon as shown in the map key (ex: type:grocer).

Map Linking
Linking to the map is done in a way similar to the current map. You can use the Link to Current Map at the top of the map page to copy a link that duplicates the current map state. Manual query parameters can also be used as follows:

:* world -- The worldId, name, or displayName.
:* x / y -- The center position of the map in game world coordinates.
:* zoom -- The zoom level to use.

If a parameter is missing the default will be used (usually the center of the map and a zoom of 10). Order parameter doesn't matter. Some basic examples:

     esomap.html?world=100
     esomap.html?world=tamriel
     esomap.html?world=Aldmeri%20Dominion
     esomap.html?world=668&x=452637&y=714111&zoom=10

The full map URL and the shorter version format are identical:

     
     

Missing Features
There are a few notable features missing from the map:

:* Key Shortcuts -- Currently the only way to zoom/pan is using the mouse or control buttons.
:* Permissions -- Only basic permissions are available (can or can't edit).
:* Revisions/Patrols -- Revisions are being stored but there is no interface to view, patrol or revert edits yet.
:* Game Coordinates -- Currently all maps have not been converted to use game coordinates. Any displayed coordinates are for internal purposes only.

Editing
The editing interface is available if you are logged into the UESP wiki in the same browser. You may need to use this link. Edits are handled in a manner similar to the wiki in that revisions and history are stored of all edits.

:* World Edit -- Click the Edit World button on the top of the screen to show the edit form for the current world.
::* Name (Read Only) -- The name used by the game.
::* Enabled -- If set to false the world information will not be available to view.
::* Parent World ID -- The worldId of the parent world, or 0 if none. If this is set then you can Right-Click on the map to teleport to the parent world.
::* Display Name -- World name used for display purposes.
::* Wiki Page -- The wiki article name for the world (do not include the ON namespace).
::* Description -- A longer description of the world.
::* Missing Tile (Read Only) -- Image to use if no map tiles are available.
::* Zoom Min/Max -- The zoom limits for the world.
::* Game Pos -- The game coordinate limits for the world. For ESO maps this is currently set to (0, 1000000)-(1000000, 0) as real game coordinates are not available.
::* Internal ID -- The worldId of the world being edited.
::* Revision -- The current revisionId of the world.
::* Cancel -- If you hit this all changes made will be lost.
::* Save -- Saves the world data.

:* Add Location -- Adds a point location. You will be asked to choose a spot to place the new location before editing it.
::* Name -- The name of the location. Should be short and simple.
::* Enabled -- If you disable a location it will not be visible. WARNING: Currently disabled locations disappear and cannot be edited.
::* Position -- The game position of the location.
::* Wiki Page -- The wiki article name for the location (do not include the ON namespace).
::* Description -- A longer description of the location.
::* Display Level -- The zoom level at which the location will appear. For example a value of 9 will show up for all zoom levels 9 and greater (the zoom level increases as you zoom in).
::* Icon -- The icon to display for the location.
::* Label Position -- The position to use for the label. WARNING: If the location has no icon and no label you won't be able to select it for editing.
::* Destination ID -- Use a positive number for the locationId or a negative number for a worldId, or 0 (for none). For example "-668" would mean teleport to world #668.
::* Internal ID -- The locationId of the current location.
::* World -- The worldId of the current location.
::* Type -- Raw location type (1=point, 2=path or 3=area)
::* Rev -- The current revision of the location.
::* Delete -- Deletes the location. If you delete a new location before saving it it will have never existed. Otherwise the location is just disabled and can be later restored if needed.
::* Cancel -- Ignore any changes made to the location.
::* Save -- Save the location data.

:* Add Path / Add Area -- Adding an path or area are identical in nature as they are just a list of points on a path (one open, one closed). After you create a path/area you will be asked to choose the path nodes by clicking on the world map.
::* Name -- Name of the location (short and simple is good).
::* Enabled -- A disabled location is not visible.
::* Is Area -- Use this to switch between an open path and a closed area. A path ignores the fill settings.
::* Wiki Page -- The wiki article name for the location (do not include the ON namespace).
::* Description -- A longer description of the location.
::* Display Level -- The zoom level at which the location will appear.
::* Icon -- The icon to display for the location.
::* Label Position -- The position to use for the label. Usually a path label works well in the center position.
::* Destination ID -- A locationId to use for a teleport destination, or 0 for none, when a user clicks the path/area.
::* Fill Style -- The style to fill the area as. This can be one of several formats:
:::::* Named Color -- white, blue, black
:::::* Hex Color -- #ffffff, #000000, #ff66aa
:::::* RGBA Color -- rgba(255,255,255,0.1), rgba(128,128,0,1), rgba(0,0,0,0)
::* Stroke Style/Line Width -- The style to use for the path/area edges. See Fill Style above for examples.
::* Hover Styles -- The styles to use when the mouse is hovered over the path.
::* Internal ID -- The locationId of the current location.
::* World -- The worldId of the current location.
::* Type -- Raw location type (1=point, 2=path or 3=area)
::* Rev -- The current revision of the location.
::* Delete -- Deletes the location. If you delete a new location before saving it it will have never existed. Otherwise the location is just disabled and can be later restored if needed.
::* Edit Handles -- Choose this to edit the nodes that make up the path.
:::::* Moving -- Click and drag a path handle to move it (BUG: You currently can't drag it outside of the path area)
:::::* Adding -- Use SHIFT+CLICK to add a new point
:::::* Deleting -- Use CTRL+CLICK to delete a point
::* Cancel -- Ignore any changes made to the location.
::* Save -- Save the location data.

:* Edit Location -- Click a location and select the Edit... link to edit a location. You may also SHIFT+CLICK a location to jump to the edit form (currently only works for paths/areas).

Display Level Standards
In order to maintain consistency across the maps, there are standards on what locations should appear at what zoom levels. The current zoom level can be seen by clicking on the Edit World button, and added locations will default to one level out from the current zoom level.

Zones
:Zoom Min/Max: 7/11
:Zoom Offset: 7
:*7 - Gates to neighboring Zones
:*8 - Wayshrines, Area Maps (for cities, etc.)  (Possibly omit Wayshrines within cities and move them to level 9)
:*9 - POIs (Towns, Forts, Dungeons, Landmarks, Group Bosses, Dolmens, Crypts, Cemeteries, Battlefields, Groves, Ruins, etc.)
:*10 - Skyshards, Lorebooks, Vivec's 36 Lessons, Treasure Maps, Mundus Stones, Quest givers, Unmarked Locations, Crime Pays/Give to the Poor/Lightbringer
:*11 - Quest objectives, World events, Resource nodes, Heavy Sacks, Chests, Thieves Troves, Safeboxes, Vendors, Crafting Stations, Buildings, Eidetic Memory, noteworthy NPCs and creatures (including group bosses)

Cyrodiil
:Zoom Min/Max: 5/11
:Zoom Offset: 5
:*5 - Nothing
:*6 - Border Keeps and Imperial City
:*7 - All Keeps and Outposts
:*8 - POIs (Towns, Forts, Dungeons, Landmarks, Group Bosses, Dolmens, Crypts, Cemeteries, Battlefields, Groves, Ruins, etc.), Mundus Stones
:*9 - Keep Resources (Farms, Lumbermills, Mines), Unmarked Locations, Ayleid Wells
:*10 - Skyshards, Lorebooks, Treasure Maps, Quest givers, Quest objectives
:*11 - Resource nodes, Heavy Sacks, Chests, Vendors, Crafting Stations, Buildings, Eidetic Memory, noteworthy NPCs and creatures (including group bosses)

Cities
:Zoom Min/Max: 7/11
:Zoom Offset: 7
:*7 - Nothing
:*8 - Wayshrines, POIs
:*9 - City Districts, All Services
:*10 - Doors (to buildings without an icon), Skyshards, Lorebooks, Treasure Maps
:*11 - Quest givers, Quest objectives, Resource nodes, Heavy Sacks, Chests, Thieves Troves, Safeboxes, Vendors, Crafting Stations, Eidetic Memory, notable NPCs and creatures

Dungeons
These may be adjusted for larger or smaller dungeons, but it's generally this or add/subtract 1 on all levels as appropriate.
:Zoom Min/Max: 8/11
:Zoom Offset: 8
:*8 - Doors to other levels, exit
:*9 - Skyshards, noteworthy NPCs and creatures (including bosses)
:*10 - Quest givers, Quest objectives, Lorebooks, Eidetic Memory, Resource nodes, Heavy Sacks, Chests, Crafting Stations:

Labels
The following markers should always be labeled on the map:
:* POIs
:* Vendors
:* Notable NPCs and creatures

The following markers should never be labeled on the map (the label will appear instead as a tool-tip):
:* Wayshrines
:* Mundus Stones
:* Containers (Resource nodes, Heavy Sacks, Chests, Thieves Troves, Safeboxes)
:* Crafting Stations
:* Services
:* Buildings
:* World Events

;Unmarked Locations
:Unmarked Locations with no door should be labeled on the map with no icon.
:Unmarked Locations with interiors should be marked on the map with a door icon and no visible label.

;Quest Markers
:Quest givers and quest objectives should have no visible label, should be named after the NPC/item, and should have the name of the quest in the Description.

;Skyshards
:Skyshards should have no visible label, should be named "Skyshard", and should have the location clue entered in the Description.

;Books
:Lorebooks and Eidetic Memory books should have no visible label, should be named according to the name of the book, and should say "Lorebook" or "Eidetic Memory" in the Description, respectively, followed by the Collection name. Use a colon and space to separate these; for example, "Lorebook: Biographies".

Editing Tips
:* Shift+Click -- Use a SHIFT+CLICK on a location to open the edit popup for a location. This may be required on locations that have a destination.
:* Auto-Fill Defaults -- For common location names (e.g., cooking fire, skyshards, etc...) a few defaults will be filled in for a new location after you enter the item name and leave the input box. This lets you add new locations for these types very quickly. If you'd like to add an auto-fill type note it on the discussion page.
:* Wiki Page -- If left blank for new locations the wiki page will simply be set to the location's name.  If there is no wiki page for the location (and one is not likely to be needed), this should be edited and changed back to blank.
:* Hidden/Disabled Locations -- Add the query showhidden=1 to the map in order to display all invisible locations which will be displayed with a red label.

Bugs
Notable known bugs are listed below:

:*  
:*  
:* Slow Performance When Dragging -- The map can be slow/jerky when dragging due to it being in development and not having been optimized yet.
:* '''Disabled Locations Can't be Edited --''' Once a location is disabled it can't be selected again for editing. This is just a limitation in the interface (the location still exists in the database).
:*  Incorrect Map Tiles -- Sometimes the wrong map tile will be displayed, for instance when zooming it multiple levels very quickly. 
:* Missing Tiles -- Sometimes black tiles will be shown even though the corresponding tile image exists. This can be temporarily fixed by zooming in/out.
:*  

Links
:*  -- Live map
:*  -- Alternate link bypassing the Squid cache.
:*  -- Development version of the map (may break frequently).
:*  -- Gamemap source on Google Code.
:*  -- Map development notes.