LibBosses

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.