Easy Leaderboard implementation!

Add leaderboard functionality to your games!

Welcome to Klikgamer Leaderboards!

Designed for Clickteam Fusion 2 users!

Everyone can use our service, but our support and examplefiles are dedicated to Clickteam Fusion 2.5 users.

Start-up period!

Klikgamer Leaderboards is brand new, and we hope that you will help us test it together with us. Currently, number of leaderboards for each user will be limited to 3, and numbers of total requests limited to 1.000.000. However, if you find yourself in need of more leaderboards or more requests, you can contact us at support@klikgamer.com.

We accept donations!

Running this service comes with a cost, and therefore we're very happy for every donation we recieve. Donations are optional of course, and it is totally up to you how much you want to donate.

Instructions!

Examplefiles for Clickteam Fusion 2.5!

If you develop your game in Clickteam Fusion 2.5, leaderboard integration is very easy, as we provide fully functional .mfa example files for you!

Clickteam Fusion 2.5 is one of the most powerful and easy to use Game Developments Tools there are. If you don't allready own it, make sure to visit www.clickteam.com and check it out!

Below is an explanation of the HTTP calls and Leaderboard format.

Upload a score

Before calling the server, you need to add HTTP POST data.

Required parameters:

Action = Add score.
Playername = Player's name.
Score = Player's score.
Leaderboard Code = A unique leaderboard ID generated for each leaderboard.
DeviceID = A string of your choice to identify the player's device.
Scorehash = MD5 signature of Leaderboard Code + DeviceID + Score + Leaderboard Secret Code.

Optional parameters:

Ignore Playername = Set to Yes if score should be based on DeviceID only. Set to No if the game supports several players on the same device.
Important: If set to yes, this setting will automatically replace any old playernames submitted with the current one. If there are more than one score entry from this device allready in the leaderboard, all but the best one will be erased.
Level = Level reached.
System = For instance PC, Mac or Android Phone etc..
OS = Operating system.
Gameversion = A float number indicating the version of the game, for instance 1.0.
Extra integer = An integer.
Extra string = A short string.
Extra text = A long text, for instance ghost car coordinates.

Then call this url: http://scoreserver.klikgamer.com

If it's a success, it will return the string: Status: Score added.

Retrieve Leaderboard:

Before calling the server, you need to add HTTP POST data.

Action = Leaderboard.
Leaderboard Code = A unique leaderboard ID generated for each leaderboard.
DeviceID = A string of your choice to identify the player's device.
Variables = A string to select which columns to show, for instance:
Detect Device = Yes, Level = Yes, Gameversion = Yes, OS = Yes, System = No, Extra Integer = No, Extra String = No, Extra Text = No, ScoreID = Yes

Order = Descending for normal leaderboard or Ascending if the lowest score is the best one.
Number of scores = An integer that is higher than 0. Select how many scores to show.
First score = Select which score to start from. For instance 500 will only select scores ranked 500 and lower.

Then call this url: http://scoreserver.klikgamer.com

If it's a success, it will return the leaderboard.

Leaderboard Format

The leaderboard will retrieve all variables in this format: Variable name:Value
The variables will be divided by an '|'.
A line in the leaderboard may look like this:

Rank:1|Name:Popcorn|Score:17000|Device:This|Level:17|Gameversion:1.00|OS:Windows|ScoreID:20

The first three columns will always be retrieved, the rest depends on what you selected in the Variables parameter. They will be retrieved in the same order as you put them in the Variables parameter.

The Device:This column tells us that the score was submitted by the device that requested the leaderboard. For all other scores it will say Device:Other.

Retrieve Mixed Leaderboard:

A mixed leaderboard is a combination of the best scores and scores near the player.
Add Leaderboard Code, DeviceID, Variables and Order as POST DATA as described in the Retrieve Leaderboard section.

In addition add the following attributes as POST DATA:

Action = Mixed Leaderboard.
Playername = Player's name.
Number of top scores = Number of top scores that should be shown. If this attribute is not set, or if set to 0, the top scores wouldn't be shown.
Number of scores above player = Number of scores ranked right above the player that should be shown.
Number of scores below player = Number of scores ranked right below the player that should be shown.

Then call this url: http://scoreserver.klikgamer.com

If it's a success, it will return the mixed leaderboard.

Reset leaderboard:

You can easily reset the leaderboard from within your application. This will delete all the scores from your leaderboard and is not reversable.
Add Leaderboard Code as POST DATA as described in the Retrieve Leaderboard section.

In addition add the following attributes as POST DATA:

Action = Reset leaderboard.
Leaderboardhash = MD5 signature of Leaderboard Code + Leaderboard Secret Code.

Then call this url: http://scoreserver.klikgamer.com

If it's a success, it will reset the leaderboard.

Get Score Entry

You can retrieve a single score entry from the leaderboard.
Add Leaderboard Code, DeviceID, Variables and Order as POST DATA as described in the Retrieve Leaderboard section.

In addition add the following attributes as POST DATA:

Get Score Entry From ScoreID
Action = Get Score Entry From ID.
ScoreID = The ScoreID of the score entry you want to retrieve.

OR

Get Score Entry From Playername
Action = Get Score Entry From Playername.
Playername = The name of the player. It must match the DeviceID.

The order variable is used to determine which rank to assign to the score entry.

Change playername

You can change the name of the player during any request. Simply add POST DATA: Change Playername = Playername.
This will only work if the DeviceID has only one score entry attached. If scores were added with Ignore Playername = No, and the device has several players, the namechange will have no effect.
Note: When submitting a score and Ignore Playername is yes, a namechange happens automatically.

Features!

100% free!

The Klikgamer Leaderboard service is 100% free, but we accept donations!

Fully working examples for Clickteam Fusion 2.5!

After adding Leaderboards, Fusion 2 owners only need to download the examples and change the Leaderboard Code!

Cross platform!

Works with any development environment that supports HTTP Get and Post.
For Fusion users this means that it works with all exporters!

Get the cheaters!

View the leaderboard and simply hide entries that's obviously cheating!

One entry per player!

Neat and clean leaderboards that updates the scores for each player.

No player registration!

Klikgamer does not use a player login system. Players are identified by their device and playername.

Ghost car!

Store large ammounts of text along with the highscore, such as ghost car coordinates!

Open source example game for Fusion 2.5!

Download!