Lore Codex

Lore Codex is an immersive exploration and collection addon for World of Warcraft (Classic Era / WoW Forever). It turns your journey across Kalimdor and the Eastern Kingdoms into an interactive, pre-WoW historical chronicle.

As you travel the world, the addon dynamically detects iconic heroes, chieftains, and villains who debuted in the original RTS games (Warcraft: Orcs & Humans, Warcraft II, Warcraft III) and classic franchise novels (Of Blood and Honor, Lord of the Clans, Day of the Dragon). Encountering them unlocks detailed historical dossiers, notable feats, and an interactive 3D in-game creature model inside an authentic spellbook journal.

DISCLAIMER - AI WAS USED IN THE DEVELOPMENT OF THIS ADDON

Key Features & Current Capabilities

• Real-Time NPC Discovery Engine:
  • Silently scans target changes, mouseovers, and active nameplates in real time using native GUID parsing.
  • Automatically checks encountered creature IDs against the codex database and saves newly unlocked entries per account via SavedVariables.
• Classic Achievement-Style Toast Alerts:
  • Triggers an ornate, gold-bordered discovery banner at the top of the screen whenever an uncharted legend is found.
  • Displays the clean title "Lore Entry Added", the character’s name, their historical origin title, and their home zone.
  • Layered with atmospheric, native Classic audio cues—combining a mystical discovery chime, a spellbook shimmer, and a delayed parchment page turn.
  • Interactive: Clicking the popup immediately opens the Codex directly to that character's unlocked entry.
• Spellbook Parchment Journal UI:
  • Modeled after the classic World of Warcraft spellbook and quest log, featuring solid, 100% opaque warm parchment textures and authentic typography (Morpheus titles and dark sepia Friz Quadrata ink).
  • Left Page (Exploration Clues & Zones): Entries are categorized under Zone Headers (e.g., Orgrimmar, Ironforge, Eastern Plaguelands, Dungeon). Undiscovered characters remain veiled as ??? (Undiscovered), but display their debut game title to give you historical clues on who and where to search.
  • Right Page (Interactive 3D Model & Chronicle): Live 3D creature model viewport with manual < and > rotation controls, formal titles, home zones, explicit pre-WoW media appearances, backstories, and bulleted feats.
• Chronicles Overview & Progress Tracking:
  • Features an Overview & Stats Dashboard showing your global collection progress.
  • Includes a redesigned Classic amber progress bar with crisp Blizzard tooltip borders and a defined leading edge.
  • Real-time metric breakdowns displaying discovered vs. total characters grouped By In-Game Zone and By Historical Media Debut.
• Strict Zero-Spoiler Policy:
  • All lore entries, motivations, and historical context stop strictly at Year 25 ADP (the opening of WoW Classic).
  • In-game plot twists, secret identities (such as dragon disguises in royal courts), and future expansion events are strictly avoided to preserve the immersion of the classic leveling experience.
• Minimap Button & Keybinds:
  • Minimap Ring Icon: A draggable, classic leather-bound book button orbiting your Minimap showing total discovered count on hover, opening the journal on left-click, and supporting smooth dragging around the rim.
  • Shift + L: Bound out of the box to instantly toggle the Lore Codex window open and closed with custom page-shimmer audio.

Slash Commands

• /lore or /codex — Opens or closes the Lore Codex journal
• /lore count — Displays your current discovery total in the chat frame
• /lore test — Simulates a character discovery, triggering the popup toast and audio
• /lore reset — Clears all discovered characters to allow a fresh playthrough