LibBosses is a shared boss ID and encounter database library for World of Warcraft addons.

It provides a normalized, multi-client data model for dungeon, raid, and world boss encounters. Multiple NPC IDs that belong to the same encounter—such as transformations, phases, vehicles, council members, split forms, or other encounter components—are grouped into one logical boss. This allows consuming addons to identify encounters reliably and prevents duplicate boss counting.

LibBosses is designed for addon developers. It does not provide a standalone user interface and normally remains invisible unless another addon uses it.

Features

Logical boss groups for encounters with multiple NPC IDs
Direct lookups by NPC ID, GUID, and unit token
Stable boss and instance keys
NPC aliases for phases, forms, members, and encounter components
Required and optional boss classification
Completion modes for single, multi-part, final-phase, and encounter-based bosses
Separate instance variants for different clients, versions, and difficulties
Automatic detection of the current instance and matching variant
Fast NPC-to-boss indexes for combat-log and live tracking
Registration API for custom instances, bosses, and variants
LibStub-based integration
No SavedVariables, standalone configuration, or user interface required

LibBosses supports:

Classic Era
Burning Crusade Classic
Wrath of the Lich King Classic
Cataclysm Classic
Mists of Pandaria Classic
Retail / Mainline

Logical Boss Model
A single boss encounter may use several NPC IDs during combat. LibBosses maps all related IDs to the same logical boss object.

Consuming addons should track progress by the stable logical boss key rather than by individual NPC IDs. This prevents phases, transformations, council members, vehicles, and other encounter components from being counted as separate bosses.

Required and Optional Bosses
LibBosses distinguishes between required and optional encounters.

A boss is considered required when it must be defeated to complete the regular instance or wing progression. Bosses that can be skipped without preventing normal completion are marked as optional.

This classification can be used by progress trackers, completion checks, instance summaries, and similar addon systems.

Instance Variants
The same map may contain different boss layouts depending on:

client branch
expansion version
difficulty
group size
Challenge Mode or Mythic+
LFG context
Chromie Time
other runtime selectors

LibBosses stores these layouts as separate instance variants and can automatically determine the best matching variant for the player’s current context.

Developer API
The public API provides access to:

instances and maps
logical bosses and NPC aliases
required and optional boss lists
current instance and variant detection
completion modes and completion NPCs
Blizzard encounter IDs
custom instance and boss registration
catalog statistics and iterators

Complete developer documentation is included in English and German.

Notes
LibBosses is a developer library. Installing it by itself does not add a visible interface or standalone gameplay feature.

----------------------

LibBosses ist eine gemeinsame Boss-ID- und Begegnungsdatenbank für World-of-Warcraft-Addons.

Die Bibliothek stellt ein normalisiertes, clientübergreifendes Datenmodell für Dungeon-, Raid- und Weltbossbegegnungen bereit. Mehrere NPC-IDs, die zur selben Begegnung gehören – beispielsweise Verwandlungen, Phasen, Fahrzeuge, Ratsmitglieder, aufgeteilte Formen oder andere Begegnungskomponenten – werden zu einem logischen Boss zusammengefasst. Dadurch können verwendende Addons Begegnungen zuverlässig erkennen und eine doppelte Bosszählung vermeiden.

LibBosses richtet sich an Addon-Entwickler. Die Bibliothek besitzt keine eigenständige Benutzeroberfläche und bleibt normalerweise unsichtbar, solange sie nicht von einem anderen Addon verwendet wird.

Funktionen

Logische Bossgruppen für Begegnungen mit mehreren NPC-IDs
Direkte Abfragen über NPC-ID, GUID und Unit-Token
Stabile Boss- und Instanzschlüssel
NPC-Aliase für Phasen, Formen, Mitglieder und Begegnungskomponenten
Kennzeichnung erforderlicher und optionaler Bosse
Abschlussmodi für Einzelbosse, Mehrteiler, Endphasen und Encounter-Abschlüsse
Getrennte Instanzvarianten für unterschiedliche Clients, Versionen und Schwierigkeitsgrade
Automatische Erkennung der aktuellen Instanz und passenden Variante
Schnelle NPC-zu-Boss-Indizes für Combat-Log- und Live-Tracking
Registrierungs-API für eigene Instanzen, Bosse und Varianten
Einbindung über LibStub
Keine SavedVariables, eigenständige Konfiguration oder Benutzeroberfläche erforderlich

LibBosses unterstützt:

Classic Era
Burning Crusade Classic
Wrath of the Lich King Classic
Cataclysm Classic
Mists of Pandaria Classic
Retail / Mainline

Logisches Bossmodell

Eine einzelne Bossbegegnung kann während des Kampfes mehrere NPC-IDs verwenden. LibBosses ordnet alle zugehörigen IDs demselben logischen Bossobjekt zu.

Verwendende Addons sollten Fortschritt anhand des stabilen logischen Bossschlüssels und nicht anhand einzelner NPC-IDs speichern. Dadurch werden Phasen, Verwandlungen, Ratsmitglieder, Fahrzeuge und andere Begegnungskomponenten nicht als getrennte Bosse gezählt.

Erforderliche und optionale Bosse

LibBosses unterscheidet zwischen erforderlichen und optionalen Begegnungen.

Ein Boss gilt als erforderlich, wenn er für den regulären Abschluss der Instanz oder des jeweiligen Flügels besiegt werden muss. Bosse, die ausgelassen werden können, ohne den normalen Abschluss zu verhindern, werden als optional gekennzeichnet.

Diese Einstufung kann von Fortschrittstrackern, Abschlussprüfungen, Instanzübersichten und vergleichbaren Addonsystemen verwendet werden.

Instanzvarianten

Dieselbe Karte kann abhängig vom jeweiligen Spielkontext unterschiedliche Bossbelegungen besitzen, beispielsweise durch:

Clientzweig
Erweiterungsversion
Schwierigkeitsgrad
Gruppengröße
Herausforderungsmodus oder Mythic+
LFG-Kontext
Chromie Time
weitere Laufzeitselektoren

LibBosses speichert diese Belegungen als getrennte Instanzvarianten und kann automatisch die passende Variante für den aktuellen Spielkontext bestimmen.

Entwickler-API

Die öffentliche API ermöglicht den Zugriff auf:

Instanzen und Karten
logische Bosse und NPC-Aliase
Listen erforderlicher und optionaler Bosse
Erkennung der aktuellen Instanz und Variante
Abschlussmodi und Abschluss-NPCs
Blizzard-Encounter-IDs
Registrierung eigener Instanzen und Bosse
Katalogstatistiken und Iteratoren

Eine vollständige Entwicklerdokumentation ist in deutscher und englischer Sprache enthalten.

Hinweise
LibBosses ist eine Entwicklerbibliothek. Eine alleinige Installation fügt dem Spiel keine sichtbare Oberfläche oder eigenständige Spielfunktion hinzu.