0.2.2

For players#

• The release now includes the Codex (the Polestar_Codex folder, part of Polestar), so Lookup, Dungeons and Rares work: search items, mounts, pets, recipes, NPCs and quests and see where to get them; every dungeon and raid with its levels, entrance, bosses and their loot, and its quests; rares and treasures with their spawns and drops. It is built from the game's own data tables, the quest and creature databases Polestar already uses, and our recordings. If it is missing or disabled, Lookup, Dungeons and Rares say so: reinstall Polestar or enable it in the AddOns list, then /reload.
• The Codex knows more: the battleground war mounts and tabards show their PvP rank and reputation, the Orange Murloc Egg and Green Helper Box are companions, Molten Core and the other raids list their bosses' loot, more rares are known, and every dungeon and raid points at its real entrance (the Deadmines at Moonbrook), not the spot where a ghost returns.
• Distances can read in metres: Options, Arrow & routes, Distances.
• The starting zones follow Forever's new quest chains: a follow-up is taken once the quest before it is handed in, where the guides offered several links of a chain at once (Northshire's book chain and Jason Mathers' murloc quests in Elwynn Forest, Dun Morogh, Teldrassil, Durotar and Mulgore). The Big Picture and what follows it stay optional extras, as Shinyfinder Narf is elite.
• Profession quests are optional and say who they are for: Rough Wolf Pelts (skinners), A Pain in the Neck (enchanters) and The Quarry's Smith (blacksmiths). Other characters could not take or finish them.
• The Skyborne start points at the Ley Line, the Elemental Convergence and Raan's campfire again: their ids changed in Forever's data.
• The world map's zone level ranges are rebuilt from the community quest database 12.1.0's Forever creatures (Mulgore reads 3-11, no longer 3-27).
• Reading ahead with Next no longer stops quest automation for the step you are on: its quests are still accepted and handed in while the window shows a later step.
• The optional Recorder also notes what the Codex learns only in play, while it is on: rares you see (on nameplates, as target or mouseover, or on the minimap), treasures, what each corpse or chest drops and how often, the dungeons you enter and where, and boss encounters, plus the rewards quest windows offer. To share a recording, send the Polestar_Recorder.lua file from your SavedVariables folder (CONTRIBUTING.md says where); it is imported without your character's name or realm.

For guide authors#

• codex build uses only inputs Polestar may redistribute: the dungeons and raids (levels, entrances, bosses) come from the Forever client's tables (Map, DungeonEncounter, LFGDungeons, MapDifficulty, ContentTuning), boss loot from the drops in items.json, mounts and companions from Mount and BattlePetSpecies, rares from npc ranks. --local-extras adds the loot-table addon, the rares database and DungeonJournal for a local-only comparison build. pack ships the Codex with its LICENSE-DATA.txt and refuses to run without a release-safe one.
• A release codex build measures itself against the last --local-extras build, entity by entity (data/local/codex-parity.md, codex parity), and lists what only play can fill with the Recorder event that fills it.
• codex <web-db> fetches, one page at a time, the Forever web database's facts for what the parity report lists as missing (NPC level, rank, positions and drops with counts; object contents; item tooltip requirements) into data/sources/<web-db>/codex/, which a release codex build reads. The parity report now checks every internal-only fact against Forever (the client, the web database) and says whether it is a gap of ours, not in Forever, or unverified.
• data build keeps the droppers of the Era quest database's reference loot tables (raid and boss loot) at an unknown rate instead of dropping them: Molten Core's tier pieces now name their bosses.
• A skill for coding agents, skills/polestar-guide-pack/: the workflow from new to pack (look up every id with find, then lint and playtest until both pass) and the guide format on one page. new copies it into the pack's .agents/skills/ and .claude/skills/, and the pack's AGENTS.md points to it.
• data build reads the web database's Forever zone quest lists (cached a day in data/sources/<web-db>/) and applies Forever's change notes: "Experience X instead of Y", "Level X instead of Y" and "Requires level X instead of Y" set X where the data still holds the old value (Scaring Shaky now gives 3300 XP, not 820). Quests still without XP take the web database's. --no-<web-db> skips it; guide pack workflows and Codespaces build with it.
• The Recorder records finds (rare, treasure, slain, drop, enter, encounter events; docs/ARCHITECTURE.md, "Recordings") and the quest frames' items, choices and rewardMoney. record import and data build turn them into npc ranks, levels, the rare role and spawns; drop chances from loot windows over kills, merged across sessions, with their counts in items' seen (10 kills or more replace the existing chance); chest/herb/mine objects with their spawns; quest rewards; and the new instances.json (entrances, encounters and their bosses).
• npcs and objects inside dungeons and raids carry instances (instance map ids), from the community quest database's areas and the Forever AreaTable and Map tables (Map is now read with the Forever tables) plus recordings.

For contributors#

• record import --anonymize for a file a player sent in: character names and realms are dropped, a short hash keys the character (its sessions still group together) and no raw copy is archived.
• npm test passes on Windows: the loot-table addon's missing-file warnings and the install test's file names use / there too (thanks @CDVolvik).