https://github.com/HearthSim/HearthDb

HearthDb is a .NET Hearthstone database.
https://github.com/HearthSim/HearthDb

Last synced: about 1 year ago
JSON representation

HearthDb is a .NET Hearthstone database.

• Host: GitHub
• URL: https://github.com/HearthSim/HearthDb
• Owner: HearthSim
• License: mit
• Created: 2015-11-14T16:57:40.000Z (over 10 years ago)
• Default Branch: master
• Last Pushed: 2025-04-25T17:19:17.000Z (about 1 year ago)
• Last Synced: 2025-04-25T18:32:24.352Z (about 1 year ago)
• Language: C#
• Homepage: https://hearthsim.info
• Size: 7.64 MB
• Stars: 73
• Watchers: 12
• Forks: 40
• Open Issues: 10
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# HearthDb

[![Build & Deploy](https://github.com/HearthSim/HearthDb/actions/workflows/main.yml/badge.svg)](https://github.com/HearthSim/HearthDb/actions/workflows/main.yml)

HearthDb is a .NET Hearthstone database.

## Deckstrings

`HearthDb.Deckstrings.DeckSerializer` can serialize decks from and to Hearthstones deck string format, used for importing/exporting decks.  

See [here](https://github.com/HearthSim/HearthDb/blob/master/HearthDb.Tests/DeckSerializerTest.cs) for example usage.

Full deck strings documentation can be found here: https://hearthsim.info/docs/deckstrings/

## Cards

`HearthDb.Cards` contains all card information of the `CardDefs.xml`, imported from the [hsdata HearthSim project](https://github.com/HearthSim/hs-data).

See [here](https://github.com/HearthSim/HearthDb/blob/master/HearthDb.Tests/UnitTest1.cs#L14-L25) for example usage.

### Localized strings

By default, HearthDb only loads locale data for enUS and zhCN. Additional language 

data can be downloaded from `api.hearthstonejson.com`, e.g. `https://api.hearthstonejson.com/v1/latest/CardDefs.deDE.xml` and loaded at runtime via 

`HearthDb.Cards.LoadLocaleData(...)`.

If desired, all language data can be included by default by replacing the url in `HearthDb.CardDefsDownloader` with `https://github.com/HearthSim/hsdata/blob/master/CardDefs.xml`.

## CardIDs

`HearthDb.CardIds` contains properly named constant for all cardIds existing in Hearthstone. 

The `CardIds.cs` file is generated by `HearthDb.CardIdLibGenerator`. 

See [here](https://github.com/HearthSim/HearthDb/blob/master/HearthDb.Tests/UnitTest1.cs#L28-L34) for example usage.

## Enums

`HearthDb.Enums` contains all the relevant Hearthstone enums.

The `Enums.cs` file is generated by `HearthDb.EnumsGenerator`.