UESPWiki:ESO Map Design

Note: 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 UsageEdit

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 LinkingEdit

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:

    http://esomap.uesp.net/esomap.html?world=100
    http://esomap.uesp.net/?world=100

Missing FeaturesEdit

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.

EditingEdit

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. [See additional notes below specific to Quest Markers, under Labels]

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 (add "Online:" (without quotes) at the beginning if the name of the wiki page includes a colon, or the link won't work).
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 StandardsEdit

In order to maintain consistency across the maps, these are the standards on what locations should appear at each display ("zoom") level. The current zoom level can be determined by clicking on the Edit World button. Newly created map links will default to one display level number higher than the current zoom level; be sure to adjust the zoom for your added map link appropriately.

When adding something to the map, take care that items do not overlap. Overlap causes lag when anyone uses the map to look at that location. Before or after placing the new link you're creating, zoom in to the level it displays at, and verify nothing overlaps. If it does, open the item that needs to be moved on the map, use the "Set Pos" button to pick a new spot for it, then save it.

Here are the categories: Area Maps. City Districts. Collections and Achievements. Containers. Crafting and Commerce. Creatures. Marked Locations (fixed and spawned). Quests. Regions and Sub-Zones. Transport. Unmarked Locations (fixed and spawned). Cyrodiil also has some special items (Border Keeps, Imperial City, Keep Resources, and Keeps and Outposts). Dungeons also have an optional category (Ancillary Items).

If a map icon is used for Marked Locations on a Zone-level map (points of interest, striking locales, etc.), avoid using that icon for Unmarked Locations on a Zone-level map, as this can be misleading for the end user (players) trying to interpret what they see on the Zone map, and could make them think that icon is supposed to appear on the map in-game. Try another icon that most closely resembles the point on the map you're marking, or use the "X" icon (miscellaneous). If you believe a new icon is needed, start a conversation about it on the discussion tab of this page, or in the wiki maps channel in the UESP Discord.

ZonesEdit

Zoom Min/Max: 7/11

Zoom Offset: 7

7 - Transport: exits to other Zones other than wayshrines (border crossings, boats, carts, portals, travel NPCs).
- Note: Over area maps (see below), use a single map link with "Travel NPC" icon to represent a dense cluster of travel options, such as for several boats or caravan carts close together.
8 - Area Maps: cities and similar locations that need an area-sized map link. Regions and Sub-Zones: labels for (and links to) high-level subdivisions of Zones, but not including their border lines (see level 11). Transport: wayshrines.
- Note: If a wayshrine inside a city area map is obstructing the city icon on the Zone map, either move the wayshrine to display level 9 or adjust the city icon location.
- Note: The only map link icons that should be placed within the border of an area map at Zone level are: area map icon, wayshrines, marked locations (dungeons, player homes), event exchanges/festival event kiosks, treasure maps, and a single map link with "Travel NPC" icon if there are travel services to other Zones inside that area.
9 - Marked Locations: points of interest, striking locales, player homes, battlefields, cemeteries, crafting set sites, crypts, dolmens, dungeons (incl. delves, etc.), Dwemer lifts, forts, group/"world" bosses, groves, landmarks, ruins, towns, etc.
10 - Collections and Achievements: exploration achievements (Crime Pays, etc.), lorebooks, Mundus stones, museum pieces, skyshards, treasure maps (incl. Glenmoril Wyrd), Vivec's 36 Lessons Crafting and Commerce: services that are out in a Zone instead of a city (event exchanges/the Impresario, festival events, guild kiosks, Undaunted enclaves). Creatures: Dragons. Quests: quest givers (ordinary, story, and repeatable/"daily"). Transport: local transport services (i.e. the Caravaners of Vvardenfell). Unmarked Locations (Fixed): Ayleid ruins and wells, cave entrances, doors (to buildings without an icon), hidden paths, mines, shrines. Unmarked Locations (Spawned): wandering group/"world" bosses (e.g. Deadlands and Galen).
11 - Collections and Achievements: Eidetic Memory books and notes. Containers: chests, heavy sacks, Psijic portals, safeboxes, thieves troves. Crafting and Commerce: crafting stations, traveling merchants and their paths, vendors. Creatures: notable NPCs. Quests: quest objectives (ordinary, story, and repeatable/"daily"). Regions and Sub-Zones: border lines delineating high-level subdivisions of Zones. Transport: for when there is a dense cluster of out-of-Zone travel options near a display-level-7 map link. Unmarked Locations (Spawned): encounters (bandit ambushes, celestial rifts, dark fissures, etc.), world events other than dark anchors and dragonscours.
- Note: For quests, avoid placing a map link for every time a quest stage says simply "Talk to NPC."

CyrodiilEdit

Zoom Min/Max: 5/11

Zoom Offset: 5

5 - Nothing
6 - Border Keeps. Imperial City.
7 - Keeps and Outposts and their transitus lines. Regions and Sub-Zones.
8 - Marked Locations: points of interest, striking locales, player homes, battlefields, cemeteries, crafting set stations, crypts, delves, dolmens, dungeons, Dwemer lifts, forts, group/"world" bosses, groves, landmarks, ruins, towns, etc.
9 - Keep Resources: farms, lumber mills, mines. Unmarked Locations (Fixed): Ayleid ruins and wells, cave entrances, doors (to buildings without an icon), hidden paths, mines, shrines. Unmarked Locations (Spawned): artifact spawns.
10 - Collections and Achievements: lorebooks, Mundus stones, museum pieces, skyshards, treasure maps. Quests: quest givers, quest objectives.
11 - Collections and Achievements: Eidetic Memory books and notes. Containers: chests, heavy sacks. Crafting and Commerce: crafting stations, harvesting nodes, vendors. Creatures: notable NPCs. Transport: travel NPCs.

Cities (and other exterior area maps)Edit

Zoom Min/Max: 7/11

Zoom Offset: 7

7 - Transport: exits to other Zones other than wayshrines (border crossings, boats, carts, portals, travel NPCs).
- Note: If there is a dense cluster of travel options (several boats or caravan carts close together), use a single City District map link icon ("Dock"/"Navigator" anchor, "Caravan" cart) here at display level 7; then see note under display level 10.
8 - Marked locations: points of interest, striking locales, player homes, cemeteries, crypts, dungeons, groves, landmarks, ruins, etc. Transport: wayshrines.
9 - City Districts: docks, marketplaces. Crafting and Commerce: services (banks, stables, guild buildings, inns, outlaws refuges, Tales of Tribute clubs, etc.), event exchanges, festival events.
- Note: For city districts related to travel, see note above under transport at display level 7.
10 - Collections and Achievements: exploration achievements (Crime Pays, etc.), lorebooks, museum pieces, skyshards, treasure maps, Vivec's 36 Lessons. Transport: travel NPCs. Unmarked Locations (Fixed): cave entrances, doors (to buildings without an icon), hidden paths, shrines.
- Note: For each travel option inside the city, use a single map link with "Travel NPC" icon to represent each travel NPC (an NPC who offers you travel to one or more destinations) or travel option, such as a boat or a cart or a portal.
11 - Collections and Achievements: Eidetic Memory books and notes. Containers: chests, heavy sacks, Psijic portals, safeboxes, thieves troves. Crafting and Commerce: crafting stations, harvesting nodes, vendors. Creatures: notable NPCs. Quests: quest givers, quest objectives. Unmarked Locations (Spawned): encounters (bandit ambushes, celestial rifts, dark fissures, etc.)

Dungeons (and other interiors)Edit

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 - Transport: exits to other levels or out-of-Zone (doors, stairs, wayshrines).
9 - Collections and Achievements: skyshards. Crafting and Commerce: services (banks, crafting areas, fences). Creatures: bosses, notable NPCs.
10 - Collections and Achievements: exploration achievements (Crime Pays, etc.), lorebooks, Eidetic Memory books and notes, museum pieces. Containers: chests, heavy sacks, Psijic portals, safeboxes, thieves troves. Crafting and Commerce: crafting stations, vendors. Quests: quest givers, quest objectives. Transport: travel NPCs. Unmarked Locations (Fixed): area/room names, Ayleid wells, cave entrances, doors (including one-way doors), hidden paths, mines, respawn wayshrines, shrines.
11 - (Optional) Ancillary Items: Elite- or Champion-level enemies ("dangerous foes," but not bosses), traps, interesting or unusual items or locations, minor NPCs with meaningful dialogue, crafting harvesting nodes, unmarked locations (spawned).

LabelsEdit

The following map links should always be labeled on the map:

Area Maps: all.
City Districts: none.
Collections and Achievements: none; see additional notes below, on books and on skyshards.
Containers: none.
Crafting and Commerce: individual vendors only (no crafting stations, no services like banks, stables, etc.)
Creatures: notable NPCs and creatures only (such as M'aiq the Liar, dungeon bosses, etc.)
Marked Locations (Fixed): all except Mundus stones and player homes.
Marked Locations (Spawned): none.
Quests: none; see note below.
Regions and Sub-Zones: all.
Transport: none (not even border crossings or travel NPCs).
Unmarked Locations (Fixed): see note below.
Unmarked Locations (Spawned): none.
Cyrodiil Border Keeps, Imperial City, Keep Resources, and Keeps and Outposts: all.
Dungeon Ancillary Items: none.

Those that are not labeled will have their "Label Position" set to "None (0)" when editing the map link; this will allow the "Name" entry to appear instead as a pop-up tool tip.

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".

Quest Markers: Quest givers and quest objectives should have no visible label. Here are samples of the key map link editing items for a quest giver and a quest objective:

Name: Aamela Rethandus [the name of the NPC/item giving the quest]
Wiki Page: Aamela Rethandus [if she had no wiki page of her own, leave this blank]
Description: Supply Run <br> (upstairs at the Inn) [the name of the quest, involving this NPC/item, at this location, with optional line break to display helpful info]
Display Level: [see display level standards above]
Icon Type: Quest Start [this is because Supply Run is a normal quest; if it were a main ("Zone") quest, then use Quest Start Main icon]
Label Position: None

Name: Rescue the Woman [the name of the quest objective]
Wiki Page: Orara Arthalen [in this case, "the woman" has a wiki page; otherwise, if the quest objective has no wiki page of its own, leave this blank]
Description: Rescue and Revenge [the name of the quest, involving this quest objective, at this location]
Display Level: [see display level standards above]
Icon Type: Quest [or Quest Small if the map icons are dense in this location] [there is also a Quest Story / Quest Small Main if the quest were a main/Zone quest]
Label Position: None

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

Unmarked Locations (Fixed): 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.

Editing TipsEdit

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.

BugsEdit

Notable known bugs are listed below:

Double-Select in Map List -- You can sometimes see more than one selection in the grouped map list.
Path Dragging Outside of Area -- You can't drag path handles outside of the path box. You can get around this by temporarily adding path points to expand the path box.
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.
Daggerfall Alliance Map Not Working -- Nothing shows on the Daggerfall Alliance map (issue with displayName set in db).

LinksEdit

http://esomap.uesp.net -- Live map
http://content1.uesp.net/esomap/esomap.html -- Alternate link bypassing the Squid cache.
http://content3.uesp.net/esomap/esomap.html -- Development version of the map (may break frequently).
https://code.google.com/p/uesp/source/browse/?repo=gamemap -- Gamemap source on Google Code.
User:Daveh/Editable_Map_Notes -- Map development notes.

UESPWiki β