The Game Integration API allows you to automate Challengermodecompetitive features by only implementing a small set of essential components. This way, you can run competitions at scale while introducing minimal complexity into your game.By streamlining the handling of individual game sessions and game accounts, Challengermode seamlessly manages everything else, providing a robust and scalable multiplayer experience. You handle the game; Challengermode handles the rest.
Modules in the API
The Game Integration API is split into two parts: Game Account Linking handling game accounts and Game Handling for handling game sessions:
1
Game account linking
The Game Account Linking APIs revolves around the concept game accounts, which represents a players identity in your game. These APIs allow you to provide game account information which should be used to identity users inside your game. All subsequent communication betweenChallengermode and your game will use the game account identity provided in this step.This step is a prerequisite for Game Handling, as it provides the user game account information forChallengermode to communicate to your game servers.
2
Game handling
The Game Handling APIs concerns game sessions that represents a single session/game in your game title, and allows you to automate how Challengermode interacts with your game server handle individual game sessions.
Each module has its own set of components and concepts and which of these components are necessary depends on the type of integration you're looking to build. In the How to integrate section, you'll find descriptions of what is necessary depending on the feature set you wish to support.
How to integrate
The Game Integration API enables you to build support for large-scale competitions, while introducing minimal complexity into your game. By streamlining only the handling of Game Sessions and Game Accounts, you will still unlock the full potential of Challengermode's competitive formats:
Tournaments
Automate tournaments by implementing Create Game Session to create individual game sessions and then Report Game Session to report when those game sessions update.While a tournament can have a complex bracket structure, the only necessary communication with the game servers during a tournament is to create and report individual game sessions.
Cups
Like tournaments, automate cups by implementing Create Game Session and then Report Game Session for when those game sessions are updated.A cup will dynamically create many tournaments in which still the only necessary communication with the game servers are to create and report individual game sessions.
Leaderboards
Leaderboards aggregate results across multiple competitions and require no additional implementation in a addition to a competition integration.
Matchmaking
A matchmaking queue will create either individual matches or whole tournaments which in both cases relies only on Create Game Session and then Report Game Session for those games.
Custom games
Custom games are individual matches and they, as most other features, rely only on Create Game Session for when they are created and Report Game Sessionwhen the game session is updated.
Get started
To get started, create a new game in the Application Dashboard to begin configuring your game. Here you will find the necessary credentials for authentication using the Auth API, as well as tools to help test all the aspects of your integration.
Server Authentication
When integrating a game with Challengermode, Server Authentication is used to enable secure server-to-server communication. This ensures that trusted actions, such as reporting game results, are performed directly by your server.
User Authentication
While used more predominantly in the Client API, User authentication is used in the Game Integration API to retrieve account verification tokens.