Games IDs
What is an Overwolf Supported Game?
In Overwolf, when we refer to a "supported game" it could mean one of two levels of support:
-
Overlay support - games that support overlay injection. In these games, we can display OW apps as an overlay, and make use of Overwolf APIs. The full list of games that support overlay injection can be found in the gamelist.xml file.
-
Game events support - games which support overlay injection as well as real-time game events. You can create OW apps for these games, that leverage game events using the overwolf.games.events API. The full list of games that supports events can be found here.
Game events can vary between games. If you'd like us to enable a new game event, you can request it as a new feature.
What is the Game ID
Each supported game has its own unique Game ID.
Game IDs are used in your app’s manifest.json in multiple ways:
-
game_targeting property - A list of games which enable overlay for this app.
-
game_events property - A list of games for which game events are required.
-
launch_events property - A list of games triggering the app to launch.
The gamelist.xml file
We support overlay injection in a vast and growing number of games. The list is kept up to date, and you can find it in your local Overwolf app data folder after installing Overwolf.
-
Navigate to your
%localappdata%
folder and open theoverwolf
folder. -
Open the Game List XML file (named with a number postfix, for example, gamelistXXX.xml, higher number means newer version), and search your game by name.
-
Under each game, you can find game ID listed. If you didn’t find the game you need, contact us.
Game-ID and Instance-ID
A single game can have multiple executables: Steam, GOG, 32 / 64-bit clients, etc. We differentiate between them by adding one digit to each game ID, which is called an "Instance ID." Basically, you have the base game ID, and then a series of instances (212160, 212161, …)
When you call overwolf.games.onGameInfoUpdated you will get the same full ID including the instance ID. Besides, there is a file called "gamelist.xml" in the OW client folder that contains all the supported game ids, including instance ID. In order to translate the instance ID into the game ID that needs to be used in the manifest, you can divide the instance ID by 10 and round down.
For example for Fortnite: in order to get 21216 instead of 212161, you can do:
Math.floor(gameInfoResult.gameInfo.id/10)
You can see how we use it in the Fortnite events sample app.
Note that the RunningGameInfo object also has a classId
property, which already equals the game ID.
Games with game events support
Game launcher IDs
IDs for Launchers such as the League of Legends launcher can be found here.