# Polestar

> Polestar is a free, open-source (GPL-3.0) leveling guide addon for World of Warcraft: Forever. It ships 222 built-in guides (leveling routes from 1 to 60 for every race on both factions, class quests, professions, reputations, exploration, mounts and pets) with a 3D waypoint arrow that walks real paths to the next goal. Players also publish their own guides for it as community guides on polestar.guide.

How to use this file: the facts below come from the docs and the guide data this site is built from. Every page has a Markdown copy at its address with `.md` added, linked below; /llms-full.txt holds every player and author docs page in one file. When citing, link the page without `.md` (that is the page people read).

Key facts:

- Game: made for World of Warcraft: Forever. Polestar is a community project, not affiliated with Blizzard Entertainment.
- Cost and license: free and open source under GPL-3.0; every guide comes with the addon. Source: https://github.com/fitzforge/polestar
- Current release: Polestar 0.2.6, released October 19, 2026 (beta). What changed: https://polestar.guide/docs/reference/changelog.md
- Get it: the CurseForge app (search for "Polestar Guides"; https://www.curseforge.com/wow/addons/polestar), or `Polestar-<version>.zip` from the newest GitHub release under Assets (https://github.com/fitzforge/polestar/releases), or the Polestar Client (https://polestar.guide/client), a free desktop app for Windows, macOS and Linux (version 0.1.0, beta) that installs and updates Polestar and community guides. The client is optional.
- Install in 3 steps: 1. Install with the CurseForge app, or unzip the release into the game's AddOns folder so the Polestar folders sit directly inside it (`World of Warcraft/_classic_beta_/Interface/AddOns/` on the beta client, `_forever_` instead of `_classic_beta_` from launch). 2. Restart the game completely: a `/reload` does not load a new addon. 3. Log in: the guide window opens with a guide for your race, level and zone; follow the arrow and the goals tick themselves off.
- In-game commands: `/polestar` shows or hides the guide window (`/pole` works too); `/polestar guides` opens the hub (every guide, Lookup, Dungeons, Rares); `/polestar options` every setting; `/polestar skip` skips a step for good, while `/polestar next` and `/polestar prev` only look ahead or back; `/polestar talents` your talent plan; `/polestar path` choose where to level next; `/polestar report` report a problem with the step on screen; `/polestar help` lists all 36: https://polestar.guide/docs/reference/commands.md
- Guides: 222 built in, on shelves Leveling (57), Class quests (66), Professions (12), Reputation (17), Exploration (7), Mounts (27), Companion pets (33), Legacy and more (3). Leveling starts: Human (Alliance): Elwynn Forest; Dwarf (Alliance): Dun Morogh; Gnome (Alliance): Dun Morogh; Night Elf (Alliance): Teldrassil; Skyborne (Alliance): Zephras Isle; Orc (Horde): Durotar; Troll (Horde): Durotar; Tauren (Horde): Mulgore; Undead (Horde): Tirisfal Glades; Skyborne (Horde): Zephras Isle. Each faction's whole road: https://polestar.guide/guides/alliance.md and https://polestar.guide/guides/horde.md.
- Quick fixes: nothing shows in game: restart the game completely and check the Polestar folders sit directly in `Interface/AddOns`. No quest markers on the map: they are off until turned on under Map in the options. Wrong step in a Polestar guide: click the bug in the guide window (beside Skip), copy the report and paste it on the Polestar Discord, or open a GitHub issue. A problem in a community guide goes to its author.
- Community guides: guides written by other players and published as their own addons; install one beside Polestar and its guides show in the guide menu under Community guides. Polestar does not test or vouch for them. Browse and download them at https://polestar.guide/community; the Polestar Client installs them in one click; a small one can be shared as an import string.
- Writing guides: a guide is a plain-text `.guide` file; a community guide is a folder with `pack.json` and its `.guide` files, checked with Polestar's own tools (`polestar new`, `polestar lint`, `polestar playtest`) and published on polestar.guide, which builds the addon. Start at https://polestar.guide/docs/authors.md.
- Languages: the interface and guides read in 10 languages.
- Help: the Polestar Discord (https://discord.gg/polestar) and GitHub issues (https://github.com/fitzforge/polestar/issues).

## Docs for players

- [Start here](https://polestar.guide/docs/players.md): Polestar is for World of Warcraft: Forever. It is a free leveling guide: install it, log in, and follow the arrow.
- [Install and first run](https://polestar.guide/docs/players/quick-start.md): Install Polestar from the CurseForge app or a release zip, restart the game and follow the arrow.
- [What Polestar is](https://polestar.guide/docs/players/what-it-is.md): One addon for the whole of WoW: Forever: 222 guides, a waypoint arrow that walks real paths, and the tools around them.
- [Features](https://polestar.guide/docs/players/features.md): Everything Polestar does: the guide engine, navigation, quests and the map, gear advice, Lookup, Dungeons, Rares and more.
- [Talent plans](https://polestar.guide/docs/players/talent-plans.md): Polestar's leveling talent plans for every class and spec: pick one, follow the marks on the talent frame, and get a reminder when a point waits.
- [How the routes are made](https://polestar.guide/docs/players/how-routes-are-made.md): A simulator plays millions of complete 1-60 routes for every start and keeps the fastest; the guides are written from it.
- [Community guides](https://polestar.guide/docs/players/community-guides.md): Guides written by other players: install one, find its guides, turn it on or off, and know who to ask.
- [Import strings](https://polestar.guide/docs/players/import-strings.md): A small guide shared as one line of text: paste it into Import and it joins your guide menu.
- [Polestar Client](https://polestar.guide/docs/players/client.md): A small desktop app that installs Polestar's addons and community guides and keeps them up to date. Version 0.1.0, in beta.
- [FAQ](https://polestar.guide/docs/players/faq.md): Short answers to the questions players ask most, each with the page that tells the rest.
- [Using Polestar with AI assistants](https://polestar.guide/docs/players/ai-assistants.md): Give ChatGPT, Claude, Copilot or a coding agent Polestar's own docs, so it answers from them instead of from memory.

## Docs for guide authors

- [Overview](https://polestar.guide/docs/authors.md): Write leveling guides in plain text, test them in the playground and publish them as your own community addon.
- [Writing a community guide](https://polestar.guide/docs/authors/community-guides.md): What you get, what a pack looks like, the steps from your first guide to publishing, and the checklist before you do.
- [Handbook](https://polestar.guide/docs/authors/handbook.md): The full handbook: setup on each system, a first pack in 15 minutes, testing, publishing, updating, and every problem with its fix.
- [Guide format cheatsheet](https://polestar.guide/docs/authors/cheatsheet.md): The guide format on one page: every header line, goal and condition, with what it does and a short example.
- [Guide format](https://polestar.guide/docs/authors/guide-format.md): The .guide language in full: header, steps, goals, conditions, what the compiler fills in, validation and a cookbook.
- [Community guide format](https://polestar.guide/docs/authors/community-guide-format.md): The contract between a community guide and Polestar: pack.json, the addon the compiler writes, the rules, import strings, versioning.
- [Translating](https://polestar.guide/docs/authors/translating.md): The languages and their status, the locale file, formats, the glossary, the i18n commands, and adding or reviewing a language.
- [Writing guides with an AI agent](https://polestar.guide/docs/authors/agent-workflow.md): The polestar-guide-pack skill: the ground rules and workflow an AI agent follows to write, fix and build a pack's guides.
- [Guide format reference](https://polestar.guide/docs/reference/guide-lines.md): Every header line, step line and goal the guide compiler takes, with the modifiers each accepts.
- [Command line](https://polestar.guide/docs/reference/cli.md): Every polestar command of the toolchain, with its usage as the command prints it.

## Reference

- [Slash commands](https://polestar.guide/docs/reference/commands.md): Every /polestar command and its help line, from the addon’s command registry.
- [Options](https://polestar.guide/docs/reference/options.md): Every setting in the options window, page by page, with its default and what it does.
- [Key bindings](https://polestar.guide/docs/reference/bindings.md): Every key binding and gamepad action, and which take a chord.
- [Security](https://polestar.guide/docs/reference/security.md): How to report a security problem privately, what counts as one, and the supported versions.
- [License exception](https://polestar.guide/docs/reference/license-exception.md): The permission to distribute a compiled community guide or an import string under terms of your choice.

## Guides

- [Guide library](https://polestar.guide/guides.md): all 222 built-in guides, shelf by shelf, as the in-game guide menu files them
- [Alliance leveling road](https://polestar.guide/guides/alliance.md): every Alliance race from its start zone to 60, guide by guide, with levels
- [Horde leveling road](https://polestar.guide/guides/horde.md): every Horde race from its start zone to 60, guide by guide, with levels
- [Class guides](https://polestar.guide/guides/class.md): each class: who can play it, leveling talent plans, class quests and gear advice
- [Warrior](https://polestar.guide/guides/class/warrior.md): Arms, Fury, Protection talent plans, class quests, gear
- [Paladin](https://polestar.guide/guides/class/paladin.md): Holy, Protection, Retribution talent plans, class quests, gear
- [Hunter](https://polestar.guide/guides/class/hunter.md): Beast Mastery, Marksmanship, Survival talent plans, class quests, gear
- [Rogue](https://polestar.guide/guides/class/rogue.md): Assassination, Combat, Subtlety talent plans, class quests, gear
- [Priest](https://polestar.guide/guides/class/priest.md): Discipline, Holy, Shadow talent plans, class quests, gear
- [Shaman](https://polestar.guide/guides/class/shaman.md): Elemental, Enhancement, Restoration talent plans, class quests, gear
- [Mage](https://polestar.guide/guides/class/mage.md): Arcane, Fire, Frost talent plans, class quests, gear
- [Warlock](https://polestar.guide/guides/class/warlock.md): Affliction, Demonology, Destruction talent plans, class quests, gear
- [Druid](https://polestar.guide/guides/class/druid.md): Balance, Feral Combat, Restoration talent plans, class quests, gear

## Leveling routes

Each guide's page lists its facts and its steps in order; the race or faction it serves is in brackets.

- [Westfall 12–17 (Alliance)](https://polestar.guide/guides/alliance/02-westfall.md)
- [Darkshore 16–21 (Alliance)](https://polestar.guide/guides/alliance/03-darkshore.md)
- [Redridge Mountains 20–23 (Alliance)](https://polestar.guide/guides/alliance/04-redridge-mountains.md)
- [Duskwood 22–26 (Alliance)](https://polestar.guide/guides/alliance/05-duskwood.md)
- [Ashenvale, Wetlands & Stonetalon Mountains 25–29 (Alliance)](https://polestar.guide/guides/alliance/06-ashenvale.md)
- [Thousand Needles, Duskwood & Wetlands 28–31 (Alliance)](https://polestar.guide/guides/alliance/07-thousand-needles.md)
- [Wetlands, Hillsbrad Foothills, Ironforge & Stormwind City 30–33 (Alliance)](https://polestar.guide/guides/alliance/30-40/01-hillsbrad-foothills.md)
- [Desolace 31–34 (Alliance)](https://polestar.guide/guides/alliance/30-40/02-desolace.md)
- [Ashenvale & Wetlands 33–35 (Alliance)](https://polestar.guide/guides/alliance/30-40/03-ashenvale.md)
- [Stranglethorn Vale 34–38 (Alliance)](https://polestar.guide/guides/alliance/30-40/04-stranglethorn-vale.md)
- [Arathi Highlands, Alterac Mountains & Swamp of Sorrows 37–40 (Alliance)](https://polestar.guide/guides/alliance/30-40/05-arathi-highlands.md)
- [Badlands & Desolace 39–41 (Alliance)](https://polestar.guide/guides/alliance/30-40/06-badlands.md)
- [Stranglethorn Vale, Dustwallow Marsh & Swamp of Sorrows 40–43 (Alliance)](https://polestar.guide/guides/alliance/40-50/01-stranglethorn-vale.md)
- [Badlands & The Hinterlands 43–44 (Alliance)](https://polestar.guide/guides/alliance/40-50/02-badlands.md)
- [Feralas 43–46 (Alliance)](https://polestar.guide/guides/alliance/40-50/03-feralas.md)
- [Tanaris 45–47 (Alliance)](https://polestar.guide/guides/alliance/40-50/04-tanaris.md)
- [The Hinterlands, Blasted Lands & Loch Modan 46–48 (Alliance)](https://polestar.guide/guides/alliance/40-50/05-the-hinterlands.md)
- [Searing Gorge 47–49 (Alliance)](https://polestar.guide/guides/alliance/40-50/06-searing-gorge.md)
- [Un'Goro Crater & Ironforge 48–52 (Alliance)](https://polestar.guide/guides/alliance/40-50/07-un-goro-crater.md)
- [Burning Steppes, Azshara & Blasted Lands 51–53 (Alliance)](https://polestar.guide/guides/alliance/50-60/01-burning-steppes.md)
- [Felwood 52–54 (Alliance)](https://polestar.guide/guides/alliance/50-60/02-felwood.md)
- [Winterspring & Eastern Plaguelands 53–55 (Alliance)](https://polestar.guide/guides/alliance/50-60/03-winterspring.md)
- [Western Plaguelands, Eastern Plaguelands & Feralas 54–57 (Alliance)](https://polestar.guide/guides/alliance/50-60/04-western-plaguelands.md)
- [Silithus, Un'Goro Crater & Eastern Plaguelands 56–58 (Alliance)](https://polestar.guide/guides/alliance/50-60/05-silithus.md)
- [Silithus, Felwood, Winterspring & the Plaguelands 57–60 (Alliance)](https://polestar.guide/guides/alliance/50-60/06-silithus.md)
- [Dun Morogh 1–13 (Dwarf & Gnome)](https://polestar.guide/guides/alliance/dwarf-gnome/01-dun-morogh.md)
- [Elwynn Forest 1–13 (Human)](https://polestar.guide/guides/alliance/human/01-elwynn-forest.md)
- [Teldrassil 1–11 (Night Elf)](https://polestar.guide/guides/alliance/nightelf/01-teldrassil.md)
- [Zephras Isle 1–15 (Skyborne)](https://polestar.guide/guides/alliance/skyborne/01-zephras-isle.md)
- [The Barrens 12–17 (Horde)](https://polestar.guide/guides/horde/02-the-barrens.md)
- [Silverpine Forest & Orgrimmar 16–20 (Horde)](https://polestar.guide/guides/horde/03-silverpine-forest.md)
- [The Barrens 19–24 (Horde)](https://polestar.guide/guides/horde/04-the-barrens.md)
- [Stonetalon Mountains & Ashenvale 23–25 (Horde)](https://polestar.guide/guides/horde/05-stonetalon-mountains.md)
- [Hillsbrad Foothills, Undercity & The Barrens 24–28 (Horde)](https://polestar.guide/guides/horde/06-hillsbrad-foothills.md)
- [Ashenvale & Thousand Needles 27–31 (Horde)](https://polestar.guide/guides/horde/07-ashenvale.md)
- [Desolace & Hillsbrad Foothills 30–33 (Horde)](https://polestar.guide/guides/horde/30-40/01-desolace.md)
- [Stranglethorn Vale 32–38 (Horde)](https://polestar.guide/guides/horde/30-40/02-stranglethorn-vale.md)
- [Arathi Highlands, Badlands & The Barrens 37–40 (Horde)](https://polestar.guide/guides/horde/30-40/03-arathi-highlands.md)
- [Dustwallow Marsh & Desolace 39–41 (Horde)](https://polestar.guide/guides/horde/30-40/04-dustwallow-marsh.md)
- [Stranglethorn Vale & Swamp of Sorrows 40–43 (Horde)](https://polestar.guide/guides/horde/40-50/01-stranglethorn-vale.md)
- [Feralas & Tanaris 42–44 (Horde)](https://polestar.guide/guides/horde/40-50/02-feralas.md)
- [Feralas, Dustwallow Marsh & Swamp of Sorrows 44–46 (Horde)](https://polestar.guide/guides/horde/40-50/03-feralas.md)
- [Tanaris & Searing Gorge 45–48 (Horde)](https://polestar.guide/guides/horde/40-50/04-tanaris.md)
- [The Hinterlands & Blasted Lands 47–50 (Horde)](https://polestar.guide/guides/horde/40-50/05-the-hinterlands.md)
- [Azshara, Feralas & Stranglethorn Vale 49–51 (Horde)](https://polestar.guide/guides/horde/40-50/06-azshara.md)
- [Un'Goro Crater, Eastern Plaguelands & Burning Steppes 50–53 (Horde)](https://polestar.guide/guides/horde/50-60/01-un-goro-crater.md)
- [Felwood & Western Plaguelands 52–54 (Horde)](https://polestar.guide/guides/horde/50-60/02-felwood.md)
- [Winterspring & Feralas 54–56 (Horde)](https://polestar.guide/guides/horde/50-60/03-winterspring.md)
- [Azshara, The Barrens & Undercity 55–57 (Horde)](https://polestar.guide/guides/horde/50-60/04-azshara.md)
- [Eastern Plaguelands, Winterspring & Tanaris 56–58 (Horde)](https://polestar.guide/guides/horde/50-60/05-eastern-plaguelands.md)
- [Silithus, Western Plaguelands & Eastern Plaguelands 57–59 (Horde)](https://polestar.guide/guides/horde/50-60/06-silithus.md)
- [Felwood, Moonglade & Winterspring 58–60 (Horde)](https://polestar.guide/guides/horde/50-60/07-felwood.md)
- [Durotar 1–12 (Orc & Troll)](https://polestar.guide/guides/horde/orc-troll/01-durotar.md)
- [The Barrens 11–17 (Orc & Troll)](https://polestar.guide/guides/horde/orc-troll/02-the-barrens.md)
- [Zephras Isle 1–15 (Skyborne)](https://polestar.guide/guides/horde/skyborne/01-zephras-isle.md)
- [Mulgore 1–12 (Tauren)](https://polestar.guide/guides/horde/tauren/01-mulgore.md)
- [Tirisfal Glades 1–13 (Undead)](https://polestar.guide/guides/horde/undead/01-tirisfal-glades.md)

## Community guides

- [Community guides on polestar.guide](https://polestar.guide/community): guides written and published by players, free to download
- [Community guides](https://polestar.guide/docs/players/community-guides.md): Guides written by other players: install one, find its guides, turn it on or off, and know who to ask.
- [Import strings](https://polestar.guide/docs/players/import-strings.md): A small guide shared as one line of text: paste it into Import and it joins your guide menu.
- [Writing a community guide](https://polestar.guide/docs/authors/community-guides.md): What you get, what a pack looks like, the steps from your first guide to publishing, and the checklist before you do.

## Polestar Client

- [Polestar Client](https://polestar.guide/client): the download page, with screenshots
- [Polestar Client](https://polestar.guide/docs/players/client.md): A small desktop app that installs Polestar's addons and community guides and keeps them up to date. Version 0.1.0, in beta.

## Optional

- [Every docs page in one file](https://polestar.guide/llms-full.txt): the player, author and reference docs as one Markdown file
- [Changelog](https://polestar.guide/docs/reference/changelog.md): What changed in each release, for players, guide authors and contributors.
- [Credits & data sources](https://polestar.guide/docs/reference/credits.md): Where every input comes from, its license, what may enter the repository or a release, and the credits the licenses require.
- [Overview](https://polestar.guide/docs/contributors.md): Fix a guide, build the addon from source, and learn how the modules, the toolchain and the simulator fit together.
- [Contributing](https://polestar.guide/docs/contributors/contributing.md): Ways to help, a good wrong-step report, fixing a guide, setup, checks, branches, commits and pull requests.
- [Building from source](https://polestar.guide/docs/contributors/building.md): Clone the repository, build the reference data and the addon, run the checks, and find your way round the project.
- [From source to game](https://polestar.guide/docs/contributors/source-to-game.md): How a .guide file becomes the steps in the guide window: lint, compile, the data addons and the engine.
- [Map and glossary](https://polestar.guide/docs/contributors/docs-map.md): Where each question is answered, how data flows from the client to the game, and the words the docs use.
- [Architecture](https://polestar.guide/docs/contributors/architecture.md): The contract between the addon's modules, the compiled guide data, the toolchain and the tests.
- [The addon, file by file](https://polestar.guide/docs/contributors/addon.md): Which addon is which, the modules in load order with each file and its public table, where a hub screen lives, and the generated files.
- [The toolchain](https://polestar.guide/docs/contributors/tools.md): The commands by group, the tools/lib folders, every generated file with its command and inputs, and the rebuild order.
- [The tests](https://polestar.guide/docs/contributors/tests.md): The test layers, the fake client, the helpers, how to run one test, and what needs local data.
- [The suite](https://polestar.guide/docs/contributors/suite.md): The modules and their scope, the inputs Polestar reads, the data layer, the in-game data addons and the runtime services.
- [Route simulation](https://polestar.guide/docs/contributors/simulation.md): The route simulator: world model, character model, search, calibration and results.
- [Design system](https://polestar.guide/docs/contributors/design.md): Who the windows are for and what they must do, then colour, type, layout and component tokens.
- [Agent workflows](https://polestar.guide/docs/contributors/workflows.md): The skills a contributor’s AI agent follows: contributing, triaging a report, and fixing a guide step.
- [Releasing](https://polestar.guide/docs/contributors/releasing.md): What ships, setting the version, the release steps, patch releases and release candidates.
- [Class quests (66 guides)](https://polestar.guide/guides.md): Spells, gear and mounts for each of the 9 classes
- [Professions (12 guides)](https://polestar.guide/guides.md): Alchemy to Tailoring, each from 1 to 300
- [Reputation (17 guides)](https://polestar.guide/guides.md): Both sides' 8 home factions and 9 open to all
- [Exploration (7 guides)](https://polestar.guide/guides.md): Discover Eastern Kingdoms, Kalimdor and Zephras Isle
- [Mounts (27 guides)](https://polestar.guide/guides.md): Level 40 and 60, reputation, PvP, drops and legacy
- [Companion pets (33 guides)](https://polestar.guide/guides.md): From vendors, drops, quests and legacy
- [Legacy and more (3 guides)](https://polestar.guide/guides.md): Legacy Challenges, Cozy Sleeping Bag and Library Books