The Scoreloop developer website

All games must be registered and properly configured on the Scoreloop Developer website.

If you have not already done so, please visit https://developer.scoreloop.com and create a developer account. You will then be able to:

  • Register your game and obtain application data for your game

  • Configure your game properties

  • Configure the scoring schema

  • Configure the awards in your game

Registering your game

This is a necessary first step in using the Scoreloop SDK. When you register your game, make sure that you select the BlackBerry QNX checkbox under the Platform section.

By registering your game on the developer website you receive some data that is unique to your game: a game identifier, a game secret, and a game-specific currency.

All of these are required, and must be added to your game code. It is therefore important that you register your game and obtain them before you integrate Scoreloop into your game.

The game identifier, game secret, and the game-specific currency can be retrieved at any time by logging onto https://developer.scoreloop.com.

Each game that you wish to integrate with the Scoreloop SDK must be registered separately. However, you need only create a single Scoreloop account from which you can have instant access to all of your registered games.

Configuring your game properties

All registered games must contain, at minimum, a name. You can also configure additional game properties including the following:

  • A short description of your game

  • The publisher's name

  • Purchasing information

  • The current state of the game (for example, "in development" or "live")

The name and additional descriptive information that you give your game can be changed subsequently by using the edit capabilities of the Developer website.

The Scoreloop servers are automatically updated to reflect any changes or edits that you make through the developer website.

Configuring the scoring schema

You can configure a schema on the Developer website that Scoreloop uses to compare scores that are submitted by the users of your game. There are three properties that you can configure:

  • Game result, the primary result obtained by users of your game

  • Minor result, an optional, secondary result that may also be considered

  • Level, the game level at which the score was achieved (this is also optional)

You can configure an arbitrary comparison order for these three properties, for example, first compare the game level, then the result, then the minor result. Up to two properties can be excluded from the schema, but at least one property must remain in order for the comparison to be valid. Each property can be configured for sorting in ascending or descending order.

If you wish you may use Scoreloop's default comparison schema: result > minorResult > level.

Configuring awards

Your game might support awards, which are target states in your game, that a user can achieve. Achievements are awards that are unlocked during the gameplay. You must configure awards on the Scoreloop developer website. Once an award is configured on the website, Scoreloop generates an awards bundle, that you must add to your game project. The awards bundle provides local access to the individual award properties.