0.2.0
Reference4 min readUpdated
2026-10-14
On this page
On this page
For players#
- GuideOne route, written as a .guide file and compiled to Lua; its id reads like forever/alliance/human/01-elwynn-forest. packs: guides written by other players load beside Polestar's own.
A Guide packs page in Options (
/polestar packs) shows each packAn addon of guides for Polestar, built by the compiler from a folder with a pack.json (the folder is a pack too); Polestar's own is Polestar_Guides (pack id guides)., turns it on or off and reports its problems. - A centred welcome greets each new character by name, with the guide Polestar suggests; its Set up page appears only on the account's first character.
- The leveling guides of both factions are reworked: quests that block a solo player are dropped or made optional, rare drops are optional, flight paths and training come at the right levels, and Forever's own additions, fixed points and level tips are in.
- Class quests are in the leveling guides of both factions, at the start and level where each class gets them: Shaman totems, Warlock demons, Hunter pets and Beast Training, Paladin and Priest spells, Warrior stances, Druid forms and Rogue poisons.
- Each training stop in the leveling guides is for the classes whose trainer stands there, with stops of their own for Horde Druids (Thunder Bluff), Undead Paladins (Brill, the Undercity, Thunder Bluff), Alliance Shamans (Ironforge) and Alliance Druids (Stormwind, Darnassus), no Horde gap of more than about five levels, and riding at 40 from each race's own riding trainer. Alliance guides add training in Ironforge on the way out of Dun Morogh, and in Stormwind after Duskwood and on the way to Stranglethorn, drop it in Auberdine, which has no class trainer, and take every race to the Sentinel Hill flight path.
- Alliance 40-50 grinds less: Keeping Pace on the ride through the Shimmering Flats into Tanaris, and The Curse of the Tides, Pearl Diving and Return to Corporal Kaleb on one loop through northern Stranglethorn.
- Stranglethorn Vale and Un'Goro Crater, which were split into parts, are now one guide per stay in the zone. Inn names are the ones the game reports, so binding and hearthing check off; Northwatch Hold's step names its levels; and no travel step comes before goals that lead there themselves.
- Collectible, Legacy and reputation guides have clearer notes (warlock mount hand-offs, Merchant's Favor camps, Timbermaw and Cenarion Circle standings) and mark optional extras as such. Gathering loops in Mulgore and Redridge point at the nodes, and an exploration area the game names twice is listed once.
- The guide arrow knows every place a target spawns: the map marks the other places, fainter ("It also spawns here"), and a click on the arrow, the arrow button or a mark moves on to the next one.
- Quest markers cover every place a quest's mobs and objects spawn (before: at most 8 areas per mob per map), and a kill no longer redraws them all. Quest nameplate icons sit beside the health bar you see, on replacement nameplates as well as the game's own.
- Guide windowThe small window that shows the current step and its goals while playing (UI/GuideFrame.lua).: each tab shows its guide's level range; a narrow tab cuts the title, not the range.
- Windows fit their text in any font: a page's subtitle wraps to two lines inside the header, no text runs past a window's edge in the game font or in Inter, and the hubPolestar's main window: a rail of sections (Guides, Lookup, Dungeons, Rares) with Options at its foot (UI/Picker.lua).'s search placeholder picks the first of its wordings that fits the box.
- Beta wording everywhere, and British spelling in the interface.
- The RecorderThe optional Polestar_Recorder addon that records play; record import turns its sessions into data/recordings.'s command is
/psrec, replacing/lsrec;/polestarrecstill works. - The README starts with a quick start for players, a download button and screenshots from the game.
For guide authors#
- Guide packs: write your own guides in a pack of your own, with
newto start one from a template,lint,playtest,dev(rebuilds into the game on every save),play(the real addon in the browser),compile,installandpack(the release zip). See docs/PACKS.md. - Lint checks the places of
sethome,hearth,flyandgetfp, and warns on agotowhose next goalOne thing to do in a step, as a verb and its arguments (accept 783, kill, goto, turnin...). is within 200 yards; route drafts no longer write one. lint,compile,dev,play,installandpackstop with one clear message when the reference dataThe game facts in data/forever/*.json (quests, NPCs, objects, items, zones, map frames and more) that the compiler and the data builds read; built locally by data build. is missing.devreports a deletedpack.json, keeps the last good build and builds again once it is back.findlists inns and flight points as guide lines.sim comparetakes the pack folder as its argument, like the other pack commands.- Docs: the guide format on one page (docs/GUIDE_CHEATSHEET.md), and what the
flycheck accepts.
For contributors#
- A second, independent route search checks the first; the README's numbers and charts show both.
versionsetsguides/pack.jsontoo, so the guides addon's TOC carries the release version after compile; docs/RELEASING.md separates private test builds from public releases.- The UI renders in docs/preview show this release's windows and come out
byte for byte the same from any checkout: textures go through a zlib
encoder of the preview's own (Node's zlib gives different bytes from one
Node to the next), quest markers are built in quest ID order (LuaJIT walked
the quest log in another order and stacked overlapping markers
differently), the test client's
date()is UTC,previewrefuses local inputs unless they render outside the repository, and the guide menuThe hub's Guides section, where a player picks a guide. scenes load frozen copies of six compiled guides, so they change only with the UI, never with a guide recompile. - CI runs
npm teston pushes and pull requests, and fails when the committed textures differ from a freshmediabuild or the committed UI renders differ from fresh ones. --helpprints a command's usage and never runs it; test helpers live in tests/helpers; one copy of each client helper in Core/Compat; every AddOns and WTF folder lookup goes through tools/lib/addons.js ($WOW_FOREVER_ADDONSfirst, then the detected clients);.gitattributesand.editorconfig.- A docs map (docs/README.md), READMEs in the main folders, CONTRIBUTING.md and issue forms for wrong steps and bugs.
- The design system is docs/DESIGN.md, which now also says who the windows are for and what they must do (formerly PRODUCT.md and docs/UI_BRIEF.md).
- The tools share one copy of each foundation: the repository's folders (tools/lib/paths.js), the argument parser (tools/lib/cli.js), the XP rules (tools/lib/game/xp.js) and the races and classes with their mask bits (tools/lib/game/races.js).
- Fields the addon sets on game frames share one prefix,
ps, explained in addon/README.md.
Was this page helpful?