A free, open-source guide addon for World of Warcraft: Forever: step-by-step leveling routes for every race from 1 to 60, through Forever's new Riverglades and Shen'dralas, a waypoint arrow that walks real paths, and guides for class quests, professions, reputations, mounts and pets.
polestar.guide: every guide, community guides and the docs · Polestar Discord: questions, feedback and bug reports · Polestar is free; if it saves you a few hours, you can buy me a coffee.
New in 0.4.0 · Quick start · What it is · A look inside · polestar.guide · Community guides · Polestar Client · Features · Help · How the routes are made · Building from source · Contributing · Data and licensing
| Play Install the addon and follow the arrow. |
Browse the guides Every guide, step by step, on polestar.guide. |
Write guides Publish your own routes as a community guide. |
Work on Polestar Fix a guide, build the addon, run the tests. |
Polestar 0.4.0 puts the Riverglades and Shen'dralas into the route to 60 for both factions, and both routes were walked through again zone by zone. The release notes and CHANGELOG.md list every change.
- The Riverglades and Shen'dralas are in the main route. One Riverglades guide per side (Alliance 41 to 45, Horde 41 to 44) and one Shen'dralas guide for both (Alliance 45 to 46, Horde 46 to 47), placed where they fit your level, with warnings for the zones' elites. There is no extra choice to make. Mount Hyjal (Alliance, 57 to 60) is an optional Experimental guide. The whole road is in The route, guide by guide.
- Both routes reworked. Every leveling guide's level range was worked out again, and the Alliance's 50 to 60 Silithus guide is folded into the last guide. In our route tests (simulated 1 to 60 runs counting rested experience), hours to 60 went from 134.7 to 127.5 for the Alliance and from 127.4 to 120.9 for the Horde, and spots with mobs 2 or more levels above you from 106 to 58 and from 102 to 47.
- Dungeons. The Dungeons window uses the game's Group Finder ranges and group sizes, and every grind step suggests a dungeon that fits you right now.
- Finished quests stay found. The guide hands them in where it passes their NPC, "Still to do" lists the ones no step ahead takes, and a finished guide says which quests carry on and which aren't part of your route. Nothing is abandoned unless you choose.
- A new settings window, Install and Profiles. Grouped pages, a live preview on every Look page, a search that understands questions, a short Install on each new character, and profiles as picture cards with a Share tab.
- Nine new skins (Vellum, Lumen, Beacon, Aurora, Hairline, Umbra, Waymark, Lanterns, Sheen), each loaded only when you pick it, and WoW Forever, Blizzard, Classic and Hearth rebuilt with their own arrow and map pins.
- And more: the target list with portraits, open guides as tabs in compact mode, sell and repair reminders, a materials list with an Auction House shopping list, gear advice that reads Forever's ratings, German leveling guides and Latin American Spanish for every leveling, class, profession and reputation guide.
- Install it one of three ways:
- The CurseForge app: search for Polestar Guides and install it, then skip to step 3.
- The Polestar Client: a small app for Windows, macOS and Linux that finds the game, installs Polestar and keeps it up to date, community guides included. Skip to step 3.
- By hand: download
Polestar-<version>.zipfrom the newest release, under Assets (not "Source code").
- Unzip it into the game's AddOns folder, so the Polestar folders
(
Polestar,Polestar_Guides,Polestar_Codex,Polestar_Nav,Polestar_Options,Polestar_Looks, the ninePolestar_Skin_*skins and the others, with onePolestar_<language>folder per client language such asPolestar_deDE) sit directly inside it:World of Warcraft/_classic_beta_/Interface/AddOns/on the beta client,_forever_/Interface/AddOns/on the_forever_client. The same zip works for both; if you have both clients installed, unzip into each one. In the game's AddOns list they all sit under one "Polestar" heading, which its arrow folds away. - Restart the game completely (a
/reloaddoes not load new addons) and log in. The guide window opens with a guide for your race, level and zone: follow the arrow, and the goals tick themselves off as you play.
Good to know:
/polestar guidesopens the hub: every guide, Lookup, Dungeons and Rares./polestar optionsholds every setting; quest markers on the map are off until you turn them on under Map. A click on the Polestar button on the minimap's edge hides everything Polestar shows, and a second click brings it all back; right-click it for a short menu (the guide window, the arrow, whether hiding keeps the arrow), drag it to move it (Options, Map, Guide & quests, Minimap button turns it off)./polestar skipmoves on for good;/polestar nextandprevonly look ahead or back.- Updating: the CurseForge app and the Polestar Client update Polestar for
you. By hand, delete the old Polestar folders, then unzip the new release
the same way. Coming from 0.2.x, also delete the
Polestar_Guides_deDE,Polestar_Names_deDEkind (one of each per language):Polestar_deDEand its siblings replace them, and Polestar reminds you at login while they are still there. - "No guides installed" or "Polestar Guides is turned off": Polestar Guides is unticked in the game's AddOns list. The list shows it indented under Polestar, and ticking Polestar (after Disable All, say) does not tick it. Polestar asks once at login, and the guide window and the guide menu have a Turn on Polestar Guides and reload button that turns it and its parts back on for all your characters. By hand: tick Polestar Guides and the rows under it, or right-click Polestar in the list and pick the option that enables its whole group.
- Memory: the arrow's walking routes (
Polestar_Nav) load after login, never in combat, and each continent's walking maps load when you get there. Walk real paths (Options, Arrow & routes) off never loads them. - Optional:
Polestar_Recorder(Polestar_Recorder-<version>.zipin the same release, or from the Polestar Client) records your play for the recording program that improves the routes. With the Polestar Client it records while sharing is on, which it is by default (one click in the Client stops it, and/psrec offalways wins); on its own it stays off until you type/psrec on. - Community guides are routes other players publish for Polestar, on polestar.guide: see Community guides.
- Something wrong? Click the bug in the guide window, beside Skip: say what
went wrong; the report already holds the step, where you stand, your other
addons and the versions. Copy report and post it in #bugs on the
Polestar Discord: a bot files it for the
developers and replies in your thread when it's fixed. Get the invite is
there if you're not in the Discord yet. Have a GitHub account?
Open on GitHub pre-fills a new issue with your report.
/polestar reportopens the window too, and issues are welcome as well. The release'sSHA256SUMSholds the zips' checksums.
Polestar is one addon for the whole of WoW: Forever. It carries 263 guides: 68 leveling guides that take both factions from 1 to 60 from every race's starting zone (Zephras Isle for the Skyborne included), 81 class guides for every class's quest chains and class mounts, the twelve professions from 1 to 300, 27 reputations, 7 exploration guides, the Legacy challenges, 64 collectible guides (mounts and pets) and 3 miscellaneous guides, with Mount Hyjal as an optional Experimental guide beside them. Every one of them can be read step by step on polestar.guide.
Around the guides it adds a 3D waypoint arrow that walks real paths (on Polestar's walking maps, with a router that started from Shortest Path Forever's by Cillian Berragan) and a travel planner, quest markers on the map, gear advice on tooltips, quest rewards and bags, a search for where any item, mount or pet comes from, a dungeon quest journal, rare alerts and the quality-of-life helpers a long leveling session needs. Its interface and its guides read in English, German, French, Spanish (Spain and Latin America), Brazilian Portuguese, Russian, Korean and Chinese (simplified and traditional).
Every race plays its own starting zone (to about level 11 to 14, the Night Elves with Darkshore to 15, the Skyborne to about 15), then all the Horde races share one route from Silverpine Forest and the Barrens to 60, and all the Alliance races one from Westfall. Both routes run through Forever's new zones: the Riverglades in the low 40s and Shen'dralas in the mid 40s. Each guide's level range is the level the route brings you there at. The routes began as Polestar Forge's builds from the game's data and Forever's quest data, elite and group quests included; since then they are tuned zone by zone by hand, each change measured and kept as a record so no later build loses it, and checked by playing them the way a player follows them (How the routes are made).
The route, guide by guide
The levels are each guide's range on that faction's route. Shen'dralas is one guide for both factions.
| Starting zones | Alliance | Horde |
|---|---|---|
| Elwynn Forest (Human) | 1 to 11 | |
| Dun Morogh (Dwarf, Gnome) | 1 to 14 | |
| Teldrassil, then Darkshore (Night Elf) | 1 to 13, 12 to 15 | |
| Zephras Isle (Skyborne) | 1 to 15 | 1 to 15 |
| Durotar (Orc, Troll) | 1 to 12 | |
| Mulgore (Tauren) | 1 to 13 | |
| Tirisfal Glades (Undead) | 1 to 13 |
Alliance, from Westfall
| # | Guide | Levels |
|---|---|---|
| 1 | Westfall | 11 to 18 |
| 2 | Darkshore | 15 to 20 |
| 3 | Loch Modan, Redridge Mountains & Westfall | 18 to 22 |
| 4 | Darkshore | 21 to 23 |
| 5 | Ashenvale, Wetlands & Stonetalon Mountains | 22 to 25 |
| 6 | Duskwood & Redridge Mountains | 24 to 27 |
| 7 | Duskwood | 27 to 28 |
| 8 | Wetlands, Ashenvale, Ironforge & Stormwind City | 27 to 30 |
| 9 | Duskwood | 29 to 31 |
| 10 | Wetlands & Hillsbrad Foothills | 30 to 32 |
| 11 | Wetlands, Dustwallow Marsh & Thousand Needles | 31 to 33 |
| 12 | Stranglethorn Vale | 32 to 34 |
| 13 | Desolace | 33 to 35 |
| 14 | Stranglethorn Vale | 35 to 36 |
| 15 | Arathi Highlands, Alterac Mountains & Swamp of Sorrows | 35 to 37 |
| 16 | Badlands | 37 to 38 |
| 17 | Desolace | 38 to 39 |
| 18 | Stranglethorn Vale, Dustwallow Marsh & Swamp of Sorrows | 39 to 41 |
| 19 | Riverglades | 41 to 45 |
| 20 | Badlands & The Hinterlands | 45 to 46 |
| 21 | Shen'dralas | 45 to 46 |
| 22 | Feralas | 45 to 47 |
| 23 | Tanaris | 46 to 48 |
| 24 | The Hinterlands & Blasted Lands | 47 to 48 |
| 25 | Searing Gorge | 48 to 49 |
| 26 | Un'Goro Crater | 49 to 50 |
| 27 | Azshara, Western Plaguelands & Burning Steppes | 50 to 53 |
| 28 | Felwood | 52 to 54 |
| 29 | Winterspring & Eastern Plaguelands | 53 to 56 |
| 30 | Western Plaguelands, Eastern Plaguelands, Feralas, Un'Goro Crater & Silithus | 55 to 58 |
| Optional: Mount Hyjal (Experimental) | 57 to 60 | |
| 31 | Silithus, Felwood, Winterspring & the Plaguelands | 58 to 60 |
Horde, from Silverpine Forest
| # | Guide | Levels |
|---|---|---|
| 1 | Silverpine Forest | 12 to 16 |
| 2 | The Barrens | 14 to 23 |
| 3 | Ashenvale & Silverpine Forest | 22 to 23 |
| 4 | Hillsbrad Foothills | 22 to 25 |
| 5 | The Barrens & Stonetalon Mountains | 24 to 27 |
| 6 | Ashenvale & Thousand Needles | 27 to 29 |
| 7 | Hillsbrad Foothills | 29 to 31 |
| 8 | Thousand Needles & Desolace | 30 to 33 |
| 9 | Stranglethorn Vale | 33 to 36 |
| 10 | Dustwallow Marsh & Desolace | 36 to 38 |
| 11 | Alterac Mountains & Arathi Highlands | 37 to 39 |
| 12 | Badlands | 38 to 40 |
| 13 | Stranglethorn Vale & Swamp of Sorrows | 39 to 42 |
| 14 | Riverglades | 41 to 44 |
| 15 | Feralas & Tanaris | 44 to 47 |
| 16 | Shen'dralas | 46 to 47 |
| 17 | Feralas, Dustwallow Marsh & Swamp of Sorrows | 46 to 48 |
| 18 | Tanaris & Searing Gorge | 48 to 49 |
| 19 | The Hinterlands & Blasted Lands | 49 to 51 |
| 20 | Azshara, Feralas & Stranglethorn Vale | 50 to 51 |
| 21 | Un'Goro Crater, Burning Steppes & Western Plaguelands | 51 to 53 |
| 22 | Felwood & Western Plaguelands | 52 to 55 |
| 23 | Winterspring | 55 to 56 |
| 24 | Azshara & The Barrens | 55 to 56 |
| 25 | Eastern Plaguelands, Winterspring & Tanaris | 56 to 57 |
| 26 | Silithus, Western Plaguelands & Eastern Plaguelands | 57 to 60 |
| 27 | Felwood, Moonglade & Winterspring | 59 to 60 |
Mount Hyjal is offered under "Choose your path" at the end of the Western Plaguelands guide, with a purple Experimental chip; it is never suggested or picked for you, and it hands you back to the Silithus guide.
Players publish their own routes for Polestar as community guides on
polestar.guide, and the
Polestar Client installs them and keeps them
up to date (Community guides). Each new character's
first login opens Install, a short setup a page at a time: a hello and
what Polestar does; on the account's first character, Questing (quest
automation, grey quests, the guide at login, the stat weights gear advice
uses), Targeting (the target button, which lists your step's mobs and NPCs
so a click targets one, the list following the button with no switch of its
own; Simple target button for the single square button and who it targets;
its mark and ping),
Groups (group quests), Your route (Fastest, Balanced or Roads, and the route
line) and Your look (Polestar's looks, the game's and the skins, with a
preview, and the colour scheme); a later character gets only its own choice,
its class's stat weights. Every choice works the moment you make it, Skip
install keeps everything as it is, and the last page names the guide
Polestar suggests and where everything is in Settings. /polestar install,
About's Install and the Install button in the settings window's header open
it again; the settings search finds it too.
Note
Beta. Every guide compiles, lints and plays to the end in a simulator for every race and class it serves, and the route checker plays every leveling guide to 60 the way a player follows them. Tell us what you find on Forever: every report becomes a fix the next build keeps. The Riverglades and Shen'dralas guides are written from Forever's quest data and players' first recordings of the zones, and Mount Hyjal is still an Experimental guide (Polestar Experimental, listed with Polestar's own guides; Options > Guide > Show experimental guides takes it out of the menu): the Recorder's explorer mode keeps mapping the new zones as players go there.
Polestar's own windows, rendered from the addon on a game scene (game art © Blizzard Entertainment). The GIFs above show it moving; these are the rest.
Lookup, Dungeons and Rares read the Codex, a data pack that ships in the
release as Polestar_Codex (Lookup, Dungeons and
Rares). Renders of every window and state, drawn
without the game, are in docs/preview.
polestar.guide is Polestar's website: the guides, the community guides, the Polestar Client and the docs in one place.
- The guide library. Every guide Polestar ships, step by step as the guide window shows it, searchable by zone, class, mount or reward. Pick your race for your road from 1 to 60: Alliance or Horde, zone by zone.
- Class leveling pages. Each class's races, class quests and gear advice while leveling.
- Community guides. Routes players write and publish, free to download (Community guides).
- The docs for players, guide authors and contributors, with every slash command, option and key binding, and every release's changes. AI assistants can read the site from its llms.txt.
Guides for Polestar written by other players and published as their own addons. Install one next to Polestar and its guides show up in the guide menu under Community guides, with the arrow, the map markers and everything else Polestar does. Each is made and supported by its author.
Most are published on polestar.guide, which keeps them safe to play and fair to their authors:
- Plain text, built by Polestar. An author publishes the guide files, never code: the site builds every version with Polestar's own compiler, so no author's code runs in your game. It also checks every step against the game data and gives the author its notes; what to change is the author's call, and the notes never hold a version back.
- Scanned and reviewed. Every version is scanned on VirusTotal before it is published, and its page links the report. A moderator reviews each author's first version, and any later one that changes owner or installs different addon folders.
- Pulled when it must be. A person reviews every copyright notice; a takedown removes the guide from the site and from every player's Polestar Client. A version found to be harmful or broken can be turned off in the Client for everyone who has it, with the reason shown.
- Find one on polestar.guide and install
it with the Polestar Client, which keeps it
up to date. Or download it from wherever its author publishes it and
install it like any addon, next to the
Polestarfolders. - Restart the game. Its guides appear in the guide menu
(
/polestar guides) under Community guides. - Options > Community guides (
/polestar packs) turns each one on or off without a reload, and picks where the guide for your level is suggested from.
A community addon never replaces Polestar's guides or another one's. Report problems in it to its author, not to Polestar, and install them only from authors you trust.
A short guide shared as a single line of text (a quest chain, an item, a
mount, an errand) can be pasted on the Import page without installing
anything: /polestar import opens it, or follow the foot of the hub's left
rail above Options. Polestar shows what the guide is before saving it, says
why when it turns one down, offers Update for a newer version and keeps
your progress, and lists your imported guides with Delete. Imported guides
appear in the guide menu under Community guides > Imported, credited to
their author, and are never suggested on their own.
Write leveling guides in plain text and publish them as your own addon,
with the tools Polestar uses for its own: the guide format, the compiler,
lint, playtest, and in the game the guide engine, the arrow and the map
markers. Hand over to any of Polestar's guides with next, so your addon
can cover one zone or the whole climb, under a license of your choice
(Data and licensing).
git clone https://github.com/fitzforge/polestar.git
cd polestar
npm link # puts `polestar` on your PATH
cd rust && cargo build --release -p forge && cd .. # or a prebuilt forge from the Releases page
rust/target/release/forge data build # the reference data every guide command reads
polestar doctor # checks the setup and prints the fix for anything missing
cd .. # your pack goes beside the clone, not inside it
polestar new my-pack # asks for the id, title, author and license
cd my-pack
polestar dev --play # lint and build on every save, with the browser playgroundTo publish, sign in on polestar.guide and start a new community guide: upload the folder, or publish from GitHub Actions by pushing a tag. You send the source, never a built addon: the site builds it, shows the build report, scans it and lists it. Writing a community guide on the site walks through every step.
| Start here | Then |
|---|---|
docs/GUIDE_PACKS.md: community guides on one page, for players and authors: install, the steps from new to publishing, the checklist before you publish |
docs/PACKS.md: the full handbook, with setup on each system, a first pack in 15 minutes, and every problem and its fix docs/GUIDE_CHEATSHEET.md: the guide format on one page (in full) docs/PACK_FORMAT.md: exactly what the tools write |
The Polestar Client is a small desktop app for Windows, macOS and Linux (beta, 0.1.7). It finds WoW: Forever on your computer and:
- installs and updates Polestar's addons: Polestar, the Recorder and LibForeverData, each download checked against the checksum its GitHub release publishes. Other addons are never touched.
- installs community guides from polestar.guide and keeps them current. Updates install by themselves only if you turn that on, and then only a day after release and while the guide's publisher and folders are unchanged; a guide the site pulls is turned off or removed, with the reason shown.
- shares your play with the recording program, on by default: it sends what the Recorder records, with no character, realm or account names, and shows exactly what each upload holds. A notice says so the first time, with Stop sharing; stop, pause, or delete everything it sent, any time (docs/RECORDING.md lists every field).
- tells Polestar about new releases: after each check for updates it writes the newest Polestar release into the addon's folder, so the update card in the game knows it (docs/RECORDING.md, "Client info").
Download it from polestar.guide/client or the Client's GitHub release; its source is in apps/client.
One person at a time, goals that tick themselves off, skip with undo, tabs, While you're here, finished quests handed in on the way, group and elite quests your call, a dungeon instead of the grind, new spells at level-up, hiding Polestar in one click.
- One person at a time. In a quest hub the window shows only who to talk to now and their quests, then "Then: next person" and "Person 2 of 8"; the arrow points at that person. Counters sit right after each goal ("Kill Zhevra Chargers 3/8") and a bar at the foot shows how far into the guide you are.
- Goals check themselves off as you play: accepted and turned-in quests, kills, loot, places reached, trainers visited, skills and reputation. Your place in a guide is recomputed from your quest log, so it survives lost saved variables.
- Skip a quest. Right-click a quest's line, Skip this quest: the guide drops it and the quests that follow from it, in every guide, and the banner's Undo brings them back. Skip, at the top, passes the whole step.
- Show in quest log. Right-click a quest's line, or a While you're here line, and pick Show in quest log: the game's quest log opens at that quest (after the fight, in combat).
- Abandoned a quest by mistake? The guide stays on its step, greys out that quest's goals and points the arrow back at its giver, and asks: go back for it, or skip it and what follows. "When you abandon a guide quest" (Options, Guide, Automation) can always do one or the other.
- Failed quests say so. A failed escort or timed quest greys its goals with "failed: abandon it and take it again", and the arrow leads to its giver.
- Timed quests count down. Their goals and the arrow show the time left ("M:SS left"); a chat line and a sound come at 5 minutes, at 1 minute and if the quest fails (Options, Questing, Quests, "Timed quest alerts"), and the step says when the way to the hand-in takes longer than the time you have left.
- It catches up. With "Skip grey quests" on, a guide you open on a character who already did part of the route goes over what is done to where you are: gray quests are left out, and so are quests behind your progress that pay you less than full XP when going back for them costs more time than they give, unless a later quest needs them. A quest still paying full XP always stays. A guide you are past, given to you when no guide is open or by Start guide, hands over to the next. Item, mount, reputation, profession and class guides do every step.
- It says what it leaves out. Where the guide passes over quests, the guide window shows a dim "N left out here" line: open it to see each quest and why (it needs another quest first, it waits for your level, it pays too little for the walk, you took a quest that closes it), with "Guide me" to a quest's missing start and "Turn off Skip grey quests". Grind steps say which level the next quests are and what is still worth doing nearby; the bug report carries the same reasons.
- A guide for where you are. The window opens with a guide suggested for your race, class, level and location, and each guide hands over to the next one in its chain when you finish it.
- Any leveling guide on its own. Start a guide without the ones before it and, when much of its quest XP follows on from an earlier guide you haven't done, the window says so near the start, with a rough count of the extra grinding minutes and a button that opens that earlier guide.
- Tabs. Up to six guides open at once (a leveling route and a profession, say); quests are auto-accepted for all of them. In the compact window, two or more open guides show as a slim tab strip above the step bar, each with a close button and a + for another; the window's menu lists them under "Open tabs" in every mode.
- Finished quests stay found. Quests the route takes are handed in where it passes their NPC. Finished quests no step ahead hands in get one row in "Still to do" ("2 finished quests to hand in elsewhere (900 XP)"), and a click lists who takes each in. When you finish a guide, its end window says which quests in your log carry on to later guides and which aren't part of your route at all, each with Abandon a click away. Nothing is abandoned unless you choose.
- Class quests come to you. When one of your class's quest guides opens (you reach its level, or its first quest becomes available), the guide window offers it in a tab next to your leveling guide (Options, Guide, Automation, "Offer class quests").
- Pin a quest along the way. Right-click any quest in the quest log, or use the guide window's menu, and its open objectives join the Along the way list beside whatever step you are on, with their map marks, the target button and the arrow, until they are done or you unpin it.
- Dynamic Questing. When you pass through the area of a later step's objective whose quest is already in your log (12 vermin as much as one chest), a "While you're here" panel under the step lists it, up to three at once; done now, that step is done or shorter when you get there. Click one for the arrow, right-click it to see its quest in the quest log or to leave it around there (twice: for the rest of the zone). A quest ready to hand in shows the same way when its NPC is in the town you're in or a few seconds out of your way (20 by default; Options, Guide, Window, Dynamic Questing, "Hand-ins: how far out of your way"), and at that NPC it also takes the quests the next steps need ("Hand in … then take …: saves a trip back"). Pick-ups count too: walk near someone who gives a quest your guide takes later, anywhere in the guide you have loaded, and a row says "Take “” from : saves a trip back"; talking to an NPC whose quest comes in the next few steps takes it without moving the guide. When the guide is about to leave town with your bags nearly full or your gear worn, a line points to a merchant or repairer on the way ("Repair before heading out: gear at 22%"), once per town visit (Options, Guide, Window, Dynamic Questing, Sell and repair reminders).
- Group quests are your call. At a quest a guide marks as a group quest, the guide window asks: Skip it keeps to the solo route, Do it with a group takes it on. "Group quests" (Options, Guide, Automation) can answer them all at once, so the route never stops to ask.
- Talent plans are paused for now: the hub's Talents section says "Coming soon".
- Reputation guides say, for each standing band, what every turn-in, kill or run pays, how many you need to the next standing, where the items come from, when kills stop counting and what the quartermaster sells.
- Professions send you to the nearest trainer, vendor or inn of your own faction from where you stand, never into a city of the other faction; a goal's cycle button picks another. In the starting zones, a character who already has a profession gets its Camping 101 quest at the campfire too, handed in at the trainer on the way.
- Materials and the Auction House. A crafting, Cooking or First Aid
guide asks once how to get its materials: Mix, Gather, Buy or Later. Every
skill range has an Auction House step for what it can buy there, gather
steps name the skill they need, and counts include your bank, mail and
what you bought. The Materials window (
/polestar materials) lists every material ahead with what is still to get, and a shopping list stands beside the game's Auction House window (/polestar ah), sent to Auctionator when it is installed. Quest items better bought than farmed get a reminder in cities with an Auction House. The default for new guides is under Options > Guide > Professions. - Class training reminder every two levels (configurable): when your guide trains you within a few steps it says so, else it names the class trainer that fits your route. At levels 40 and 60 a riding reminder shows the cost of riding and your balance, and points the arrow at your riding trainer once you can afford it.
- New spells at level-up. When you ding, a quiet card on the guide window shows the class spells you can now train (the game's own tooltip on each icon), what they cost together and whether you can pay it, and where to train: your guide's own training stop when it is a few steps away, else the class trainer that fits your route, with a button for the arrow. It goes by itself, stays away in combat and dungeons, and says nothing on levels with nothing new.
- Old ranks on your bars. Action bars keep the exact rank you put on them, so after training (and at login) a card lists the spells on your bars that are a lower rank than your spellbook's ("Renew: rank 2 to 3"), and Upgrade puts the highest rank in those same buttons, out of combat. Macros and items are never touched; right-click a spell on the card to keep it at its rank, and a lower rank you put on a bar yourself is kept too. Both under Options > Quality of Life > Vendors > Trainers.
- Elite quests with a solo way past. The leveling routes take elite and group quests where they pay, sized from the game's creature data, with the group each one wants; skip one and the guide has you grind to the route's level there instead, so you are never stranded. Quests that start from a rare drop are optional extras. Where much stronger mobs stand, the step warns you or makes them a group choice.
- A dungeon instead of the grind. When the guide asks you to grind to a level, a line under the step suggests a dungeon that fits you right now, with its quests when it has some for you ("Or run Wailing Caverns (17–24) with a group: 4 quests to pick up first."). Click it for that dungeon's quests. A "reach level N" step also counts the finished quests in your log that the guide hands in first.
- Escort notes. On an escort quest the guide window says so under the quest's accept and under the goal to complete it: "Escort: if the NPC is not there, wait for it to respawn", so an empty spot means someone else is on the escort, not a wrong place.
- Bar at the bottom (Options, Guide, Window): puts the tabs and the step bar at the bottom edge when the window grows upward, so they stay in one place as steps get longer. Off by default.
- Hidden in dungeons and battlegrounds (Options, Guide, Window, In
dungeons and battlegrounds; on by default): the guide window, its action
buttons and alerts stay out of the way inside dungeons, raids,
battlegrounds and arenas and come back when you leave.
/polestar, the key binding or Guide window in the minimap button's menu still opens it while you are inside. The first time it hides, a note at the top of the screen says how to bring it back. - Floating button (Options, Guide, Window, Show and hide; off by default): a small Polestar button you put anywhere on the screen. It works as the minimap button does: click it to hide or show Polestar, right-click it for the same menu, drag it to move it. It hides with the window in combat and in dungeons when those are set to hide.
- Minimap button, on for everyone: click it to hide or show everything Polestar shows, right-click it for a menu (the guide window, the arrow, whether hiding keeps the arrow), drag it to move it (Options, Guide, Window, Show and hide turns it off).
- Esc menu button: a Polestar button in the game menu opens the guide menu (Settings > Look > Theme > Frames, "Game menu button").
- Hiding Polestar (a click on the minimap or floating button, Polestar in
the addon list on the minimap, the Hide/show Polestar key binding or
/polestar hide): everything Polestar shows goes at once, the guide window, the arrow, the buttons, alerts and toasts, the lines and pins on the map and minimap, the marks on your bags, quest windows, nameplates and tooltips, and its sounds. Your guide keeps up with what you do meanwhile, and the next click brings it all back as it was, also after a/reload. The minimap button stays, dimmed. Keep the arrow when hidden (in the minimap button's menu and under Show and hide; this character only) leaves the arrow, its travel button and its arrival sound. Opening a Polestar window (the guides, the options, their key bindings) brings Polestar back. In a fight the action buttons go or come back when it ends. - Pause (the guide window's menu, the minimap button's menu, Options,
Guide, Window, the Pause the guide key binding or
/polestar pause): on your way to a dungeon and inside, the arrow, the guide window and its nudges step aside, and Polestar resumes by itself when you leave the dungeon alive (a wipe and the run back keep it paused). The Spirit Healer's resurrection counts as leaving alive, so pause again for the run back. Your guide keeps up with your quest log meanwhile; a point you pick and the way back to your corpse still show./polestar resumeor opening the guide window ends it early. Under it in Options, the step's map pins and the quest automation can pause too. This character only.
The 3D arrow with distance and time, the travel planner, route lines, zone crossings, Go anywhere, Nearby services, other addons' waypoints.
- A 3D waypoint arrow points at the current goal, shifting from the accent to jade as you arrive, with distance and ETA. Distances read in yards, the game's unit, or in meters (Options, Arrow & routes).
- The travel planner uses known flight paths, boats, zeppelins and your Hearthstone when they are faster. Each leg has its own caption on the arrow ("Fly to Crossroads", "Take the boat to Menethil Harbor", "Hearth to Razor Hill").
- Route lines on the world map and the minimap show the way to the goal as a line, dots or sparkles, with their own colour, opacity and size; flights show dashed (Options, Guide, Arrow & routes, Line style; a switch takes them off the minimap).
- Zone crossings. Walks between zones go through the real tunnels, passes, bridges and gates (Carbonite's zone connections), one waypoint at a time ("Go to Ashenvale"): from Sun Rock Retreat to Astranaar through the Talondeep Path, not over the ridge.
/polestar way <x> <y> [label]points the arrow anywhere on the current map.- Go anywhere. Shift-click the world map or the minimap and the arrow takes you there, routed like any goal; Alt-click works over map icons. Click the spot again to let it go.
- Nearby services.
/polestar near repair(trainer, a profession, class, weapon, reagents, vendor, food, general, arrows, bullets, ranged, innkeeper, bank, mailbox, auction, flight, stable) points the arrow at the quickest one to reach, naming a vendor's trade; the map's tracking menu and the guide window's Nearby services button list them, the button with a page of vendors (food and drink, general goods, and the ammunition and bows or guns your class can use) and one of the weapons a weapon master can teach you. Once you get there, the arrow is back on the guide. - OpenMap. On OpenMap's seamless world map the trail dots carry on across zone borders and show on the whole-world view too. OpenMap's menu has a "Polestar trail dots" switch.
- Other addons' waypoints (Options, Integrations, TomTom). Without TomTom, "Let other addons set
waypoints" (off by default) lets addons that set TomTom waypoints point
Polestar's arrow and makes
/waywork; addons that expect TomTom's own settings may not work with it on. With TomTom, the arrow can follow TomTom's. Addon authors:Polestar.Nav.API(docs/ARCHITECTURE.md, "Nav API"). - Flight map destination. On the flight map, the destination the guide flies you to is marked with a bobbing arrow and its name above it, and a slow ripple on the node itself. With Reduce motion on, the mark stands still. With Take the marked flight on (Quality of Life, Travel; off by default), the map flies you there as soon as it opens; hold Shift at the flight master to choose yourself.
- Lock arrow and buttons (Options, Guide, Window; off by default): a stray drag no longer moves the arrow, the quest item, target and Hearthstone buttons or the flight and instance timers. Shift-drag still moves them.
Real walking paths, route styles, and handing guiding to Shortest Path Forever if you prefer it.
The arrow walks real paths: round cliffs, water and walls, through the town gate and down into the mine, not over the edge. That is the work of Shortest Path Forever by Cillian Berragan (cillian.dev), who baked walking maps of the continents from the game client and wrote a router that finds a route over them a couple of milliseconds at a time, so the game never stutters. It is beautiful work, and he generously said yes when we asked to use it. Polestar's travel planner still picks the flights, boats and Hearthstone; the router that started from his walks every leg between them. It keeps to roads where they are not much longer, round steep slopes, and out of the other faction's towns; when a walk must enter one (a quest inside Southshore for a Horde character), the arrow says "Hostile town: Southshore" once as the walk starts, and the walk's journey step reads the same when the route has more steps. Route style (Options, Guide, Arrow & routes) picks how it walks: Fastest takes the shortest way over hills and across fields, Balanced (the default) keeps to roads that aren't much longer and goes round hills, and Roads stays on roads even when they're longer. Every style keeps out of the other faction's towns.
The router ships with Polestar as the Polestar_Nav folder. Polestar's
walking router started from Shortest Path Forever v1.16.0 by Cillian
Berragan, with thanks; Polestar maintains it since 2026-10-16. It runs on
Polestar's own walking maps of Eastern Kingdoms, Kalimdor and Zephras Isle,
made from the game's geometry in a format grown from his by a port of his map
baker (GPL-3.0-or-later; what came from where is in
addon/Polestar_Nav/CREDITS.md).
Walk real paths (Options, Arrow & routes) turns it off. If you like it, try
his addon:
Shortest Path Forever on CurseForge
plans whole journeys with flights, boats, zeppelins, portals and live
departure times.
Shortest Path Forever: an option. With it installed, Polestar still
guides by default. Hand guiding to Shortest Path Forever (Options,
Integrations) hands it the route instead: each goal goes to Shortest Path
Forever, whose arrow, route and journey take you there, and Polestar's own
arrow, route lines, journey steps, travel button, transport alerts, map
clicks and /way step aside, so the two never guide at once (Polestar's
walking maps are not even loaded). The guide window and the map pins stay. A
kill or collect area is handed over as an area, so it holds you there until
the goal is done; if you clear or replace the journey, Polestar leaves it be
until the guide moves on. With the option off, a journey you start in
Shortest Path Forever itself still wins: Polestar steps aside the same way
while it runs, and guides again when it ends. If Shortest Path Forever
finds no way to a goal, or turns its journeys off, Polestar's own arrow
guides you there instead.
Quest markers and nameplate counts, services and rares on the map, the Target button, Quick Keybind Mode and key bindings.
- Quest markers: givers, objectives and turn-ins on the world map and the minimap, with tooltip lines on the mobs and items a quest needs and quest levels in the log. Nameplate icons mark the mobs you still need, with a live kill or loot count beside the quest icon ("3/10", "3/10 · 1/8" for two quests), beside the health bar of EllesmereUI and other replacement nameplates too: left or right of the bar, or above the name, as you choose.
- Rare and treasure spawns, dungeon entrances, flight masters, docks and inns can mark the map too. Every map icon is off by default and turns on under Map in the options; the arrow's target, its route and the regions the guide step's mobs and objects spawn in (shaded on the world map and the minimap) always show.
- NPC services and mailboxes on zone and city maps (Map > Rares, travel & zones > NPC services; off by default): class trainers and mailboxes, with repair, vendors, bankers, profession trainers, weapon masters and the rest one click away. A click sets the arrow there.
- A world map without fog of war, with coordinates and zone level ranges.
- The step's item glows in your bags (and in Baganator and BagSmith): the carcass, the seeds or the horn the step uses or has you collect.
- Hide the game's quest tracker (Options, Questing; off by default).
- The target list shows the step's mobs (or, with no mob, the NPCs it sends you to) with their portraits, what they drop for the step and your progress on its goal (3/8); click a name to target that one, or press the target button's key binding for the first one close by. A row's click marks and pings as the target button does. A row turns green while its mob is close. The list goes with the target button: it shows while the target button is on (Settings, Questing, Buttons, Targeting, or the Install's Targeting page) and has no switch of its own. It stands beside the target button, or under it when the buttons line up in a row, and takes the Buttons page's look. The small Polestar mark in the button's place moves the buttons; left-click it to fold the list to one row showing the mob that is close, right-click it for its settings; in Quick Keybind Mode, hover it to bind the target button's key. Target list style (Settings, Questing, Buttons, Targeting) makes it smaller: slim rows with a small portrait, the name and the count; names only, without faces; or portraits alone in a column or a row, each with how many are left, and the name of the one that is close beside its portrait (under or over it in a row). Portraits (3D or 2D) chooses the faces: 2D shows the game's flat portrait once you have seen that mob, and an icon for what you do with it until then. Simple target button (Settings, Questing, Buttons, Targeting) keeps only the button, which moves to the next name on each click. Its icon shows what you do with the one it targets next (a speech bubble, ! or ? for an NPC, a sword or a bag for a mob, a skull for an elite, rare or boss, or their face once you have seen them), with the name beside it in green, red or gold and small icons for the names after it.
- Mark what they target (Options, Questing, Buttons; on by default): the target button, a target list row's click and the step key put a raid icon on the mob or NPC they target — a skull on an enemy and a star on a friendly NPC by default, configurable — and pressing again never takes an icon off. Pinging it for your group is a separate switch, off by default. Either can be set to "A new one each press", so the last few targets keep theirs. Your party sees the icons. In a party you don't lead, only a mob or NPC with no icon yet gets one, so a mark someone else placed stays; in a raid it marks only when you lead or assist.
- New in Forever. Quests Forever added carry a small ∞ mark on their step, in While you're here, in the Codex and in quest tooltips (Options, Guide, Window, "Mark quests new in Forever").
- Bind the buttons from Quick Keybind Mode (Options > Keybindings > Quick
Keybind Mode, or an action bar addon's
/kb): hover the Target, quest item, Hearthstone, rare, bag or travel button and press a key (with Shift, Ctrl or Alt if you like), a mouse button or the wheel; Escape unbinds. While the window is open, the buttons the guide doesn't need right now show dimmed in their places, named, so you can bind them too, and go again when it closes. The window's Okay keeps the keys (for this character only if you tick its box), Cancel drops them. Nothing changes in a fight. - Key bindings (Options > Keybindings): all of Polestar's, the Recorder's included, have a Polestar section of their own, and the Options search finds each one by its name.
Party sync, waiting for the group, sharing a missing quest, the party panel, Sync to my guide.
Group play works only with party members who also run Polestar. On joining a party Polestar sends one small hidden hello; a member who answers is synced, and everything below but the chat line is about them. With friends who don't run Polestar nothing shows and nothing more is sent, apart from that line. Turn each part off under Options > Questing > Quests > Group; nothing of it runs solo or in a raid.
- Party sync: each member's count shows under the quest goals you share ("Ana 5/8", "Ben done"), and on a quest you took, which of them lacks it. It is on by default; the first time a party member's progress shows, Polestar says so once in chat. What goes out: quest IDs and counts, level, XP %, class and race, your step, your guide (and pack), your Polestar version, and which quests of the steps around yours you've handed in, as hidden addon messages to your party, never to chat. Up to v0.3.2 it was off by default and that choice wasn't stored, so if you had it off, 0.3.3 turned it on once (with a chat notice); turned off since then, it stays off.
- Another Polestar version: a party member on another Polestar version gets one line in chat per session ("Ana is on Polestar 0.3.6: your guides can differ."), since the steps and quests of a guide can change between versions. Two players on the same version still see different steps when their class or race differs: each sees only the steps for their own.
- Wait for the group: when you finish an objective a party member on the same quest still needs ("Waiting on Ana: 3/8 Boar Ribs"), the step and its turn-in wait for them (nothing is handed in automatically meanwhile), and the arrow leads to the nearest place they still need. "Everyone's ready" shows once they are done. A member in another zone, or offline for more than 2 minutes, doesn't hold you, and the guide window's party line offers "Go on without them".
- Share a missing quest: a Share button on the goal of a quest you have that a member lacks, using the game's own sharing. When Polestar knows why they can't take it, it says so ("Ben (level 8, needs 10)", "already done": the game said so, or they handed it in near their step). A member whose class or race can't take the quest isn't named at all: their guide never has it.
- Party panel: a small movable panel that opens by itself the first time
another Polestar member in the party is heard, with each one's level and
XP, the step they are on, what they still need of yours, and whether they
are dead, far away or offline. Click a name to point the arrow at them
where the game gives their place on the map. Close it and it stays
closed; a click on the guide window's party line or
/polestar partybrings it back (and says why when nothing can show yet). Without a Polestar member in the party it stays hidden. - Sync to my guide: the party panel's "Sync to my guide" (or
/polestar party sync) asks your party to move to your step. Each member who runs Polestar gets a prompt, never an automatic move, that names the quests the move passes they haven't done and the ones they did already. Accepting opens your guide (in a new tab when needed) and moves them to your step by the step itself, not its number; their ticks and skips stay, and Undo takes it back. Declining changes nothing. Once every 30 seconds. - Loot a friend needs: "Ana still needs 2 Scalding Mornbrew" under a collect goal, and on a loot window or roll with a quest item a member still needs and you don't, "For Ana: she still needs 2". Nothing is passed, rolled or said for you.
- Tell my party (on by default): the one part everyone in the party sees, Polestar or not. Party chat lines that start with the Star raid icon and the quest's link: "Polestar: [Plagued Lands] Plagued Hide 5/5, Rabid Wolves 8/8" for objectives you finish (those within a few seconds in one line), "Polestar: [Plagued Lands] is ready to turn in", and, when you loot an item that starts a quest, "Polestar: looted [Mysterious Letter], which starts [The Dark Iron War]". Nothing for what was already done when you log in, reload or join, and never the same line twice. During a boss fight, while the game holds chat back, a line waits up to two minutes. The first line says once where to change it. Party members with Polestar see Polestar's star on these lines; your own stay out of your chat unless you turn "Show my own lines in my chat too" on. Also under Options > Questing > Quests > Group: the loot line, hiding other players' Polestar lines, and "Only when someone in the party doesn't have Polestar".
Upgrade arrows on tooltips, quest rewards and bags, with your own stat weights.
- Upgrade indicator on item tooltips: by how much an item is an upgrade
for your spec at your level, from stat weights per spec (detected from your
talent points) and level band, with health, mana, haste, expertise and
armor penetration worked out from the game's formulas at your level
(how each weight is made). Forever's ratings (crit,
hit, haste, expertise, armor penetration, dodge, parry, block) count at the
game's rating per 1%. The line under it says which weights it scored with
and where they came from ("Scored for Arcane, from your talents"). Click a
turn-in step's reward pick, or the line beside the game's reward panel
heading, to choose other weights (Settings > Questing > Rewards & gear >
Stat weights);
/polestar gear specshows how Automatic read your talents. - With Forever Leveling BiS installed, gear advice takes its answers through its public API while Stat weights is on Automatic: from its version 1.2.9 its gains (in its own score points, "+6.1 (+8%) upgrade"), scores and the spec it scores for ("Scored by Forever Leveling BiS (Arms)"); before that, its upgrade arrows in your bags. Turn it off under Gear advice ("Use Forever Leveling BiS when installed").
- On the game's reward panel every choice that is an upgrade gets a green arrow, the one to take is framed, and a coin marks the one that sells for most. Turn-in goals name the best reward, and a quest you are about to accept shows its reward when it is an upgrade.
- In your bags every item that is an upgrade gets the same green arrow, in the game's bags, in Baganator, BagSmith and EllesmereUI Bags. With Pawn installed, "Leave bag arrows to Pawn" hides Polestar's.
- Your own stat weights: paste a Pawn scale string (Options, Questing,
Rewards & gear, or
/polestar gear import) and choose it under Stat weights as "Custom: ". It replaces the built-in weights at every level. One window lists your scales for every class: use, rename, export or delete them, change their weights, and start one from a built-in spec. - Adjust the built-in weights: Options, Questing, Rewards & gear, Adjust
weights (or
/polestar gear adjust) lists your spec's weights. Change any stat, or add one; a changed stat is marked with a dot and can go back on its own (its reset button names the default), and Revert to default puts every weight of the spec back. A change is kept as a share of the default, so it carries over when Polestar's defaults change, and the spec reads "(adjusted)" in the menu and on tooltips.
Where anything comes from, every dungeon's quests, rare alerts, and the Characters page.
- Lookup searches guides, items, mounts, pets, NPCs, quests, zones, dungeons and rares, and answers "how do I get that?" with the sources ranked for your character. "Guide me" opens the curated guide or builds one on the spot. Target or mouse over a player to see their mount and how to get it; Alt-click an item link for a guide.
- Dungeons: a journal page per dungeon with every quest (where it starts and ends, its objective, chain and rewards), the bosses and the entrance. Each dungeon shows its level range and group size as the game's Group Finder lists them, and the level it's best at ("35–47 · best at 43"); For your level puts the ones that suit you first and marks the rest "Tough at your level", and the hub says what fits your level and when the rest unlock ("N now · M at level X"), with a chat line and a map pin when you reach one. Hovering a dungeon's level chip shows the XP its quests give and the levels they span. City dungeons belong to their own faction only. Quests that belong to a dungeon carry a dungeon glyph in every guide. "Pick up the quests" builds a guide that collects every quest of the dungeon you can take, prerequisites in the order that suits the road, on the shortest path from where you stand to the entrance; after the run, "Hand in the quests" guides you to where they are turned in, starting from the givers nearest the way out, and takes the follow-ups there. Profession quests are left out when you lack the profession.
- Rares: rares and treasures by zone with their spawns and signature drop, and an alert when one shows up on your minimap, nameplates or target. A Rare button appears under the Target button when Polestar spots a rare nearby and targets it by name (Options, Questing, Buttons, Rare button).
- Characters (
/polestar alts): every character on the account with its level, zone, guide, gold and an estimate of its rested XP.
Lookup, Dungeons and Rares read the Codex, a data pack that ships in the
release as Polestar_Codex. Without it Lookup still searches the guides, and
each section says what is missing.
Polestar's looks, the game's looks and nine skins, colour schemes, the settings window, Install, Profiles and EllesmereUI.
- Looks and skins (Settings > Look > Theme): Polestar's own looks (Polestar, Halo and Hearth), the game's looks (WoW Forever, Blizzard and Classic, each with its own arrow and map pins) and nine skins that ship in the download, each a small addon that loads only when you pick it: Vellum (a page of the quest log, dark ink on parchment), Lumen (dark glass with a cyan line), Beacon (high contrast, bigger type, arrow and pins), Aurora (northern lights over a deep night), Hairline (single hairlines and light type), Umbra (dark mode), Waymark (chart paper with a compass rose), Lanterns (ten two-colour moods) and Sheen (glass and gloss). Every look was checked at 0.64, 1.0 and 1.5 scale. Other addons can add skins and colour schemes through the Skin API (docs/SKINS-API.md).
- Color schemes: Dusk (the default), Night and Graphite, and EllesmereUI's own panel color and accent while it is installed. On top of any scheme: your own accent or your class color, background color, opacity and brightness. Text stays legible whatever you pick: a ground too light for its text is darkened until it reads.
- Windows: the border, its color and thickness, the starlit header band and the shadow, each on or off; the guide window's style (standard, compact or transparent), scale, width and opacity; the menu scale; the arrow's style, scale, opacity and colors; reduced motion. Everything applies live, without a reload; right-click any setting to reset it.
- The settings window, resizable, in four groups: Guiding (Guide, Map,
Questing, Discovery, Quality of Life), Look (Theme, Guide window, Arrow,
Map pins, Route lines, Buttons, Alerts & toasts, Trackers), Setup
(Profiles, Integrations, Community guides, Gamepad) and About. Every Look
page opens on Essentials, presets drawn as picture cards, with a live
preview: click a part of it to find its settings. The search understands
questions in every language Polestar speaks ("how do I hide the arrow?",
or
/polestar askwith your question). Reset page, per-setting reset arrows, Undo after any reset, typed values and favourite colours; Move frames puts every frame where you want it, with Revert and Save. The window loads the first time you open it. - Install: a new character's welcome, a page at a time (Questing,
Targeting, Groups, Your route, Your look), each choice working at once;
/polestar installopens it again. - Profiles are picture cards, each drawn in its own look; click one to
see who uses it and how many settings it changes before you switch, and
give a profile its own key (
/polestar profile <name>switches too). The Share tab picks exactly which parts of a profile to give or take, and previews what a pasted string would change. - Fonts: the game's own by default, or Inter, or EllesmereUI's.
- EllesmereUI (Options, Integrations): Polestar follows its accent and font by default through its public skinning API, and where its Quality of Life or Friends module does the same job as a Polestar toggle, the toggle starts off.
- ErgoBars offers the same skinning API: without EllesmereUI, Polestar follows its accent, and its panel color and font when you pick them, the same way.
Quest item, target and Hearthstone buttons, XP per hour, selling greys and repairing, training, the best quest reward, instant quest text, answers to summons and invitations; Shift skips any of them once.
Quest item, target and Hearthstone buttons; an item you loot that starts a quest you can take shows on the quest item button, glowing, until you read it (the step's own item comes first); inside a dungeon or raid the quest tracker shows only that instance's quests and gives you your list back when you leave; a hearth step while your Hearthstone is on cooldown says how long until it is ready and points the arrow at the inn; XP per hour and time to level; how long the campfire's Boosted Rest lasts and the Cozy Sleeping Bag's cooldown, and your party's Boosted Rest in the party panel; the level the guide wants you to reach, marked on the game's XP bar; selling grays and repairing (optionally from the guild bank first); buying what a step of Polestar's own guides asks you to buy (a community guide's step names what to buy and leaves it to you); learning new spells at class trainers; taking the best quest reward and wearing rewards that are upgrades; instant quest text, single-option gossip and faster auto-loot; hiding combat error spam; flight map and death helpers, and releasing at once in battlegrounds; setting your home at the inn the guide names when you talk to its innkeeper (off by default). Requests from other players: accept summons, resurrections and friends' or guildmates' party invitations; decline other party invitations, guild invitations and duels (friends and guild excepted). Hold Shift to skip auto-accept, auto-turn-in, auto-sell, training, binding or the flight helper once, or to answer a request yourself.
A card at login when a newer Polestar is out, and where Polestar learns of one.
Many problems players report are already fixed in a newer Polestar, so Polestar says when one is out. At every login, ten seconds in, a card on the guide window says "Polestar 0.4.1 is out", which version you're on and how to update: with Polestar Client installed, that it can do it for you; else the CurseForge app, Polestar Client or the zip. What's new gives you the release notes' link to copy; Got it keeps the card away for a day. A line in the guide window ("Polestar 0.4.1 is out: you're on 0.4.0.") stays until you update; its Update brings the card back. Two or more updates behind, both say so, the line can't be closed, and the card still shows once a day with its option off. The card never shows in combat, in dungeons or in the first two minutes of a fresh install. Turn it off under Options > Guide > Window (Tell me when a newer Polestar is out).
Where Polestar learns of a newer release: Polestar Client, after each of its checks for updates; party members running Polestar (the version party sync already sends); guild members running Polestar; and other players of your faction you meet. For the guild, Polestar sends one hidden hello with only its version number when you log in (at most every half hour), and a guild member on a newer release answers with theirs. For players you target or mouse over (not in your group or guild), Polestar sends one hidden addon whisper with its version number: at most once a week per player, once every 30 seconds and 10 times a session, never in combat, dungeons, cities or inns, and none once it has heard of a newer release. Their Polestar answers once with its own (at most 20 answers a session). A newer version heard only this way counts once two different players have answered with it. Nothing goes to chat. Turning party sync's sharing off stops all of these; Ask other players' Polestar which version it is (under it, on by default) stops the whispers alone. With no source at all, a Polestar first run three weeks ago or more says, in the guide window only, that updates come often.
Every Polestar action on a gamepad, with its own options and bindings.
Polestar plays with a gamepad on Forever (ported from Ding! by Yendi,
@moust4ki). Open its options from the minimap button (or /polestar gamepad without the game's gamepad interface): their Gamepad page names
the buttons (Xbox letters or PlayStation shapes, read off the gamepad by
default), and its Key bindings tab binds every Polestar action: next and
previous step, browse the guide, show or hide the guide window, hide or show
all of Polestar, the guide menu, the options, report a problem, and the quest
item, target and Hearthstone buttons. Nothing is bound until you bind it.
Press A on a row, then a button, or hold one button and press another for a
combination: Polestar watches its combinations itself, keeps the second
button from the game only while you hold the first, and never acts on one in
a fight. With the game's gamepad interface on, LB and RB are its targeting
buttons and every combination with them is the game's own: the row says so
before it binds one. Tap B to cancel, hold B to bind B itself; Y unbinds. The
rows take keys of the keyboard too.
The guide window never takes a button away from the game. To browse it with the gamepad, bind Browse the guide with the gamepad: the D-pad picks a line (up from the goals: Skip, the bug, the menu and the tabs), A points the arrow there or uses the quest item on its line (not with the game's gamepad interface, whose own buttons Polestar leaves alone), X shows the line's details, LB / RB look at the previous and next step, Y minimizes the window, and B gives the gamepad back to the game.
Every Polestar window you open (the guide menu with Lookup and Dungeons, the options, Install, the route choice, the report and copy windows, the drop-down menus) answers the gamepad while it is open: the D-pad moves the focus (an accent ring), A selects, B closes or goes back, LB / RB change tabs or pages, left / right adjust a slider or a drop-down, Y puts a setting back to its default. A window that opens by itself (Install on a new character, the choice of where to level next) takes no button until you press the Browse the guide button, which its bar shows. A bar under the window lists the buttons no button on screen shows; B sits on the window's close button. The gamepad goes back to the game when the window closes or a fight starts, and returns after it. Turn the bar off, or the windows' navigation altogether, on the Gamepad page. Without a gamepad plugged in, none of it shows: everything works with the mouse and keyboard as before.
The optional recording program: what it records, and how to turn it off.
Polestar_Recorder is an optional companion addon that records your play
for the recording program, to improve the routes. It records while sharing
is on in the Polestar Client (on by
default there, unless you stop it or type /psrec off); without the Client
it is off until you turn it on (/psrec on, or Options > Recorder), and it
writes nothing while off. It writes
compact chunks with no character, realm or account names, and records what
the guides need most: kill pace and kill XP, drops counted against what your
quests still needed, which quests each NPC offered you, trainer and vendor
lists, flight times, item uses and gossip choices
(docs/RECORDING.md, field by field). In Forever's new
zones and dungeons its explorer mode maps more on its own (creature spawns,
the quest log's map points, dungeon floors, boss pulls, objects opened),
nothing more about you; /psrec explore off turns it off, and Polestar
Client 0.1.6 or later sends it. Recordings replace
estimates with Forever facts, feed the Codex what only play shows, and
record report turns them into per-step timings: passes, median and p75
time, XP per hour, time in combat, deaths and travel, then the slowest
steps and detours, the steps to fix first.
/polestar (or /pole, /ps) shows or hides the guide window; settings live in
/polestar options (or /ps options, or right-click the game menu's Polestar button), in four groups:
Guiding (Guide, Map, Questing, Discovery, Quality of Life), Look (Theme,
Guide window, Arrow, Map pins, Route lines, Buttons, Alerts & toasts,
Trackers), Setup (Profiles, Integrations, with settings for other addons
Polestar works with such as Questie while they are installed, Community
guides, Gamepad) and About (Guiding Stars, Recorder, About), with a search
that finds any setting.
With the game's gamepad interface on (Options, Gamepad, Enable Gamepad UI) there are no slash commands: the game blocks gamepad actions after any addon command typed in chat, until the game freezes. Polestar's minimap button (on by default) and its key bindings open the guide and the settings instead, and Polestar keeps out of the game's own windows.
Every slash command
| Command | What it does |
|---|---|
help |
List every command |
show |
Show the guide window, and Polestar with it when it is hidden. /polestar alone shows or hides the window, with the action buttons and the rare and transport alerts; the arrow too only with Hide the arrow with the guide (Options, Guide, Arrow & routes), and never the arrow back to your corpse or a Spirit Healer |
hide |
Hide everything Polestar shows, or bring it back, as a click on the minimap button does; hide arrow turns Keep the arrow when hidden on or off |
guides |
Open the hub on Guides |
options [page] |
Open the settings, optionally on a page |
ask <question> |
Open the settings on the answer to a question in your own words (/ps ask how do I hide the arrow?): the question in the search box and the settings it finds under it |
next, prev |
Look at the next or previous step (nothing is skipped) |
skip |
Skip the step shown, for good (the window offers Undo) |
status |
Current guide and step |
guide <id> |
Switch to a guide by id |
tabs, tab <n>, close |
List, switch and close guide tabs |
reopen |
Reopen the last guide tab you closed |
path |
Choose where to level next, where a guide offers a choice of route |
route |
Show the travel route to the current target |
skipleg |
Skip the travel route's current leg (a Hearthstone, flight or portal: plan the rest without it; a walk or lift: mark it done) |
near <service> |
Point the arrow at the nearest trainer, class trainer, repair, reagents, vendor, innkeeper, bank, mailbox, auction house, flight or stable master |
way <x> <y> [label] |
Point the arrow at x y on your current map (no argument clears it) |
arrow show|hide|reset |
The waypoint arrow (drag it to move it); while the guide hides it (Hide the arrow with the guide) or Polestar is hidden, these commands, way and near say so |
unlock, lock |
Move Polestar's frames: a box over the guide window, the arrow, the buttons, the alerts and the trackers to drag where you want them, with a grid and snapping; arrow keys nudge the one you clicked, right-click puts one back. unlock again, lock, Escape or a fight locks them |
reset |
Clear ticks and skips for the current guide |
pause [on|off], resume |
Pause the guide: the arrow, the guide window and its nudges step aside, and it resumes by itself when you leave the dungeon alive; resume ends it early |
xp |
XP per hour, time to level and level splits |
bags |
Free bag slots and the cheapest junk |
restock |
Amounts to restock at merchants: drink, food, ammo or an item |
questlog |
List the quests in your log the route never hands in, each with Abandon |
materials |
Show how the profession guide gets its materials (the Materials window) |
ah |
Show the quest items and materials to buy at the Auction House |
party [debug] |
Show or hide the party panel: each party member who also runs Polestar (level, step, what they still need); debug prints what party sync sends and hears, for a report |
gear [item link] |
Gear advice: the weights in use, or compare an item |
gear import [string] |
Import a Pawn scale: opens the paste box, or imports the string given |
gear scales |
Open the window that manages your custom stat-weight scales |
gear adjust |
Open the window that changes your spec's built-in stat weights |
instances [clear] |
Instance limits, runs and lockouts |
dungeons [name] |
Open Dungeons, or a dungeon's page |
dungeontoast [dungeon] |
Show the dungeon heads-up again (the next one due, or a dungeon) |
classtoast [quest id] |
Show the class quest heads-up again (the next one due, or a quest id) |
lookup [search] |
Open Lookup, optionally searching |
mount |
Look up the mount of your target (or mouseover) and how to get it |
alts |
Open Characters: every character on the account |
rares [test] |
Open Rares, or show a sample rare alert |
talents |
Open the Talents section (talent plans: coming soon) |
questdb |
Quest database status |
packs |
Open Options > Community guides |
import |
Open the Import page: paste a shared guide string to save it without installing an addon; import clear or import delete to remove it |
gamepad |
Open Options > Gamepad: button names and key bindings |
install |
Set Polestar up again, a page at a time (Install) |
welcome |
Opens Install, as install does |
profile [name] |
List your settings profiles, or switch to one |
whatsnew |
Show what's new in this version |
where |
Print your map and position as guide lines (zone map <id>, goto x,y live), in a box to copy |
report |
Report a problem with the step on screen (the guide window's bug button) |
update |
Show the update card when a newer Polestar is out (else whether this one is the newest, when Polestar Client says so) |
discord |
The invite to the Polestar Discord, to copy |
memory |
Each Polestar addon's memory as the game counts it, before and after a full garbage collection: the game's figure includes garbage not yet collected, the figure after is what Polestar keeps (for a report) |
debug |
Toggle debug output |
The Recorder has its own: /psrec on | off | ui | mark <text> | trail on [label] | trail off | clear and a few more listed by /psrec. /psrec trail on Brill records a dense position trail (a point every yard, height
included) until /psrec trail off or 30 minutes; record trail <session>
writes it out. /psrec ui (or Options > Recorder > Recorder window) opens a
small window with the same controls, a key binding for the trail, and a
checklist of the spots we need walked.
Every command with its help line, every option and every key binding are on polestar.guide's reference.
- The docs answer most questions: installing, the guide window and the arrow, community guides, the FAQ, and every slash command and option.
- A wrong step? Click the bug in the guide window (or
/polestar report) and post the report in #bugs on the Polestar Discord, or open it on GitHub from the same window. What makes a good report is in CONTRIBUTING.md. - Questions, ideas and feedback are welcome on the Discord; a feature request goes in an issue.
- A security problem goes in a private report, never an issue: SECURITY.md.
flowchart LR
game["The game's data<br/>+ corrections"] --> data["Reference<br/>data"]
data --> world["World model<br/>solo, elite and group quests"]
world --> walks["Walks<br/>priced on the maps"]
walks --> routes["Route search<br/>one route per faction"]
fixes["Player reports<br/>kept as fix records"] --> routes
routes --> guides["Guides<br/>written from the route"]
guides --> check["Route check<br/>played like a player"]
check --> legs["Walking legs<br/>for the arrow"]
legs --> addon["Polestar_Guides"]
Each race has its own starting zone (to about level 11 to 14, the Skyborne to about 15); from there one Horde route runs from Silverpine Forest and the Barrens and one Alliance route from Westfall to 60, written once per faction and played by every race of it, both through the Riverglades and Shen'dralas (The route, guide by guide).
The routes began as the work of Polestar Forge, one program (forge build) that runs every
step from the installed game to checked guides (docs/FORGE.md):
- Reference data. Forge reads the game's own tables from the installed client, Forever's quest data and our corrections into the facts every tool uses: quests, givers and enders, objectives, spawns, items, travel (data).
- World model. Every quest the faction can take, with its level, prerequisites and the work its objectives take: kills at the mob's camps, item drops at their rates, objects, escorts. Elite and group quests are in, sized from the game's creature data, each with a solo way past: a player who skips one grinds to the route's level there instead, and the guide gives grouping tips. Quests that start from a rare drop are optional extras the route does not count on. Dungeon, raid and PvP quests are left out.
- Walks. Every walk a route may take is priced on the terrain, with Leffe's navigation maps where they cover it and Polestar's own walking grid elsewhere (nav).
- Route search. Starting from the order players knew, the search reorders, adds and drops quests, from moving one stop to rebuilding a whole stretch, and keeps a change only when every step stays possible: the quest is available, the flight path is learnt, the hearthstone is ready, the quest log has room, and every fix from a player's report holds. On a shared route a change is kept only when no race gets slower (routes, model).
- Guides. The writer turns the route into the guides: one shared route per faction, each town done in one sweep through its quest givers, class training and weapon masters on the way, hearths an hour apart and a travel line for every flight, boat and portal (writer).
- Route check. The written guides are played the way a player follows them, for every race and class, and a step that can't be done as written is refused: a quest taken before it is available, a flight to a flight path not learnt, an item used before its quest, a hearth on cooldown, a trip made twice, a town left with work ready there (judge).
- Walking legs. The walk into every step is worked out once and shipped with the guides, so the arrow follows it at once.
Since 0.4.0 the routes are tuned by hand. Both factions' routes were walked through again zone
by zone, and every change is a hand edit of the guide with its record beside it
(data/route-fixes.json, data/guide-fixes.json and our corrections), so a later Forge build
keeps it; the leveling guides carry Forge's header and guides/GENERATED.json lists them
(docs/FORGE.md, "Fixing a generated guide"). Forge still
builds the data, the walks and the walking legs, the level model and the checks. A change is
weighed in this order:
- Mobs at your level. The aim is that a solo player is not sent at mobs 2 or more levels above them; one level above is fine, with a "Careful" tip where they pull together. A quest's own level doesn't count, and an elite that isn't a group quest becomes a group choice or the route goes round it. Your level at each step comes from the level model, which counts rested experience, checked against players' recordings where enough players passed there.
- Flow. No walking back over ground you just left, quests handed in where the route passes their giver, a quest picked up now when the route passes its giver and done on a later visit, class training on stops you already make.
- Questing over grinding. A gap in experience is filled with quests from every zone the faction can reach; what is left is a short top-up on a camp at your level, and every grind step suggests a dungeon that fits you.
- Time, last.
The evidence is our own: walking distance and direction, levels, quest data, players' recordings, the flow audit (docs/ROUTE-FEEL.md) and the level model. Every quest a route leaves out is listed with the reason, so a missing quest is a question with an answer.
Every leveling guide is checked the way a player follows it before it ships, for every race and
class: the route check, the danger gate (node tools/danger-gate.js: mobs above your level
around a goal or a grind), the reported-problems gate (npm run test:reported: every fixed player
report stays fixed) and the flow audit. In our route tests for 0.4.0 (simulated 1 to 60 runs
counting rested experience, against 0.3.7.2 with the same model), hours to 60 went from 134.7 to
127.5 for the Alliance and from 127.4 to 120.9 for the Horde, and spots with mobs 2 or more levels
above you from 106 to 58 and from 102 to 47. These are estimates, not a stopwatch on a real
character, and players differ a lot. Polestar is not a speed-leveling guide: the aim is a route
that makes sense to play, with nothing pointless in it.
Forge's model is in docs/forge/model.md and the route check in docs/forge/judge.md. The routes of releases up to 0.2.x came from an earlier JavaScript simulator, described in docs/legacy/SIMULATION-js.md.
Guides are plain text, compiled to Lua. The compiler fills in names, titles
and coordinates from the reference data, so a line can be as short as
accept 788. From the Orc starting guide,
guides/forever/horde/orc/01-durotar.guide:
guide forever/horde/orc/01-durotar
title Durotar
faction Horde
race Orc
levels 1-12
zone Durotar
next forever/horde/03-silverpine-forest
step Kaltunk
accept 4641 -- Kaltunk, where you start
tip Gornek waits inside the Den, the building just west of Kaltunk.
turnin 4641 -- Inside
accept 788
accept 97279
accept 1485 only Warlock -- Ruzan
step Training weapons and boars
tip The weapons lie around the Den and the training grounds; the Mottled Boars roam the whole valley floor.
kill 3098 quest 788.1
collect 277653 quest 97279.1
goto 42.4,68.6 "The Den"
The second step compiles to (goals wrapped and spawn lists cut short here; the compiler writes each goal on one line):
{
title = "Training weapons and boars",
note = "The weapons lie around the Den and the training grounds; the Mottled Boars roam the whole valley floor.",
goals = {
{ t = "kill", quest = 788, title = "Cutting Teeth",
target = "Mottled Boar", npc = 3098, count = 10, oi = 1,
map = 1411, x = 42.72, y = 71.58, z = 40.3, f = "e",
spotsPacked = "42.4,72.1,,56,6;44.3,71.2,,54,6;..." },
{ t = "collect", quest = 97279, title = "Wayward Weapons",
item = 277653, itemName = "Abandoned Training Weapon", count = 6, oi = 1,
map = 1411, x = 43.2, y = 71.7, f = "e",
spotsPacked = "43.6,72.4,,54,4;44.3,70.8,,21,2;...",
from = "Abandoned Training Weapon", fromKind = "object", fromId = 673476 },
{ t = "goto", text = "{object:3227}", map = 1411, x = 42.4, y = 68.6, f = "e" },
},
},Every verb, modifier and condition is in docs/GUIDE_FORMAT.md; guides of your own ship as a community addon.
This part is for working on Polestar itself: players need only the Quick start, guide authors the Community guides section. docs/README.md maps every document, and CHANGELOG.md lists what changed in each release.
Polestar has two command lines. forge (Rust, in rust/; build it
with cargo build --release -p forge there, or take a prebuilt one from
the Releases page) builds the data, the guides, the walking maps and the
releases: forge guide compile|lint|check, forge data ...,
forge nav pack|check, forge release ... and forge changelog. The old
node tools/polestar.js compile, lint, data, release and their
neighbors only print the forge command now. node tools/polestar.js
keeps the contributor tools that have not moved yet: playtest, find,
record, new, dev, install, play, preview and the planner.
Node 24 or later (no npm dependencies) and Lua 5.1 (lua5.1, luac5.1) for
the tests. Building the data needs a local Forever client: it reads the
client's tables and installed addons.
forge data build --kb # reference data into data/forever/ (local)
forge data questdb # the Polestar_QuestDB pack
forge guide lint # check every guide
forge guide compile # build addon/Polestar_Guides
node --test "tests/**/*.test.js" # the test suite
node tools/polestar.js preview # render the UI to docs/preview/*.svg
node tools/polestar.js install --recorder # into a detected Forever or beta client
forge release version # the release version in package.json, guides/pack.json and every addon TOC
forge release pack # release zips and SHA256SUMS into dist/npm test runs the suite. CI runs it on every
push to main and every pull request, where the tests that need the locally
built data skip with a reason, and fails when the committed textures or UI
renders differ from a fresh media or preview build; with the data built,
all pass locally. install
finds the client under Wine, Proton and similar prefixes in your home folder,
or takes $WOW_FOREVER_ADDONS or --dest <Interface/AddOns>; --link
symlinks the folders instead, so an edit needs only a /reload.
Releases are built on a maintainer's machine, because the data addons come from the game client's tables: docs/RELEASING.md has the steps and what each zip carries.
forge --help and forge <command> --help list Forge's commands and
options; node tools/polestar.js help lists the Node ones and
help <command> their options; tools/README.md groups
them, lists the generated files and gives the rebuild order after a data
change.
Polestar Forge: making the routes
cd rust && cargo build --release -p forge && cd .. # or a prebuilt forge from the Releases page
rust/target/release/forge doctor # what it finds: the game, the data, the maps
rust/target/release/forge build --guides guides --out forge-outForge reads the installed game, builds the data and the walks, searches every start's route, writes
the leveling guides (one shared route per faction) and plays them through the route check:
forge-out/report.md and check.md say what changed and what a player would trip on. Since 0.4.0
a Forge build only advises on the routes: the shipped leveling guides are tuned by hand
(How the routes are made), and Forge builds the data, the walks, the
walking legs, the level model and the checks. Without a maintainer's data/sources,
forge data fetch downloads the public data pack first. docs/FORGE.md is the
guide.
The playground: the real addon in a browser
node tools/polestar.js play # prints http://127.0.0.1:8077/
node tools/polestar.js play --fresh # a new level 1 character, default settingsOne long-lived Lua 5.1 process runs Polestar, its guides and the built data
packs against the simulated world of the tests. The page shows a 1920x1080
game screen with the hub and the guide window; click, hover, scroll, drag,
type into search boxes and run slash commands from the chat line. A side
panel sets the look, jumps through a guide, opens any window and changes the
character, position and time. Zone paintings come only from a local folder
of your own client's art (--art); without it the world is dark.
The route planner: guides played on the real map
node tools/polestar.js planner art # once: the map art (~330 MB downloaded, ~250 MB built; local only)
node tools/polestar.js nav build # once: the navigation grid for terrain-aware walks (~750 MB, ~15-25 min; local only)
node tools/polestar.js planner # prints http://127.0.0.1:8078/
node tools/polestar.js planner mcp # the same commands for an AI agent (MCP over stdio)The planner is Nivek_Gaming's idea (@Nivek_Gaming on X): his route planning inspired this tool and the navigation grid behind it. Thank you, Nivek.
Pick a guide and a character and the route plays on the game's own minimap
terrain, zone by zone or as the whole 1-60 route across the continents: each
step's start time and duration split into travel, combat, talking and
waiting, the level and XP, the quest log and items, the spawn areas and the
path. The clock is the simulator's model (docs/legacy/SIMULATION-js.md),
so treat absolute hours as estimates and compare steps against each other.
With the navigation grid built (node tools/polestar.js nav build, local
only) every walk follows the terrain, the walks between mobs in a kill area
too: around mountains, into caves and buildings, swimming, dropping off
ledges, mounted from level 40, at the speed of the character's class (Ghost
Wolf, Travel Form...). Flights follow the flight master's real path. The
first playback of a route shows straight lines while its walks are routed in
the background ("Routing…" in the footer), then "Routed N of M legs" (and
the hops between spawns); routes are cached under data/local/nav, so the
next start is immediate. A walk the grid cannot route stays a straight line,
marked ≈ in the steps list.
Layers adds Walkable (what the grid can walk: blocked, steep, climb, water,
indoors, zoomed in) and Arrow aids (the crossings and approach chains of
nav aids).
In Edit mode, drag a waypoint, add one with a click, bend a travel line into
a new labelled waypoint ("Cross the bridge"), or change any goal or
step in its form: every edit is written into the .guide file at once
(undo with Ctrl+Z; Changes lists and reverts them; Compile builds the addon
folder), so dev picks it up too. Given a pack folder it edits that pack;
planner mcp lets an assistant read routes, edit them and drive the open
page while you watch (claude mcp add polestar-planner -- node tools/polestar.js planner mcp).
The map art is the Forever client's own, fetched from wago.tools and never
committed or shipped.
Measuring routes with recordings
forge record import # the Recorder's chunks -> data/recordings (forge record pull: the server's)
forge data build --kb # fold recordings into the reference data
node tools/polestar.js record report # how long each guide step really tookrecord report [--guide <text>] [--json] lists, per step, passes, median
and p75 time, XP per hour, time in combat, deaths, turn-ins and travel, then
the slowest steps, steps far over the guide's median and detours. Reloads,
AFK breaks (idle time counts at most 5 minutes), going back a step and other
tabs are accounted for.
Forever's new zones (the Riverglades, Shen'dralas, Mount Hyjal) were mapped this way: the Recorder's explorer mode records spawns, quest map points and objects there, and their guides are written from Forever's quest data and these recordings.
| Path | What lives there |
|---|---|
addon/Polestar |
The addon: engine, navigation, UI, modules, textures drawn in code (addon/README.md; every addon: docs/ARCHITECTURE.md, "Overview") |
addon/Polestar_Guides |
The compiled guides (generated by compile); the per-faction and per-race parts (Polestar_Guides_Alliance, Polestar_Guides_Human, ...) load on demand for your character |
addon/Polestar_Options, addon/Polestar_Looks, addon/Polestar_SkinAPI |
Loaded on demand: the settings window with its looks pages and previews, the WoW Forever, Blizzard, Classic and Hearth looks, the checks for skins from other addons |
addon/Polestar_Skin_* |
The nine skins that ship (Vellum, Lumen, Beacon, Aurora, Hairline, Umbra, Waymark, Lanterns, Sheen), each its own addon loaded when picked; Polestar_Skin_Example is the Skin API's example and never ships (docs/SKINS-API.md) |
addon/Polestar_ItemDB |
Item stats for gear advice: Items.lua from forge data itemdb, Forever.lua from forge data gear |
addon/Polestar_Nav |
The arrow's walking routes: Polestar's walking router, started from Shortest Path Forever's by Cillian Berragan (GPL-3.0-or-later), on Polestar's walking maps of Eastern Kingdoms, Kalimdor and Zephras Isle, grown from his format (nav pack; CREDITS.md) |
addon/Polestar_Recorder |
The optional session recorder |
guides/forever |
The guide sources: leveling (with the Riverglades and Shen'dralas), class, professions, reputation, exploration, Legacy, collectibles |
experimental |
Polestar Experimental's guide sources (Mount Hyjal), compiled into addon/Polestar_Experimental |
tools |
The command line (polestar.js), the guide compiler, the simulator, data importers, texture and preview renderers, the playground (tools/README.md) |
rust |
Polestar Forge, the Rust pipeline behind the data, the walks and walking legs, the level model, the route checks, the guide compiler and the releases: one forge program (docs/FORGE.md) |
apps/client |
The Polestar Client, the desktop app that installs and updates the addons and community guides and sends recordings (apps/client/README.md) |
services/ingest |
The recording program's server: it checks and stores the chunks the Polestar Client sends (services/ingest/README.md) |
tests |
node --test suites; tests/lua is the simulated game client they run the addon in (tests/README.md) |
docs |
Architecture, guide format, Forge, the suite's scope, UI renders (docs/README.md) |
data/ |
Local build products and recordings, gitignored |
docs/ARCHITECTURE.md describes the modules and their contracts, docs/SUITE.md the suite and what is out of scope (best-in-slot lists, general loot browsing, talent builds), and docs/DESIGN.md the visual system.
Issues and pull requests are welcome, guide fixes most of all: a step in the wrong order, a quest that is not where the guide says, a tip that would have saved you a minute. Questions and ideas are welcome on the Polestar Discord.
- Found a wrong step? A guide's title names its file under
guides/forever/; fix the step, runforge guide lintandplaytest --filter <name>, and open a pull request. Without the reference data (built from a local client today), send the fix or an issue anyway: CONTRIBUTING.md has the full walkthrough. - Code follows the existing modules; read
docs/ARCHITECTURE.md first and keep
node --test "tests/**/*.test.js"green. - UI changes stay in the visual system of docs/DESIGN.md;
node tools/polestar.js previewrenders them for review. - Recordings are the most useful contribution of all: install the
Polestar Client (it shares by default) and play, or attach
record reportfor the steps that felt slow. - With an AI agent? It reads AGENTS.md in a clone. To have
Polestar's skills everywhere, install them:
npx skills add fitzforge/polestar -g, or the Claude Code and Codex plugins in CONTRIBUTING.md.
Contributions are accepted under the GPL-3.0, the project's license.
Polestar is free and open source under the GNU General Public License, version 3.
Its data comes from public sources, the game client's own tables and
recordings; THIRD_PARTY.md lists every input, its license
and what a release holds from it. The guides and the quest markers carry
facts (titles, givers, positions, levels) from QuestieDB's Forever store,
credited there. Inputs whose terms do not allow redistribution are read from
your installed copies at build time and their outputs stay local: a Codex
built with those extras (--local-extras) and the zone crossings pack are
never packaged; the Codex that ships is built from release-safe inputs only. No game
art ships with Polestar: zone paintings are read from the player's own
client, and every texture is drawn in code. The screenshots in this README
show the game (© Blizzard Entertainment) and are not part of the release.
The Inter typeface (SIL Open Font License 1.1) ships with the addon; the
POLESTAR wordmark is cut from Cinzel (SIL Open Font License 1.1) and ships
only as images. The README's banner, buttons, logo, charts and the
CurseForge avatar are drawn by tools/readme from the same sources, with
Marcellus (SIL Open Font License 1.1) for the banner's lines; the CurseForge
button's anvil is the CurseForge mark from simple-icons (CC0 1.0).
The walking router in Polestar_Nav started from Shortest Path Forever's, by
Cillian Berragan, and keeps his copyright in the files that began as his; its
maps of Eastern Kingdoms, Kalimdor and Zephras Isle are Polestar's, written in
a format grown from his by a port of his baker; all of it is under
the GPL version 3 or later, used with his permission
(see Pathing by Shortest Path Forever);
the guide-pack permission below does not cover them.
The walks baked into the guides are drawn on Leffe's navigation maps (and on Polestar's own maps where his have no way), used with Leffe's full permission; his map files are not part of the addon.
LICENSE-EXCEPTION.md adds a permission under section 7: guide packs produced by Polestar's compiler and import strings produced by its tools, including the reference data they place in them, may be distributed under terms of the author's choice (not guide text copied from Polestar's own guides, nor Polestar's code), and a second one for skin addons: an addon that changes Polestar's look only through the documented Skin API (docs/skins/) may be licensed as its author chooses.
World of Warcraft is a trademark of Blizzard Entertainment. Polestar is a community project, not affiliated with or endorsed by Blizzard.
















