Overwolf

Overwolf

  • Getting Started
  • Docs
  • API
  • Events Status
  • Blog
  • Q&A
  • Support

›Best Practices

Best Practices

  • Overview
  • App specific experience
  • First time user experience
  • App launch performance
  • Marketing Communications
  • User journey and error handling
  • Per-game settings
  • Hotkey best practices
  • Second monitor usage
  • Data persistence
  • Reduce OPK size
  • Use Tab as an app Hotkey
  • Type definition file
  • Download Link with referral ID
  • Video capture best practices
  • Enable Developer Tools
  • Exclusive Mode Overlay
  • Electron Migration

Using Windows API

  • Using Overwolf windows
  • Windows Communication
  • Windows Types
  • Resolution Size and Position
  • General Tips

Understanding OW logs

  • What are Overwolf logs
  • DxDiag log
  • Trace logs
  • OBS logs
  • OverwolfPerf log
  • Overlay game HTML

Using Plugins

  • Plugins overview
  • Plug-in Implementation
  • Write your own plugin
  • Sample plugin
  • Simple I/O plugin
  • TeamSpeak plugin
  • Downloader plugin
  • Process Manager plugin

Using Events

  • JavaScript events overview
  • Using game events in your app
  • Game events Simulator
  • Verifying event status

Developers Console

  • Submit a new version
  • Release notes
  • Submit for review
  • Update store listing
  • Manage your subscriptions
  • Users and permissions
  • Crash reports
  • Rating and reviews
  • App Channels
  • CLI

Integrations

  • Integrating app analytics
  • Login with Twitch
  • Login with Overwolf
  • Event SDK for Game Devs
  • Twitch Extensions

Request a Service

  • Marketing asset requirements
  • Looking for Group
  • Promoting your app
  • App recommendations

Community Help

  • Join the Community
  • Webinars
  • Developers Content
  • Code snippets

Legal

  • Legal overview
  • App terms
  • Developers terms
Edit

Use Tab as an app Hotkey

Hotkeys - Overview

Overwolf Hotkeys are keystrokes or key combinations that can control your app while in-game. When using a hotkey, your app window is opened, and clicking it again will hide or minimize it. You can allow users to change hotkey combinations from your app’s settings panel by automatically directing the user to the Overwolf settings page.

You can read all about hotkeys in our Hotkey best practices guide.

Binding App Hotkeys to Game Hotkeys

Most games already have built-in hotkeys for common actions. These key combinations are usually bound to the most important actions. Adding new hotkeys for your app makes the lives of players harder, as they needs to remember additional combinations.

We can "hitch a ride" on game hotkeys and provide value in an automated manner. The main advanatage of this approach is that the player doesn't need to remember new hotkeys: We can bind OW hotkeys in parallel to the existing game hotkeys to increase value on existing actions.

Use Tab as an app Hotkey

One of the most common hotkeys used in many games is the Tab key.

The tab button is a physically large button, easy to use and to reach which makes it comfortable for players. A lot of games use it as a built-in "special" hotkey that displays important information, scoreboards and similar data, sometimes in a "ShowOnHold" manner: It displays the info while the key is held down, and hides it when Tab is released.

Examples:

  • In League of Legends, when a player is pressing TAB to see match statistics, you can provide him with additional stats on top.
  • In CS:GO, when a player buys weapons, you can show the player his new weapon's recoil pattern.
  • In Hearthstone, when a player enters the deck / collection screen, you can tell him which of his prepared decks is closest to a good meta deck and what cards he is missing to complete it.

"Riding" the Tab key and similar hotkeys, when done right and providing value to your users, is a highly recommended practice.

A LOL example of the popup that appears while the player is holding the tab key (and hides it on release):

alt-text

Implement "Tabbing" in Your App

Start by spotting the hotkeys that your targeted game uses in this fashion - whether it's Tab or other hotkeys. Break down what happens when that key is pressed - Is a new window launched? Is there a new bit of UI? Maybe the champion is doing something? Once mapped, you can think up ways to add value from your app to these screens and automated functions.

The overwolf.settings.hotkeys API offers some useful events for that purpose.
You can find the complete info about hotkeys and how to use them in our hotkeys best practice guide.

Set your hotkey in the manifest

Overwolf hotkeys now offer a "ShowOnHold" mode like the tab key does in some games.
In order to implement a hotkey which works with an OnHold Tab functionality, we will have to set the hotkey in the manifest as a "hold" hotkey:

"hotkeys": {
    "show_YourAppName": { 
        "title": "Show Player",
        "action-type": "custom",
        "default": "Shift+F9",
        "passthrough": true,
        "hold": true
    }
}

Register to the onHold event

Custom hotkeys will only work when your app is already running.
Using a custom hotkey with the app closed will do nothing.

In addition, when you are using a hold hotkey, you should register to the overwolf.settings.hotkeys.onHold event:

overwolf.settings.hotkeys.onHold.addListener(console.log)

Note that this event will be fired twice - on key down and on key up:

{"name": "ges_showhide", "state": "down"}
{"name": "ges_showhide", "state": "up"}

Once the tab key is released, we can hide/minimize your window.

Last updated on 4/5/2020 by Bl0n
← Reduce OPK sizeType definition file →
  • Hotkeys - Overview
  • Binding App Hotkeys to Game Hotkeys
  • Use Tab as an app Hotkey
  • Implement "Tabbing" in Your App
    • Set your hotkey in the manifest
    • Register to the onHold event
  • Legal
    • Terms overview
    • Developer's terms
    • App terms
    • Overwolf terms
    • Overwolf Privacy policy
  • Support
    • Questions and Answers
    • Discord
    • Slack
    • Facebook
    • Twitter
  • Documentation
    • Changelog
    • API
    • App Creation Process
    • Best Practices
    • Game Events status
  • Information
    • Careers
    • Fund
    • Developers Blog
    • Overwolf Appstore
    • Advertise on Overwolf
Overwolf 2022