Azeroth Public Library: Forever Lore

Summary

**Azeroth Public Library (APL)** automatically preserves the written lore you discover throughout Warcraft Forever in a permanent in-game library.

When you discover and open books, scrolls, plaques, and other readable lore objects, APL captures their text so you can revisit it later without returning to the original location.

APL does not preload or reveal undiscovered lore. Your library grows naturally as you explore Azeroth and read what you find.

This addon is designed for players who enjoy Warcraft's worldbuilding, exploration, and collectible written content.

Features

Automatic Lore Collection
Readable lore entries are automatically preserved after you discover and open them in the world.

For books containing multiple pages, APL processes the complete book so its full text can be archived.

Account-Wide Library
Collected lore is stored in one shared library, allowing you to revisit your discoveries from any character on the account.

Each lore entry is stored only once, preventing duplicate copies of the same book.

Character-Specific Discoveries
APL also records which characters have personally discovered each entry.

Enable **Show only this character's discoveries** in Settings to view a library containing only the lore found by your current character.

When another character encounters a book already stored in the account-wide library, that character receives their own discovery credit.

Character-Aware Removal
While viewing only the current character's discoveries, removing an entry removes that character's discovery credit without deleting the account-wide copy.

Removing an entry from the account-wide view deletes the saved library entry for the entire account, allowing it to be rediscovered naturally.

Searchable In-Game Library
Browse and revisit your collected lore from one central interface. Search your entries by title or text, and search or filter by the zones you've discovered.

Zone-Based Organization
Entries are organized by the zone where they were discovered, making the library easier to browse while preserving a sense of place and exploration.

Only zones containing lore you have personally discovered appear in the library.

Favorites
Click the star in the Reading Pane to mark an entry as a favorite. Favorites are marked with a star in the entry list, sorted to the top, and gathered in their own **Favorites** tab for quick access.

Notes
Write personal notes on any lore entry in a full text editor: arrow keys, mouse and keyboard selection, select all, copy and paste, and scrolling for longer notes. Notes save automatically as you type.

Move Entries
Move discovered entries between available zone categories when an entry needs to be reorganized.

The Library's Look
APL's interface is designed to feel at home within Warcraft Forever: a dark, etched, gold-trimmed library window with a focused Reading Pane.

- Zone maps: the painted map of the zone where a book was found rests faintly behind the page, like an old map on a reading desk. When a zone has no map, your faction's emblem appears instead.
- Reading-room ambience: warm motes drift slowly upward and a soft candle glow flickers in the corner. This can be turned off in Settings.
- Four accent themes: Gilded Leaf, Arcane Ink, Verdigris, and Oxblood Binding.

Minimap Button
Open the library quickly using the optional minimap button. Drag it to move it around the edge of the minimap.

Note: the minimap button is APL's own rather than a LibDBIcon button, so addons that collect LibDBIcon buttons into a bar or bag may not pick it up.

How It Works

1. Find a readable lore object while exploring the world.
2. Open and read it normally in-game.
3. Azeroth Public Library preserves the entry and records the discovering character.
4. Open APL anytime to browse, search, favorite, annotate, or manage your library.
5. Choose between your account-wide collection and the current character's personal discoveries.

Slash Commands

- `/apl` — Open or close Azeroth Public Library
- `/apl capture` — Capture the readable item you currently have open
- `/apl resetui` — Reset the window layout (your library is kept)
- `/apl backdrop` — Show which map or emblem the Reading Pane is displaying
- `/apl help` — List all commands

Settings

APL includes options to:

- Enable or disable automatic lore capture
- Enable or disable capture notifications
- Show only the current character's discoveries
- Show or hide the minimap button
- Enable or disable interface sounds and window fade animations
- Enable or disable the animated Reading Pane backdrop
- Choose an accent theme and window opacity
- Adjust the Reading Pane and entry list text sizes
- Reset the addon window layout

Settings are preserved automatically.

Intended Scope

Azeroth Public Library is built to preserve discoverable written world lore such as:

- Books
- Scrolls
- Plaques
- Similar readable world objects

It is intended as a lore-collection companion for exploration and reading—not as a database of undiscovered content.

Warcraft Forever Philosophy

APL is designed to support the authentic Warcraft Forever experience.

It does not provide a prefilled lore database, reveal undiscovered books, direct you toward unread lore, or replace the act of exploration. Every entry in your library begins with something you personally discovered in the world.

Upgrading

Updating from an earlier Warcraft Forever beta version keeps your entire library: every book, note, favorite, and setting carries over.

Credits

The interface style is adapted from Forever Goal Tracker by Karl (MIT License), and the Notes editor follows the approach used by Total RP 3 (Apache License 2.0). Full details are included in the addon's `THIRD-PARTY-NOTICES.txt`. All artwork in APL is APL's own or comes from the game itself.

Optional Lore Companion

For immersive, audio-driven Warcraft lore, **Azeroth Morning Radio** brings the timeline, characters, and world of Azeroth to life through our Lore Lessons series.

Explore all episodes at AzerothMorningRadio.com.