# WoW Forever Map: guide for agents

https://foreverwowmap.com is a world map for **World of Warcraft: Forever**. Everything it shows (map, view, route, annotations, layers, dungeon marks, pins) is in the link, so your job is almost always the same: **write a link that shows what the user asked for, check it, and give it to them.** The site is static: there is no server API.

## Forever, not Classic or Retail

- WoW Forever (Blizzard, 2026) is also called **WoW Classic Plus** or **Classic+**. It is a modified Classic: new zones (Zephras Isle, Mount Hyjal, Shen'dralas, Darkspear Islands), new dungeons, and changed quests, NPCs and spawns.
- **Look for Forever data first** ([sources below](#finding-coordinates)).
- **Fall back to Classic** (Classic Era, 1.15) only when there is nothing for Forever, and tell the user which points come from Classic and may be different in Forever.
- **Never use Retail** (the current game). Zones were remade in Cataclysm, so its coordinates, quests and dungeon maps don't match.

## Pick your path

All three paths make the same link. Pick the first one you can do.

| You can | Do this | Check it with |
|---|---|---|
| Run code **and** drive a browser | Open the map and build the result with the JavaScript API `window.forevermap` (or its WebMCP tools). Hand the user `getShareUrl()`. | `?agent=1` debug view: a coordinate grid and numbered pins to screenshot, plus `getState()`. Reference: **[API.md](https://foreverwowmap.com/API.md)** |
| Run code, **no browser** | Write the link by hand from the [link format](#link-format) below. | `uv run https://foreverwowmap.com/preview.py "<link>" -o map.png` renders it to a PNG and prints what the page read. Guide: **[NO-BROWSER.md](https://foreverwowmap.com/NO-BROWSER.md)** |
| Neither | Write the link by hand. | Give the user the link and say what they should see (the pins in order and where they are), so they can tell you what to fix. |

## Before you plan a route

- **Ask the user's faction** (Alliance or Horde) if you don't know it. The two have different flight masters, zeppelins and boats, towns and quest hubs. Put it in the link (`&f=horde`) so the map shows only their side.
- **Ask which flight paths they have unlocked.** A flight to a flight master they haven't visited isn't possible yet: walk that leg instead (or fly to the nearest one they have, then walk).
- **Plan every leg yourself; don't hand "A to B" to the auto-router.** It finds the shortest walk over the terrain, and knows nothing else about the game. For each leg, work out the points a player has to pass through (a city gate, a lift, a bridge, a pass, a cave mouth, a road the map doesn't know, the way round a dangerous area) and put a route pin at each: A → route pin → B. [How](#plan-each-leg).

## Finding coordinates

Links use **in-game zone coordinates**: what `/way` (TomTom) and coordinate add-ons show, 0 to 100 across and down the zone's map from the top-left, on a map named by its [UiMap ID](#uimap-ids).

Sources, best first:

1. **This map.** In a browser: `findPlace("Brill")`, `findNpcs("Innkeeper")` and `showOnlyNpc("Donova Snowden")` return Forever coordinates ([API.md](https://foreverwowmap.com/API.md)). Every popup has **Copy /way**. Without a browser, `&n=<npc name>` in a link marks every spawn of an NPC for you, and an [NPC stop](#npc-stops) puts a route stop at an NPC by its ID.
2. **QuestieDB's Forever data** (Forever-specific, plain text, fetch with any HTTP client). The quest database the Questie add-on uses, converted to Forever:
   - Quests: `https://raw.githubusercontent.com/Questie/QuestieDB/master/data/Forever/foreverQuestDB.lua`. The `questKeys` legend at the top names each field: `startedBy` (2) and `finishedBy` (3) list the NPC, object and item IDs that start and end the quest, `objectives` (10) the mobs, objects and items to kill or collect, `triggerEnd` (9) the spots to explore. Example: `[363] = {"Rude Awakening",{{1568}},{{1569}},...`.
   - Where they are: `foreverNpcDB.lua`, `foreverObjectDB.lua` and `foreverItemDB.lua` in the same folder. An NPC's `spawns` (field 7) and an object's `spawns` (field 4) are `{[areaID]={{x,y},...}}` in 0-100 zone coordinates: `[1568] = {'Undertaker Mordo',...,{[85]={{30.22,71.65}}},...` is Tirisfal Glades 30.22, 71.65. `{-1,-1}` means inside an instance.
   - The keys are AreaTable IDs, not UiMap IDs: `data/Forever/conversion.json` in the same repo lists each zone's `area_id` with its `ui_map_id` (85 is Tirisfal Glades, 1420).
   - New Forever quests and fixes are in `src/corrections/Forever/` (`foreverQuestFixes.lua`, `foreverNPCFixes.lua`, `foreverObjectFixes.lua`). Search a file for `[<id>] =` or for the name.
   - It is community data built from Classic, and Forever is new: expect gaps in new zones and quests.
3. **Wowhead Classic** (Classic, not Forever: say so when you use it): `https://www.wowhead.com/classic/quest=<id>`, `/classic/npc=<id>`, `/classic/object=<id>`, search at `/classic/search?q=<name>`. Quest, NPC and object IDs are the same as in QuestieDB. Forever redrew the maps of **Mulgore, Eastern Plaguelands, Redridge Mountains and Stormwind City**, so Classic coordinates there are wrong on this map; `conversion.json` has the scale and offset to convert them.

Never take coordinates from Retail sources (`wowhead.com/quest=...` without `/classic/`).

## Link format

A link is `#` and then parts like a query string: `key=value`, joined by `&`. You don't have to get it exactly right: the page also reads map names instead of IDs, type words (`quest`), JSON and `/way` lines, and when part of a link can't be read it says which part and why (on the page, in `getState().linkWarnings` and in preview.py's summary).

### Route links

```
https://foreverwowmap.com/#r=<stop>;<stop>;...[&<layers>]
<stop> = <uiMapID>[<type>][s]:<x>,<y>[:<label>]
```

- `x` and `y` are the in-game coordinates, as `/way` and Wowhead write them: `60.97,52.7`.
- Use the map a player stands in. Cities have their own maps (Undercity 1458, Orgrimmar 1454, Stormwind 1453, Ironforge 1455, Thunder Bluff 1456, Darnassus 1457): `Orgrimmar (1454) 45.3 63.7` and `Durotar (1411) 44.5 3.7` are the same spot. A map name works in place of the ID (`Tirisfal+Glades:60.97,52.7:Brill`).
- `<type>` is an optional [pin type](#pin-types) letter glued to the map ID (`1420q`). Without one the pin is "go to".
- An `s` after the type (`1420qs`) draws the leg *into* that pin as a straight line ([Fixing a route](#fixing-a-route)).
- **Labels** can hold any words, numbers and punctuation (`Step 3-4: Grom'gol!`). Write a space as `+`; the page escapes anything else itself when it writes the link.
- Pins are visited in order, with small arrows along each leg. Legs on one continent follow walkable terrain (and ride lifts), except the leg out of a travel pin (`f`), which is drawn as the ride; a leg between continents (a boat or zeppelin) is drawn as a ride too.
- The route can also be a JSON list of waypoints (`#r=[{"map":"Tirisfal Glades","x":60.97,"y":52.7,"label":"Brill","type":"quest"}]`) or `/way` lines (`#way=Tirisfal Glades 60.97 52.7 Brill;Durotar 52.6 42.4 Razor Hill`). The page rewrites either into the short form.

Example: a quest in Deathknell, turn in at Brill, zeppelin from Tirisfal to Razor Hill:

```
https://foreverwowmap.com/#r=1420q:31.98,64.98:Deathknell;1420t:60.97,52.7:Brill;1420f:60.6,58.9:Zeppelin+to+Orgrimmar;1411:52.63,42.43:Razor+Hill
```

### NPC stops

When a stop is at an NPC (a quest giver, a trainer, a mob to kill), name the NPC by its ID instead of, or as well as, giving coordinates. Use the **Wowhead Forever NPC ID**, the number in `https://www.wowhead.com/forever/npc=<id>` (the same IDs as QuestieDB; Classic IDs are the same for NPCs that were in Classic). Never use Retail Wowhead IDs or coordinates.

```
npc<id>[<type>][s][:<label>]                          the map places it at the NPC's spawn
npc<id>[<type>][s]:<uiMapID>:<x>,<y>[:<label>]        at these coordinates
```

- Without coordinates, the stop goes to the NPC's spawn nearest the stop before it (else the one after it). The page shows the NPC's name and Wowhead link, so a label is optional.
- Give coordinates for a specific spawn, or when the map's data doesn't know the NPC (new Forever NPCs can be missing): a stop it can't place is left out, and the page's warnings (`getState()`, preview.py) say so.
- `<type>` and `s` work as on any stop.

```
https://foreverwowmap.com/#r=npc1568q:Undertaker+Mordo;npc1569t;npc5688:1420:61.72,52.05:Brill+inn
```

### Pin types

| Letter | Name | Meaning |
|---|---|---|
| q | `quest` | Pick up a quest (yellow !) |
| t | `turnin` | Turn in a quest (yellow ?) |
| g | `goto` | Go to (default) |
| k | `kill` | Kill or collect |
| i | `interact` | Interact with or use something |
| f | `travel` | Take a flight, boat or zeppelin here: the leg out of it is the ride |
| h | `hearth` | Use the hearthstone |
| n | `note` | A note |
| v | `via` | Route pin: a small unnumbered dot the path bends through. It is not a stop: the numbers on the map and in the list skip it |

The names are for JSON and the API; links use the letters.

### Plan each leg

Do this for every leg before you write it, not only when a picture looks wrong: a leg that cuts through a wall or a camp of elites still looks like a tidy line.

1. **Say the leg as a player would travel it**: where they leave A, which road they follow, where they enter B. If you can't say it, look it up first (the map's roads and layers, a guide for the quest or dungeon). WoW Forever has opened some paths Classic never had, such as the pass from northwestern Mulgore up through Skywatcher Plateau into Desolace, so check for a Forever shortcut before settling on the Classic way round.
2. **Put a route pin (`v`) at each point the path is forced through or should bend at:**
   - Ways in and out: a city gate, the door of a building or tower, a cave mouth, and the dungeon portal, which is often deep inside a cave.
   - Up and down: lifts, ramps, stairs, the one path up a cliff or mesa.
   - Narrow places: bridges, mountain passes, tunnels, the crossing between two zones.
   - Roads: bends and forks of the road a player would take, above all where the map doesn't know the road ([below](#fixing-a-route)).
   - Danger: carry the path round mobs far above the player's level, elite areas, the other faction's towns and guards, and deep water.
3. **Take each pin's coordinates from the map, never from memory**: `findPlace`, an NPC or layer pin that stands there, or the grid picture (`?agent=1`, `preview.py --grid`). A guessed route pin is worse than none.
4. **Pin only where it matters.** The path between pins still follows the terrain, so a short leg over open ground needs none, and a few pins on the right spots beat a trail of them.
5. **Check the result**: the path goes through every pin without doubling back (a pin just off the road makes a spur), and it is the way you said in step 1. Tell the user about anything the picture can't show, such as "take the lift down" or "keep left of the ogre mound"; a route pin can carry a short label for it (`1411v:45.5,12:Gate`).

### Fixing a route

Auto-routed legs are the shortest walk over an 8-yard terrain grid. They prefer roads (a yard off the road counts as 2), but the map only knows the roads the game paints with a road texture (and a few zone textures, such as Desolace's): roads painted with a zone's ordinary dirt or grass aren't known (most of Darkshore's coast road, and Stonetalon's and Thousand Needles' roads), so a leg there can cut across country. Check the picture against the roads on the map. Bridges, narrow ramps and doors can be missing too.

When an auto-routed leg goes the wrong way (through terrain a player can't cross, around terrain they can, or off the road a player would take), fix the leg instead of dropping it:

- **Every hop is a pin.** A travel pin (`f`) goes where the ride leaves (the flight master, the zeppelin tower), and the next pin where it arrives (the flight master it lands at, the tower at the other end). Then walk on with more pins: a flight to Orgrimmar lands at the flight master, so the zeppelin tower outside the gate is the pin after that. The page (`warnings` in `getState()` and in preview.py's summary) flags a ride that doesn't end where it should.
- **Route pin** `v`: add one or more between two pins to bend the path. `1411v:55,30` is a route pin at Durotar 55, 30. To keep a leg on a road, put route pins on the road at its bends and forks.
- **Straight leg** `s`: where no walking path is found, or you want a straight line.

```
https://foreverwowmap.com/#r=1411:52,42:Razor+Hill;1411v:55,30;1411qs:46,13:Orgrimmar+gate
```

### Map, view and dungeon links

| Link | Shows |
|---|---|
| `#m=1420` | A whole map (Tirisfal Glades). A name works too: `#m=Tirisfal+Glades`. |
| `#m=1458&v=40,60,6.5` | Undercity centred at 40, 60, zoom 6.5 (`v=<x>,<y>,<zoom>`). |
| `#r=...` | A route, framed to fit its pins. |
| `#d=wailing-caverns` | A dungeon or raid map (its id or its name). |
| `#d=cave-176000` | A cave's top-down map: `cave-` plus the cave's `id` from `data/caves.js` (only caves with a `map`). |

Dungeon and raid ids: `ragefire-chasm`, `wailing-caverns`, `deadmines`, `shadowfang-keep`, `stockade`, `blackfathom-deeps`, `gnomeregan`, `razorfen-kraul`, `scarlet-monastery`, `razorfen-downs`, `uldaman`, `zulfarrak`, `maraudon`, `sunken-temple`, `blackrock-depths`, `blackrock-spire`, `dire-maul-north`, `dire-maul-west`, `dire-maul-east`, `scholomance`, `stratholme`, `hall-of-thanes`, `ruins-of-lordaeron`, `city-of-dalaran`, `excavation-site-wetlands`, `drowned-city`, `kroldok-stronghold`, `alcaz-prison`, `blackmaw-hold`, `shapers-terrace`, `molten-core`, `blackwing-lair`, `onyxias-lair`, `zulgurub`, `ruins-of-ahnqiraj`, `temple-of-ahnqiraj`, `naxxramas`, and the city maps `stormwind-city`, `orgrimmar`, `ironforge`, `thunder-bluff`, `darnassus`, `undercity`.

### Layers in the link

Parts after the route, map or view part:

| Part | Holds | Example |
|---|---|---|
| `o=<keys>` | Overlays: `flight`, `boat`, `dungeon`, `raid`, `zones`, `places`, `caves` (cave, mine and crypt entrances; off unless named), `books`, and mobs out in the world: `elite`, `rare`, `rareelite` | `&o=flight,boat,zones,places,rare` |
| `s=<keys>` | Services: `inn`, `bank`, `auction`, `mail`, `battle`, `stable`, `spirit`, `classtrainer`, `proftrainer`, `repair`, `reagent`, `poison`, `food`, `vendor`. Quest givers are not a layer: point at one with `n=<name>`. | `&s=inn,bank` |
| `g=<keys>` | Gathering: `herbalism`, `mining`, `containers`, `fishing`, `fishcatch`, `skyborne` (ley lines and elemental convergences for the Skyborne racials), or one node type as the kind's letter (`h`, `m`, `c`, `p` pools, `f` catches, `s` Skyborne: `sleyline`, `selementalconvergence`) plus its name without underscores | `&g=mining,hpeacebloom` |
| `f=<faction>` | `horde` or `alliance`; both without it | `&f=horde` |
| `n=<npc>` | Only this NPC: every spawn marked, service layers hidden. Its name or NPC ID. Without a route or view, the map flies to it. | `&n=Donova+Snowden`, `#m=1414&n=11556` |
| `p=...` | The user's own [pins](#my-pins) | |

A part that is present sets exactly that selection (`s=` alone turns every service off). A link without them leaves the viewer's own layers alone.

```
https://foreverwowmap.com/#r=1420q:31.98,64.98:Deathknell;1420t:60.97,52.7:Brill&o=flight,boat,zones,places&s=inn
```

### Annotations: areas, circles and paths

Show where quest mobs are, or the path a mob or NPC patrols, with an `a=` part, its items joined by `;`:

```
&a=<uiMapID><kind>[<colour>]:<x>,<y>,<x>,<y>,...[:<label>];<next annotation>...
```

| Kind | Draws | Numbers |
|---|---|---|
| `a` | An area: a filled outline | 3 or more corners |
| `c` | A circle | Centre x, y, then the radius in the same units as x |
| `p` | A path with arrows in its direction | 2 or more points |
| `l` | A loop: a path that goes back to its start (a patrol) | 2 or more points |

- `<colour>` is one digit, as for [My pins](#my-pins) (1 red, 2 orange, 4 blue, 5 purple, ...). Without it, areas and circles are red and paths orange.
- All the points of one annotation are on the map of its UiMap ID, in its in-game coordinates.

```
https://foreverwowmap.com/#r=1420q:60.97,52.7:Brill&a=1420a:58,50,62,50,62,54,58,54:Zombies;1420l5:60,48,63,49,62,52:Patrol;1420c:57,55,3:Wolves
```

### Dungeon marks and annotations

The game has no coordinates inside instances, so marks inside a dungeon use **floor coordinates**: 0 to 100 across and down the floor map as this site draws it (the parchment frame included), top-left origin. Numbers from Wowhead, guides or Retail don't carry over. Caves outside the instance portal belong to their zone: use zone coordinates and a route link there.

```
https://foreverwowmap.com/#d=<dungeon id>&k=<floor>[<type>][b]:<x>,<y>[:<label>];...[&a=<annotations>]
```

- `<floor>` counts from 1. `<type>` is a pin type letter (default `g`). `b` breaks the line: no arrow into that mark. Marks are joined in order by straight arrows.
- Areas, circles and paths work as on the world map, with the floor number in place of the UiMap ID (`&a=1a:20,20,30,20,30,30:Raptors`).
- Boss pins on the dungeon map are the best landmarks; place marks relative to them. Without a browser to read the grid, say the marks are estimates.

```
https://foreverwowmap.com/#d=wailing-caverns&k=1:42.7,51.7:Entrance;1v:35,46;1k:30.6,43:Lady+Anacondra;1k:19.1,39.5:Lord+Pythas&a=1a:20,20,30,20,30,30:Raptors
```

### My pins

Free-standing markers, as the `p=` part of any link, items joined by `;`. An item without coordinates names the layer of the pins after it; pins before the first one are in "My pins".

```
https://foreverwowmap.com/#m=1420&p=1420:60,50:Hello;Herbs;1420hpeacebloom:61,54:Peacebloom;1420star3:62,52
```

- A pin is `<uiMapID>[<icon>[<colour>]]:<x>,<y>[:<note>]`.
- Icons: `pin`, `star`, `flag`, `skull`, `cross`, `question`, or in-game ones such as `inn`, `bank`, `mail`, `quest`, `repair`, `boat`, `dungeon`, herbs (`hpeacebloom`), ores (`mcoppervein`), chests (`csolidchest`).
- Colour, generic icons only: 0 green (default), 1 red, 2 orange, 3 gold, 4 blue, 5 purple, 6 pink, 7 teal, 8 white, 9 black (`1420pin1` is a red pin).

## UiMap IDs

| ID | Map | Kind | Parent |
|---|---|---|---|
| 1461 | Arathi Basin | orphan | Arathi Highlands |
| 1415 | Eastern Kingdoms | continent | Azeroth |
| 1414 | Kalimdor | continent | Azeroth |
| 2521 | Zephras Isle | zone | Azeroth |
| 1416 | Alterac Mountains | zone | Eastern Kingdoms |
| 1417 | Arathi Highlands | zone | Eastern Kingdoms |
| 1418 | Badlands | zone | Eastern Kingdoms |
| 1419 | Blasted Lands | zone | Eastern Kingdoms |
| 1428 | Burning Steppes | zone | Eastern Kingdoms |
| 1430 | Deadwind Pass | zone | Eastern Kingdoms |
| 1426 | Dun Morogh | zone | Eastern Kingdoms |
| 1431 | Duskwood | zone | Eastern Kingdoms |
| 1423 | Eastern Plaguelands | zone | Eastern Kingdoms |
| 1429 | Elwynn Forest | zone | Eastern Kingdoms |
| 1424 | Hillsbrad Foothills | zone | Eastern Kingdoms |
| 1455 | Ironforge | city | Eastern Kingdoms |
| 1432 | Loch Modan | zone | Eastern Kingdoms |
| 1433 | Redridge Mountains | zone | Eastern Kingdoms |
| 2548 | Riverglades | zone | Eastern Kingdoms |
| 1427 | Searing Gorge | zone | Eastern Kingdoms |
| 1421 | Silverpine Forest | zone | Eastern Kingdoms |
| 1453 | Stormwind City | city | Eastern Kingdoms |
| 1434 | Stranglethorn Vale | zone | Eastern Kingdoms |
| 1435 | Swamp of Sorrows | zone | Eastern Kingdoms |
| 1425 | The Hinterlands | zone | Eastern Kingdoms |
| 1420 | Tirisfal Glades | zone | Eastern Kingdoms |
| 1458 | Undercity | city | Eastern Kingdoms |
| 1422 | Western Plaguelands | zone | Eastern Kingdoms |
| 1436 | Westfall | zone | Eastern Kingdoms |
| 1437 | Wetlands | zone | Eastern Kingdoms |
| 1459 | Alterac Valley | orphan | Hillsbrad Foothills |
| 1440 | Ashenvale | zone | Kalimdor |
| 1447 | Azshara | zone | Kalimdor |
| 1439 | Darkshore | zone | Kalimdor |
| 2524 | Darkspear Islands | orphan | Kalimdor |
| 1457 | Darnassus | city | Kalimdor |
| 1443 | Desolace | zone | Kalimdor |
| 1411 | Durotar | zone | Kalimdor |
| 1445 | Dustwallow Marsh | zone | Kalimdor |
| 1448 | Felwood | zone | Kalimdor |
| 1444 | Feralas | zone | Kalimdor |
| 1450 | Moonglade | zone | Kalimdor |
| 2482 | Mount Hyjal | zone | Kalimdor |
| 1412 | Mulgore | zone | Kalimdor |
| 1454 | Orgrimmar | city | Kalimdor |
| 2652 | Shen'dralas | zone | Kalimdor |
| 1451 | Silithus | zone | Kalimdor |
| 1442 | Stonetalon Mountains | zone | Kalimdor |
| 1446 | Tanaris | zone | Kalimdor |
| 1438 | Teldrassil | zone | Kalimdor |
| 1413 | The Barrens | zone | Kalimdor |
| 1441 | Thousand Needles | zone | Kalimdor |
| 1456 | Thunder Bluff | city | Kalimdor |
| 1449 | Un'Goro Crater | zone | Kalimdor |
| 1452 | Winterspring | zone | Kalimdor |
| 1460 | Warsong Gulch | orphan | The Barrens |
| 947 | Azeroth | world |  |
