Customizing your Game Parameters (Optional)

The Game Parameters configuration tool offers you the option to customize different types of tournaments that players can compete in. Through the Skillz Developer Portal, you can create any number of Game Parameters and assign them different values in each tournament that you configure. We recommend testing out different Game Parameters to see what keeps your players most engaged.

You can set up Game Parameters when integrating a new game and can continue to add and modify the tournaments you offer even after launching your game from the app store.


Step 1: Determine what parameters best apply to your game

The first step in using Game Parameters to customize player matches, is to identify what parameters you should use. This is highly specific to each game, but consider any factors that could be altered to optimize your player experience.

Parameters are used best when created to define and optimize gameplay without the need for additional app updates. Using these over the air (OTA) levers enables faster tuning and optimization but should be tested thoroughly for all configuration combinations.

Some examples of common game variables that are controlled through Game Parameters include:

Game Rules and Tuning

  • Size or length of the game
  • Level of difficulty and how difficulty increases over time
  • Different characters or weapon loadouts


  • Points for specific actions
  • Bonuses for achievements

Event Variation

  • Different game objectives
  • Cosmetic theming
  • Environmental factors and locations

There is an almost limitless number of possible Game Parameters that you could identify. We recommend you come up with a set of core parameters that you can modify in different tournaments to offer players a variety of gameplay experiences.


Step 2: Add Game Parameters through the Skillz Developer Portal

If you have not already done so, Game Parameters may be added to your live game’s tournaments through the Skillz Developer Portal. Log in to the Developer Portal and go to your dashboard. Then select the game you want to add Game Parameters to, and go to the Tournaments section.




From here, you can add as many Game Parameters to each tournament as are needed. You can also configure your Game Parameters on the Tournaments screen while initially setting up your game.

Game Parameters are specified as Key-Value Pairs. We recommend that if you use the same parameters in different tournaments that you use the same key name so you don't have to duplicate your efforts. You will have access to all the parameters that you configure on this screen once you call the function to launch Skillz within your game.

Game Parameter changes are testable in real time on Sandbox. Just force close your app and restart it – the new tournaments should show up. This will help you quickly find the optimal tournament configuration.


Step 3: Apply Game Parameters within your game

Once you’ve added Game Parameters to your tournaments, you’ll then need to incorporate those Parameters into your game. This will be different based on the platform you are developing on (Android, iOS, or Unity).

To illustrate this, we will use an example of a Unity C# game, with a single tournament. In this tournament, we have added two game parameters: Difficulty and TimeLimit.

We will read in these two parameters and then initialize our game based on the values of the parameters. Here is the implementation:


void setGameParameters ()
gameParams = SkillzCrossPlatform.GetMatchRules();
string difficulty = gameParams["Difficulty"];
Int32 timeLimit = Int32.TryParse(gameParams["TimeLimit"])

Inside of the method, we are reading the difficulty and time limit out of the dictionary as strings. Since TimeLimit is supposed to be an integer, we use the Int32.Parse() method to convert it. Finally, we can start either an easy game or a hard game based on the values of the Difficulty game parameter.


Step 4: Automatic Difficulty (Optional)

If you’d like to create different gameplay experiences according to the player’s skill level, implement Automatic Difficulty for iOS or Android.