> For the complete documentation index, see [llms.txt](https://assetstore.essentialkit.voxelbusters.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://assetstore.essentialkit.voxelbusters.com/features/game-services/playmaker/use-cases/use-case-3-leaderboard-submit.md).

# Leaderboard Score Submit

## Goal

Report a score and optionally open the native Leaderboard UI.

## Prerequisite

Make sure the player is authenticated first. Use `use-case-1-auth-bootstrap.md` for a safe startup flow.

## Actions used

* `GameServicesReportScore`
* `GameServicesGetReportScoreSuccessResult` (on success)
* `GameServicesGetReportScoreError` (on failure)
* `GameServicesShowLeaderboardUI` (optional)

## Variables

* `leaderboardId` (String) e.g. `"top_scores"`
* `scoreValue` (Int)

## Flow

1. When the match ends (or on a milestone), store the score in `scoreValue`.
2. State: `ReportScore`
   * Action: `GameServicesReportScore`
   * Inputs: `leaderboardId`, `scoreValue` (and optional `tag`)
   * Events:
     * `successEvent` → `GetReportScoreSuccessResult` → (optional) `ShowLeaderboardUI`
     * `failureEvent` → `GetReportScoreError` (log/ignore)
3. State: `ShowLeaderboardUI` (optional)
   * Action: `GameServicesShowLeaderboardUI`
   * Input: `leaderboardId` (to open a specific board)

## Notes

* `GameServicesReportScore` waits for completion. Use the extractor actions immediately after its `successEvent`/`failureEvent`.
* Some platforms keep only the best score; submitting a lower score may not change ranking.