ScoreNinja is a free global ranking and high score list that you can quickly add to your Android game. There is no signup, just choose an ID and go!

How to use ScoreNinja

  1. Download the stub library: scoreninja1.2.jar.
  2. Right click your Eclipse project and choose "Build Path > Add External Archives...".
  3. Browse to and select the scoreninja jar file.
  4. Use the form below to pick an "App ID" and you will be issued a "private key".
  5. Use the ScoreNinjaAdapter as shown in the following example. Substitute in your App ID and private key.

   public class MyGame extends Activity {
    private ScoreNinjaAdapter scoreNinjaAdapter;
    protected void onCreate(Bundle savedInstanceState) {
      scoreNinjaAdapter = new ScoreNinjaAdapter(
          myContext, "yourChosenAppId", "yourGeneratedPrivateKey");

    // Unfortunate API, but you must notify ScoreNinja onActivityResult.
    protected void onActivityResult(
        int requestCode, int resultCode, Intent data) {
      super.onActivityResult(requestCode, resultCode, data);
          requestCode, resultCode, data);
    void onGameOver() {
      * Display the top 10 list with the given new score. If the newScore is in the
      * top 10, the user will be prompted to enter their name and comments.
      * Otherwise the user's ranking will be displayed at the bottom of the top 10.
      * If the com.scoreninja package is not installed, the user will be prompted
      * to install it when this constructor is invoked.
      * @param newScore The most recent score achieved by the user.
      * @param titleText If non-null, the text to display in the title bar of the
      *          window.
      * @param subBoard If non-null, an arbitrary name of a sub-board to display
      *          and apply this newScore to if it qualifies. This can be used to,
      *          for example, create a separate board for "easy", "medium", "hard".

Create a new board

By creating a board you understand and agree that your use of this code and service are at your sole discretion and risk and that they are provided "as is" and "as available" without warrenty. I am not liable to you for any damages that may be incurred though its use.