Lore Forever

The story behind the zones, quests, people and items around you, in game, for World of Warcraft: Forever. Narrated intros for every starting zone, capital and early dungeon, and answers to whatever you ask.

Download the installer (Windows) · Zip · Website · CurseForge

Lore Forever comes with English male narration. Other language and voice downloads include their matching translated text. On CurseForge you can also add the female narrator, quest dialogue in the male or female narrator's voice, and male and female narration in German and Portuguese (Brasil). See all the packs on the Downloads page.

Install

Installer (Windows): download LoreForever-Setup.exe and run it. It finds your World of Warcraft folder and puts the add-on in _classic_beta_\Interface\AddOns. No admin rights needed. To update, run the newest installer. The installer is code-signed (publisher: Mei Liu). If Windows still shows "Windows protected your PC", click More info, then Run anyway.

One command (Windows): press the Windows key, type powershell, press Enter, then paste this and press Enter:

irm https://loreforeverwow.com/install.ps1 | iex

It finds your World of Warcraft folder, downloads the latest release from this repo and puts it in _classic_beta_\Interface\AddOns. Run it again any time to update. The script is site/public/install.ps1 if you'd like to read it first.

By hand:

1. Download LoreForever.zip.
2. Open your WoW folder, then _classic_beta_\Interface\AddOns (create Interface\AddOns if it isn't there).
3. Unzip all its folders there, with LoreForever and the LoreForever_Voice_* folders side by side. For example, ...\AddOns\LoreForever\LoreForever.toc and ...\AddOns\LoreForever_Voice_Default\LoreForever_Voice_Default.toc. Watch out for a doubled folder like AddOns\LoreForever\LoreForever\: that won't load.
4. Start the game and pick a key when it asks, or type /lore.

If it doesn't show up: on the character screen, click AddOns and tick Load out of date AddOns.

To update, download the new zip, unzip it over the old folders and type /reload in game. If an older version left a LoreForever\Audio folder behind, you can delete it: the narration now lives in LoreForever_Voice_Default.

Other narration voices can be installed the same way. Choose your language and voice on the Downloads page, then unzip every folder from its download into AddOns, including any LoreForever_Lang_* folder. To contribute recordings, see the narrator guide.

What it does

• Narrated stories. Hear zone, capital and dungeon stories and answers in Lore Forever's recorded voices.
• Ask in plain English. "Who is Edwin VanCleef?", "Why is Westfall so poor?" Suggestions appear as you type, and every answer offers follow-up questions.
• Knows where you are. The panel follows your zone, subzone, target and quest log.
• Lore on tooltips. NPCs and mobs get a one-line story; items tell you when one of your quests needs them.
• Quest givers speak. With a Quest Dialogue pack installed, hear recorded quest text, progress and thanks in the male or female narrator's voice. Recording coverage varies; more recordings arrive with updates.
• Quest backstory. A Lore button on the quest dialog and quest log.
• Dungeon primers. Walk into a dungeon and get a short briefing: why you're there and who you'll face.
• Spoiler-safe. Answers that give away a twist ask first, and tooltips never mention quests you don't have yet.
• Offline. Everything is inside the add-on. Nothing to sign up for.

Covers every zone, city and dungeon up to level 30, Zephras Isle, the Hall of Thanes and the Ruins of Lordaeron, plus place lore for the rest of the world, with recorded zone stories and answers.

Command	What it does
/lore or /lf	Open or close the panel
/lore <question>	Ask straight from chat
/lore narrations	Every narrated story, your starting area first
/lore key / /lore key narrate	Choose the key that opens the panel / plays narration
/lore stop	Stop any narration
/lore options	Settings
/lore help	All commands

What's in this repo

Path	What
addon/LoreForever/	The add-on, exactly as it's installed. Plain Lua, no libraries.
addon/LoreForever/Data/	The lore library and its search index, compiled from data/.
addon/LoreForever_Voice_Default/	The default narration voice pack, installed next to the add-on.
data/clips.json	The narrations a voice pack can cover.
VOICE_PACKS.md	How to record a voice pack, and how to install one.
data/lore/	Every lore entry as JSON (one file per zone, quest, NPC, place or topic), with its wiki sources.
data/overrides/, data/spoilers.json	Hand-made corrections and the list of answers held behind a spoiler warning.
site/	The website (loreforeverwow.com).
scripts/build-release.sh	Builds the download zip into dist/ (it reads each add-on's file list with scripts/load_order.py).
scripts/audio_assets.py	The narration recordings aren't in this repo's git: python3 scripts/audio_assets.py fetch downloads the ones release/audio.json names from the audio release, so the zip builds.
release/installer/	The Windows installer (Inno Setup).
.github/workflows/release.yml	On a version tag, builds the zip and the installer and publishes the release.
scripts/install-addon.sh	Copies the add-on into your Forever install from WSL (set WOW_DIR if it isn't found).

The data files are built with a separate tool that isn't part of this repo, so fixes to lore text are best sent as issues. Code fixes are welcome as pull requests.

Feedback

Found a wrong answer, or want a zone narrated? Use the feedback form (sign in with Google) or open an issue.

License

• Code (the .lua, .xml and .toc files, scripts and site code): MIT. See LICENSE.
• Lore text (data/ and addon/LoreForever/Data/): adapted from the Warcraft Wiki and shared under CC BY-SA 4.0. Each entry names its source articles.
• Narration audio (addon/LoreForever_Voice_Default/Audio/, site/public/audio/) and the logo: all rights reserved. They ship with the add-on for you to use in game, but please don't reuse them elsewhere. Voice packs recorded by volunteers are released under CC BY-SA 4.0 (see VOICE_PACKS.md).

World of Warcraft and Warcraft are trademarks of Blizzard Entertainment, Inc. Lore Forever is a fan project and is not affiliated with or endorsed by Blizzard.