Frequently answered questions about the different Scoreloop features and about testing the Scoreloop integration


Q: What is a score and what are its components?
A: A Score is achieved by a player of your game at the end of gameplay. A score can be a simple numerical score, one that is based on time or something more complex, having multiple criteria, such as the number of hits made, the average speed, or the maximum speed. The components of score are:
  • Result: primary score achievable in a game: mandatory component.
  • Minor result: secondary score: optional component.
  • Level: secondary score, optional component.
Q: How is score sorted?
A: Scores can be sorted in ascending or descending order.
  • Descending order: Highest score is on top.
  • Ascending order: Lowest score is on top. E.g., the fastest user wins a game; sorting as time. A score is submitted to the server. Score sorting decides the winner of a challenge and the leaderboard rankings.
The result, minor result, and level are used to compare scores. You can configure the comparison schema on our developer website.
Q: How to define mode based leaderboards?
A: If modes are defined on the developer website, Scoreloop generates separate leaderboards for each mode in the game.
Q: What are the different types of leaderboards available?
A: The leaderboards available are global, 24 hour and friends' leaderboards.
Q: How is the country leaderboard determined?
A: The country leaderboard is based in geo-IP. The user score will be submitted to the country leaderboard, which is determined by the IP address. For example, a user in Germany will submit scores to the German leaderboard by default. If this user moves to Austria, then the score is submitted to the Austrian leaderboard.
Q: How can I create a nationality leaderboard?
A: You can map nationality to modes. Each mode represents a certain nationality. Example: Soccer Game - User chooses to play for team 'Austria'. 'Austria' is mapped to mode 23. All the other countries are mapped to other modes. If your player submits a score for team 'Austria' the score is submitted for mode 23. A user nationality leaderboard request for team 'Austria' is in fact a leaderboard request for mode 23.
Q: Should I submit a score to a nationality leaderboard and the global leaderboard separately?
A: The Scoreloop country leaderboard submits a score to the global and the country leaderboard automatically. But you will have to submit the score twice if you want to override the geo-IP country leaderboard and create separate modes based on countries. Example: Soccer Gamer - User chooses to play for team 'Austria'. 'Austria' is mapped to mode 23. Global is mapped to mode 500. A score will be submitted for mode 23 (mapped to 'Austria') and mode 500 (mapped to the Global). It is then available in both leaderboards - 'Austria' will trigger a mode 23 request. A global leader board request will trigger a mode 500 one.


Q: How many players can engage in a challenge?
A: A challenge takes place between two players. In a challenge, the two players obtain a score in a particular game and submit it to Scoreloop. The player with the best score, as defined by the score comparison schema for the game, is declared the winner of the challenge and receives a prize. Scoreloop takes care of managing and comparing the scores that are submitted as part of a challenge.
Q: Who are contender and contestant?
A: Contender is the one who creates the challenge. Contender is necessary for a challenge. Contestant accepts the challenge. Contestant is necessary for a challenge to be assigned, accepted and completed. The player is allowed only a single try to beat the challenge, which could result in a win or a loss.
Q: Can I create a challenge with stakes?
A: The challenge must be created with a stake greater than or equal to zero.
Q: For how long is a challenge valid?
A: The challenge remains valid for a period of time as configured on the developer website, during which the challenge may be accepted and after which it expires.
Q: What are the different types of challenges?
A: Open : the challenge can be accepted by any player. Direct: the challenge is directed to a particular player.
Q: What is a challenge prize? How is it calculated?
A: The winner of the challenge receives a ‘prize’, which is an amount of in-game currency. The challenge prize is calculated depending on the challenge sink that the developer has chosen to use. If the stake is set to zero, no prize is awarded to the player.
The challenge sink represents the cost of a challenge, and is calculated as a percentage of the total virtual currency pool of a challenge (the sum of the stakes contributed by each player). For example:
  • When 25% sink is in place: If both players contribute 5 coins to play a challenge, the winner is awarded 7.5 coins ((5+5)*(1-0.25) = 7.5).
  • When no sink (0%) is in place: If both players contribute 5 coins to play a challenge, the winner is awarded 10 coins ((5+5)*(1-0) = 10).
  • Prize = (2*stake)*(1-sink)
The following examples demonstrate the currency wallet during a challenge:
25% challenge sink 0% challenge sink
  • Stake: 5 units
  • Sink: 25%
  • Payout: (2 * 5)*(1-0.25) = 7.5 units
  • Balance Alice: 100 units
  • Balance Bob: 10 units
  • The contender Alice starts a challenge against Bob. Her balance drops to 95 as she pays a stake of 5 units to participate.
  • The contestant Bob accepts the challenge. His balance drops to 5 as he pays a stake of 5 units to participate.
  • The winner receives the payout of 7.5 units.
  • If Alice wins, a payout of 7.5 units raises her balance from 95 to 102.5 units.
  • If Bob wins, a payout of 7.5 units raises his balance from 5 to 12.5 units.
  • Stake: 5 units
  • Sink: 0%
  • Payout: (2 * 5)*(1-0) = 10 units
  • Balance Alice: 100 units
  • Balance Bob: 10 units
  • The contender Alice starts a challenge against Bob. Her balance drops to 95 as she pays a stake of 5 units to participate.
  • The contestant Bob accepts the challenge. His balance drops to 5 as he pays a stake of 5 units to participate.
  • The winner receives the payout of 10 units.
  • If Alice wins, a payout of 10 units raises her balance from 95 to 105 units.
  • If Bob wins, a payout of 10 units raises his balance from 5 to 15 units.
The winner of the challenge receives the challenge prize. The player who loses the challenge loses their stake outright.

Awards & Achievements

Q: What are awards?
A: Awards are incentives or bonuses that players receive when they complete a certain task or reach a goal. When a player reaches the goal, the game informs the SDK that the player has received an award and has attained an achievement. This result is then saved on the Scoreloop Server. Awards are configurable, for example, you can set the number of stages required to reach the achievement. A player who achieves an award might, for example, be rewarded with in-game currency or by unlocking a new game theme.
Q: What happens to the awards achieved with no network?
A: If an award is achieved when you are offline, it is saved on the Scoreloop server the next time you are online.


Q: Who is a User? What are the user features?
A: User refers to a game player, the end-user of your game. Each user is unique with a single, universal login for all Scoreloop games and is tied to a unique BlackBerry ID. Users can edit or update their profile settings, such as their username and/or email address. Multiple devices, for example, a BlackBerry PlayBook tablet or a BlackBerry smartphone, can share the same user profile. Multiple users cannot use the same device to connect to Scoreloop.
Q: How is a user connected to Scoreloop?
A: A user uses the BlackBerry ID account to connect to Scoreloop on a device. If it is the user's first time, an immutable Scoreloop account is created and associated with the BlackBerry ID. The account is used to identify the user in all subsequent Scoreloop sessions. In addition, the user is guided through a process to set-up his personal profile by defining a modifiable login name.
Q: How are BlackBerry ID, a device and a Scoreloop user associated with each other?
A: Every BlackBerry ID on a device that is used to play a Scoreloop-enabled game is associated with a single, specific user. This close association between user and BlackBerry ID is motivated by both convenience and fairness:
  • Convenience: Users have a single, universal, one-time login that allows them to play all Scoreloop enabled games on devices associated with their BlackBerry ID without having to re-enter their credentials.
  • Fairness: Promotes a level playing field between users by preventing a user from creating multiple profiles on a single device and deliberately rigging challenges between these profiles in order to artificially increase their currency balance. Although a particular device is associated with a single user, a single Scoreloop user can be associated with more than one device.

Gaming data storage

Q: How do I support multiple devices and platforms?
A: You can keep your players' experience consistent across all their devices using Gaming Data Storage. Allow players to continue from where they left off on another device so they never have to start the game over again and unlock all those hard-earned achievements.

Testing your app

Q: With Scoreloop implemented in my game, I want to see the effect of my actions, on my Games app timeline and get to the game details page to make sure everything works.
A: All games that are in state "development" have a new behavior, to help you test your game. This behavior is limited to the beta testers of your game.
  1. Test posting of activities on the timeline.
  2. Check the game details screen.
  3. Test "favorite a game" functionality.
Scoreloop does not manage access or users to the games in this state. It is at the discretion of the game developer. Games in development will not be listed under "Popular", "New" and "Friends" games on the Games app.

Last modified: 2014-06-24

Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus