Developer Docmentation

Java Docs
Dev Client Lib
Dev Key Generation

These are the instructions, if you are interested in trying out what we have to offer.

Download the Dev Client Lib. This is a simple jar file: Dev Client Lib

Generate a new dev key. Dev Key Generation

Reference the Javadocs. Java Docs

All you need to do is instantiate a ploxium.multiplox.client.PloxiumClient each time your app loads. To do that, you'll need the App ID and keypair generated in the last step. Call addScore() as appropriate. Let users go to the URL returned by getLoginURL() if they want to check out their profiles or scores.

Important: these steps set you up on our development environment. This is for testing only and we can and will nuke it at random times.

Production

If you want to go into production, email us (support@ploxium.com). We are keeping this portion manual so we get to hear from you about what you are doing. We will want to know the name of your app, some urls and whom we should contact if there are any problems. We will assign an application ID on our production environment, give you the production client library jar file and put your application key into our system.

If you are not comfortable running our library without being able to see what it does, contact us and we can probably work something out.

About Scores

addScore() takes three parameters. The string 'component' and and 'score_type' can be anything you want. The double 'value' should be the score value. For component we suggest using that to refer to what portion or module of the game it is. Score type should be used to differentiate multiple things you might be tracking about a specific component. For example, if the game was like Super Mario Brother some score entries might be:

component="Level 1-1", score_type="Score", value=18393
component="Level 1-1", score_type="Time", value=-187
component="Level 1-1", score_type="Bricks Destroyed", value=12

A few things to note, the value is always considered to be highest number is better. So if you are storing something where a lower number is better (example "Time") it might be nessesary to invert the numbers. The top score pages will show the highest 'value'.