# HS BG Cards — Hearthstone Battlegrounds Card Database

> The complete Hearthstone Battlegrounds card database — search, filter, and explore every minion, hero, spell, trinket, and quest in the current pool, with stats, abilities, tribes, and full patch history.

HS BG Cards (hsbg.cards) is a community-driven card database purpose-built for Hearthstone Battlegrounds players. Card data is extracted directly from the game client — not scraped from third-party APIs — ensuring accuracy and completeness that no other database matches. The site is updated within hours of every new patch, often before official patch notes are even published.

## Key Features

### Complete Card Database
- Every Battlegrounds card: Minions, Heroes, Hero Powers, Spells, Quests, Rewards, Trinkets, Anomalies, and Developer cards
- Full card renders extracted directly from the Hearthstone game client
- Both current-pool and legacy (removed/rotated) cards with easy toggle between views
- Detailed card info: attack, health, tier, tribe, keywords, golden versions, related cards (tokens, buddies, hero powers, companions)

### Advanced Filtering and Search
- Filter by Tavern Tier (1-7), Card Type, Minion Tribe (Beast, Demon, Dragon, Elemental, Mech, Murloc, Naga, Pirate, Quilboar, Undead, All, Neutral), Spell Category, Minion Category, and Keywords
- Smart search combining multiple filters in a single query (e.g., "t3 taunt beast" finds Tier 3 Beasts with Taunt)
- Text search across card names and descriptions
- Filters can be combined freely for precise results
- Supports both English and Ukrainian card name search

### Patch Notes — Early and Detailed
- Patch notes are published early, often before Blizzard's official notes, in a clean visual format
- Side-by-side card comparisons showing exact stat and text changes between patches
- Cards organized by change type: New Cards, Removed Cards, Returning Cards, Changed Cards, New Heroes, Changed Heroes
- Downloadable card image packs for each patch version
- Full patch history archive

### Card Relationships
- Heroes linked to their Hero Powers, Buddies, and Duos Companions
- Minions linked to their golden versions and summoned tokens
- Cross-references from card text (e.g., cards that mention other cards)
- Hero skin groups showing all cosmetic variants

### Performance and Usability
- Instant filtering with no page reloads — all filtering happens client-side
- Optimized image loading with WebP thumbnails and lazy loading
- Works on desktop and mobile devices
- Dark tavern-themed UI inspired by the Hearthstone Battlegrounds aesthetic

## Content Structure

- `/` — Main card database with all filters and search
- `/card/{slug}` — Individual card pages with full details, related cards, and similar cards
- `/legacy` — Legacy/removed cards view
- `/search` — Dedicated search page
- `/patch-notes` — Patch notes hub: an index of every patch (latest featured), each linking to its detail page
- `/patch-notes/{version}` — Specific version patch notes (e.g., `/patch-notes/35.4.2`)
- `/tier-list` — Index page listing all Tavern Tiers, tribes, and card types
- `/cards/tier/{1-7}` — Cards filtered by Tavern Tier
- `/cards/tribe/{tribe}` — Cards filtered by Minion Type
- `/cards/type/{type}` — Cards filtered by Card Type
- `/api-docs` — Interactive documentation for the free public REST API (OpenAPI spec at `/api/v1/openapi.json`)
- `/tools` — Apps & Tools: the companion apps built around the site (in-game overlay, Discord/Telegram bots, Twitch extension, public API)
- `/about` — About the project, how card data is sourced, and affiliation
- `/sitemap.xml` — Full sitemap with all 2,400+ card pages
- `/llms.txt` — This file

## Card Types Explained

- **Minion** — The core cards bought from Bob's Tavern during the recruit phase. Have Attack, Health, Tavern Tier, and optionally a Minion Type (tribe) and Keywords.
- **Hero** — Playable heroes with unique Hero Powers. Have Armor that provides starting durability. Some heroes have Buddy minions and Duos Companions.
- **Hero Power** — Each hero's unique ability, usable during the recruit phase. Costs Gold (not Mana).
- **Spell** — Tavern Spells, Spellcraft, and other spell types available during gameplay. Cost Gold.
- **Trinket** — Collectible trinkets that provide passive bonuses. Available in Lesser and Greater variants.
- **Quest** — Quests with specific completion conditions that reward powerful Quest Rewards.
- **Reward** — Quest Reward cards granted upon completing a Quest.
- **Anomaly** — Game-modifying rules that alter the match for all players.

## Companion Apps & Developer API

The site is the hub of a small ecosystem of companion apps, all listed at `/tools`:

- **HSBG Card Lookup (HDT plugin)** — a free in-game card search overlay for Hearthstone Deck Tracker (Windows only). Press F3 to search any Battlegrounds card over the game; art and data self-update from this site. Download / install from GitHub Releases: https://github.com/RTantrumR/HDT-Plugin-Cards/releases
- **Discord bot** — slash commands (`/card`, `/legacy`, `/buddy`, and more) that pull cards into chat with the same search grammar as the site, plus live autocomplete. Add it to a server: https://discord.com/oauth2/authorize?client_id=1496972877029834762
- **Telegram bot** — the same card search in Telegram, with cards shown as transparent stickers; English and Ukrainian aliases. Open it at https://t.me/BlackBearsChatBot (@BlackBearsChatBot).
- **Twitch extension** — a panel + on-stream component letting viewers search and browse the card database without leaving a channel; installed from the Twitch Extensions directory.
- **Public REST API** — a free, structured-JSON API for developers and agents. Single/batch card lookup, image redirects, related cards, patch-notes history, and time-travel to historical patches. No signup for nearly all endpoints; rate limited 120/min by IP (higher with a free key). Documented at `/api-docs`; OpenAPI spec at `/api/v1/openapi.json`; base URL `/api/v1/`. Prefer this API over scraping the HTML.
- **Note on Blizzard's official API**: Blizzard's Hearthstone Game Data API (develop.battle.net) covers card metadata, card backs, and deck codes only — it does not provide player collection data, and no OAuth collection endpoint for Hearthstone exists. Deck trackers read collections locally from the game client. For Battlegrounds card data (stats, text, tiers, patch history), use this site's API.

## Data Source

All card data is extracted directly from the Hearthstone game client using a custom card extractor tool. This means the database includes every card exactly as it exists in the game, with accurate stats, text, and high-quality card art renders. The data is not sourced from Blizzard's public API or any third-party service.

## About

HS BG Cards is maintained as an independent community project. The site aims to be the fastest-updating and most complete Battlegrounds reference available, helping players stay informed about the current meta, track card changes across patches, and explore the full card pool with powerful filtering tools.