Skip to content
Joe edited this page Aug 5, 2026 · 2 revisions

Welcome to Epithet

Epithet is a lightweight World of Warcraft addon that lets you browse every player title, see how each is earned and how rare it is, track the ones you're still missing, spot titles other players are wearing out in the world, and earn Epithet Achievements along the way.

Key Features

Title Browser

  • Full title catalogue - enumerates all titles via the client API, joined with a curated static database containing source info, expansion, and rarity.
  • Rarity tiers - colour-coded Common → Legendary, displayed in standard WoW item-quality colours, with an in-app popup explaining how the percentages are estimated.
  • Collection tracking - earned vs unearned at a glance, with a collected count (optionally scoped to obtainable-only titles).
  • Filters - by expansion, status (earned/unearned), rarity, type, category, prefix/suffix, faction, favourites-only, hide-unobtainable, hide-time-sensitive, and free-text search.
  • Favourites - star any earned title to pin it to the top of the Collected group.
  • Set title - a one-click "Set as My Title" button.

Title Spotting (Social Layer)

  • Target nameplate overlay - shows the title currently displayed by whoever you're targeting, with a hover tooltip explaining what left-click and right-click do.
  • Two layouts - "Slimline" and "Portrait Card", with configurable fade-out on target loss and a draggable/lockable position.
  • Spotting Log - a persistent log of titles you've spotted on other players.
  • Epithet Achievements - a dedicated achievement system built on top of spotting and collection data.

Quality of Life

  • What's New popup - a themed changelog dialog shown once per update; reopen anytime with /epithet whatsnew.
  • Minimap button and multi-language support (English, Russian, French, with more on the way).

See the User Guide for a full walkthrough of every feature.

Quick Start

Installation

  1. Install the addon to Interface/AddOns/Epithet/.
  2. If you're running from source rather than a packaged release, fetch the Ace3/LibDataBroker/LibDBIcon libraries first — see Developer & Technical Documentation.

Basic Usage

  • /epithet (or /titles) - opens the title browser window.
  • /epithet scan - forces a title rescan to update your collected titles.
  • /epithet minimap - toggles the minimap launcher button.
  • /epithet whatsnew - reopens the What's New dialog for the current version.

Title Spotting, the Spotting Log, and Epithet Achievements are configured from the addon's Options panel and opened via the header buttons in the main window.

Wiki Contents

  • User Guide - how to use every feature: the Title Browser, Title Spotting, the Spotting Log, Epithet Achievements, and Settings.
  • Developer & Technical Documentation - project architecture, the WoW title API, build/link scripts, and saved variables.
  • Locales and Translations - how Epithet's localization system works and how to add or update a language.
  • Contributing - how to report title data issues, contribute translations, and submit pull requests.

Links