Game Center

Contents

• Introduction
• Starting Game Center
• Reporting High Scores
• Reporting Achievements
• Displaying Boards
• Troubleshooting

Introduction

Game Center is an Apple-operated service that records high scores, achievements, and charts these types of stats against those of friends and acquaintances. If you’re familiar with XBox Live, it’s similar.

For Stencyl, we’re primarily interested in getting games to display and submit high scores and achievements.

Starting Game Center

You must start the Game Center service through a behavior before using it. You want to do this as early as possible, preferably at the start of the game.

For example, create a behavior that uses the following block (located under Game > Mobile) and add it to your starting scene. 

When the Game Center bar appears, the player is signed in. 

You can check for this status using the following block, or you can use an Event (Add Event > Mobile > Game Center > Game Center is started) if you wish to be notified when this happens.

Reporting High Scores

To submit a score, use the block shown below (located under Game > Mobile). The ID is the Leaderboard ID you specified on iTunes Connect. The value should always be a number.

Reporting Achievements

To submit an achievement, use the block shown below (located under Game > Mobile). Use the Achievement ID you specified on iTunes Connect. The value must be between 0 - 100 inclusive.

Displaying the High Score and Achievements Boards

Displaying the high score or achievements board involves the following blocks (located under Game > Mobile). Like before, in the leaderboard case, you want to specify the Leaderboard ID entered into iTunes Connect.

Using these blocks in a behavior will cause the boards to slide in.

Troubleshooting

Scores and Achievements not showing up?

Sometimes you have to wait a few hours for the data to show up in Game Center. This seems to afflict those in Europe most frequently.

Another common cause is that sometimes, Game Center requires that at LEAST 2 players need to submit scores for the board to show up at all.

baberuth
I can't get the leaderboard to launch on the iPad without crashing my game. Any ideas?

Also, the leaderboard almost always goes to my default leaderboard instead of the leaderboard for the specified ID.
0 2 weeks, 1 day ago

Jon
Cleaned up and updated for Stencyl 3.0.
0 1 month, 1 week ago

Jon
That's correct. You use the ID of the board. It's coincidental that the names used above looked like real names, but were in fact IDs.
0 9 months, 3 weeks ago

h1rnz1lla
Hello!

I had no luck displaying the right Leaderboard with using its name, like described above. But using the ID of the board instead fixed the issue!


0 11 months ago

Commenting Guidelines