This release adds support for Polly API policies, including one by default that you can now opt into if you use the IGDBClient.CreateWithDefaults static helper method. This is now the preferred way to create a default client instance, but the constructor can still be used to customize the client.

// Get all the goodies by default
var client = IGDB.IGDBClient.CreateWithDefaults(
  igdbClientId,
  igdbClientSecret
);

If you would like to use the built-in policy with a custom token store, you can pass it in the constructor:

// Customize the details
var client = new IGDB.IGDBClient(
  igdbClientId,
  igdbClientSecret,
  customTokenStore,
  IGDB.ApiPolicy.DefaultApiPolicy
);

What's Changed

• Add new IGDBClient.CreateWithDefaults static helper to create an IGDB client configured with all the defaults
• Add default Polly API policy to IGDB.ApiPolicy static class and DefaultApiPolicy async policy
• Add an overload for passing an IAsyncPolicy<HttpResponseMessage> to the client constructor

Full Changelog: 6.0.0...6.1.0

What's Changed

BREAKING CHANGES

Changes for upcoming August 2025 IGDB API migration from enums to endpoints. The changes include replacing enums with more flexible IdentityOrValue types and adds new endpoints.

Enum Updates:

• Replaced enums with IdentityOrValue types in models like AgeRating, Character, Company, and Game to support expanded and non-expanded table fields. For example, AgeRating now uses RatingCategory and Organization instead of the removed AgeRatingCategory and AgeRatingTitle enums.

Features

• Add PopScore endpoints by @WaldoAndFriends in #39
• Added new endpoints and models, such as AgeRatingCategories, AgeRatingContentDescriptionV2, AgeRatingOrganization, CharacterGenders, CharacterSpecies, CompanyStatus, DateFormats, ExternalGameSources, GameStatuses, GameTimeToBeats, GameTypes, PlatformTypes, ReleaseDateRegions, and WebsiteTypes, providing broader access to IGDB data.

New Contributors

• @WaldoAndFriends made their first contribution in #39
• @codename-irvin made their first contribution in #44

Full Changelog: 5.1.0...6.0.0

What's Changed

• Add QueryWithResponse API by @kamranayub in #38

Full Changelog: 5.0.1...5.1.0

Changes

• Fix: Use ConcurrentDictionary in IdentityConverter for thread-safety.

Full Changelog: 5.0.0...5.0.1

June 2024: Performance and API updates by @kamranayub in #36

BREAKING CHANGES

• Fix: Mark ExternalGame.Media enum property as nullable
• Removed public static IdentityConverter.IsAssignableToGenericType helper and replaced with IsIdentityOrValue and IsIdentitiesOrValues static helpers

Changes

• Performance: Refactored IdentityConverter to speed up deserialization using a compiled Lamda activator and avoiding excessive type checks
  • Note: I may look into integrating this into https://github.com/JaCraig/FastActivator
• Expose IdentityConverter.GetIdentitiesActivator for constructing IdentitiesOrValues<> with long[]
• Expose IdentityConverter.GetValuesActivator for constructing IdentitiesOrValues<> with object[]
• Expose IdentityConverter.GetIdentityActivator for constructing IdentityOrValue<> with long
• Expose IdentityConverter.GetValueActivator for constructing IdentityOrValue<> with object

Full Changelog: 4.0.1...5.0.0

This release fixes some deserialization exceptions due to wrong property names/type and also prepares for the API deprecations coming up in August 2024. (See #35)

BREAKING CHANGES

• Fix: Rename Game.Expandedgames to Game.ExpandedGames to fix deserialization error
• Fix: Change Platform.Category to a nullable (e.g. Steam VR) to fix deserialization error
• Deprecated: Remove Game.Collection property
• Deprecated: Remove Game.Follows property

Full Changelog: 3.1.0...4.0.1

NOTE: The tagged 4.0.0 release did not contain all the breaking changes so it is marked unlisted/deprecated in Nuget.

What's Changed

• feat: Add /dumps endpoint by @kamranayub in #34 for IGDB Partners

Full Changelog: 3.0.0...3.1.0

BREAKING CHANGES

• AgeRatingContentDescriptionCategory went from 2 to 85 new categories
• Removal of external game categories not listed in docs:
  • 18 (Xbox Live Title IDs)
  • 5 (GiantBomb)
  • 2 (GamesDb)
  • PushSquare
  • GamersGate

Changes

• External games enum updated
• Add Collection relationship models
• Addition of Event models
• Addition of Language models
• Addition of ReleaseDateStatus

Full Changelog: 2.3.2...3.0.0

Contributors

Thanks @michael-j-green!

What's Changed

• fix: typo in Game Category Episode by @Thundernerd in #25

New Contributors

• @Thundernerd made their first contribution in #25

Full Changelog: 2.3.1...2.3.2

Added

• ExternalCategory.GamersGate
• ExternalCategory.GamesPress
• ExternalCategory.PlayAsia

Full Changelog: 2.3.0...2.3.1