Overwolf SDK Introduction
Overwolf's SDK unlocks in-game app development, and the documents listed in the left-hand side navigation bar have all the information you need to create apps using Overwolf’s diverse APIs. To get you started, here are some important basics:
Get whitelisted as a developer
Only whitelisted Overwolf developer accounts can load or install apps that are not available on the Overwolf store, including unreleased beta versions. If you are not whitelisted, you will not be able to run or install such apps, which means that testing your work in progress will be difficult. Therefore, start by submitting your app proposal in order to get whitelisted.
An Overwolf app's code has three main parts:
- A manifest file (manifest.json), detailing the properties of the app. More info here.
- Visuals and images such as icons and buttons. More info here.
For example vue.js, angular.js, react, backbone.js and similar ones.
However, full-blown desktop application solutions such as electron.js, AppJS and similar ones are not supported.
For Vue.JS developers - we strongly advise against using UI libraries like Vuetify, Bueify, etc., as we've seen issues in non-native windows where different controls might not respond to clicks.
If you know what you're doing and are looking for a workaround, find the control's outer element, have it listen to onmousedown, and simulate a click().
To build Overwolf apps, you first need to download the Overwolf client. You can find the latest developer client version Here.
This mandatory file describes the different aspects of your app, and has to be present in your app's root folder for it to function. Its goal is to define your app's general behaviour, the features it will be using, and any other "meta-data" Overwolf will need to run your app exactly the way you want it to.
You can read more in the Manifest.json section and learn what more you can do to make your app even more awesome.
An example of a basic manifest file:
HTML/JS source files
In the sample manifest above, the app contains a single window. The source file of this window is
index.html. Attached is an example HTML window source file that could be referred to in the manifest:
<h1>Basic sample app</h1>
<p>This is an Overwolf app window.</p>
Your app can use images and assets like in any other web app. However, there are several mandatory assets that every Overwolf app needs. In the sample manifest above, all mandatory icons have been configured: icon, icon_gray and launcher_icon.
After you finish building your app, you need to pack everything; the manifest, source files, and assets into a single Overwolf app installer, called an
An OPK package is actually a ZIP package: To create it, just ZIP all of your files together, and then manually change the file extension from ZIP to OPK. Double clicking a valid (AND SIGNED) OPK will install the package as a new Overwolf app.
We remind you that only whitelisted developers can install OPKs that were not downloaded from the store.
Safety & Security
Protecting our community of gamers is a top priority, and we work hard to ensure developers don’t mess around. A few measures help us with that:
- Each app goes through a full review process.
- Each app is hosted separately in its own web browser, and each web browser runs as a separate process.
- Each app is being run from a different virtual directory.
These measures support security, separation and encapsulation: An app does not have access to the user’s local files, an app cannot directly interfere with other apps, and if an app crashes or breaks, it doesn’t affect the rest of the system.
Some ideas for in-game events you can use - from basics like kills, deaths, victories and similar key events, through taking a screenshot or recording a video of the game, changing window size, analyzing in-game stats to display tips and more. We are constantly developing new tools and features that you can use to build your dream app, if there's a feature you cannot find, suggest it!
You can add even more features to your app by using one of our plugins, like the simple I/O plugin for reading files from the local disk. You can even create your own plugin:
Use existing C/C++/C# code, wrap it inside an Overwolf Plugin DLL file and interact with it in your Overwolf app.
For more details, you can review the Overwolf Plugins section.
Real world sample app
To learn how to build an app that actually pulls in-game events, pops notifications, displays in-game overlays and more - please check out our sample app showcasing.