Develop
Develop
Select your platform

Leaderboards package

Updated: Dec 3, 2025
The Platform SDK Leaderboards Package creates competitive experiences through ranked scoreboards. The package writes scores to leaderboards with automatic ranking, retrieves leaderboard entries with various filtering options including friends-only, global rankings, and rank-based queries.
Different ranking criteria are supported for highest or lowest scores, and pagination support handles large leaderboards efficiently. This package enables competitive gameplay features and social comparison mechanics.

Before you begin

How to install

  1. Add the following to your project’s ./gradle/libs.versions.toml file:
     [libraries]
     // Existing lines
     leaderboards-kotlin = { module = "com.meta.horizon.platform.sdk:leaderboards-kotlin", version.ref = "horizonPlatformSdk" }
    
     dependencies {
         // Existing lines
         implementation(libs.leaderboards.kotlin)
     }
    
  2. In Android Studio, click File > Sync Project with Gradle Files to install the package.
  3. Click Build > Generate App Bundles or APKs > Generate APKs.
  4. In the “External Libraries” section of your project, confirm that these packages are listed.
     com.meta.horizon.platform.sdk:core-kotlin
     com.meta.horizon.platform.sdk:leaderboards-kotlin
    
    Now you can initialize the Platform SDK and use Leaderboards package functions in your app.

Api reference

See the exact requests and responses in the Platform SDK Leaderboards Package.
Did you find this page helpful?
Thumbs up icon
Thumbs down icon