Overview

This page includes everything needed to use this feature in the "Beamable SDK for Unity". Or watch this video.

The purpose of this feature is to allow the player to see the LeaderboardLeaderboard - A list of high scores by all players of a game.

The User Interface

When setup properly, the player's user interface in the game project will be as follows.

Steps

Follow these steps to get started.

Here is the "Beamable" menu as seen in Unity.

Here is the feature Prefab as seen in the Beamable Toolbox.

Advanced

Here are a few advanced configuration options and workflows.

Creating Leaderboard Content

LeaderboardLeaderboard - A list of high scores by all players of a game content is required to properly populate the Leaderboard UI.

Step	Detail
Open the Content Manager Window	• Unity → Window → Beamable → Open Content Manager
Expand the "Leaderboards" Section	• Click the button
Add the "Leaderboard"	• Click the :heavy-plus-sign: button • Populate the name
Open the Unity Project Window	• Unity → Window → General→ Project
Select the leaderboard asset	• Search by the name given in step #3 • View the asset in the Unity Inspector Window
(Optional) Configure data fields	*Note: The Write_self variable allows for control of Leaderboard permissions. See the Beamable Security & Permissions callout for more info.
Save the Unity Project	• Unity → File → Save Project Best Practice: If you are working on a team, commit to version control in this step.
Publish the content	• Press the "Publish" button in the Content Manager Window

❗️

Beamable Security & Permissions

Each Leaderboard content object asset includes a write_self field.

• True: Allows for client-authoritative score updates. Benefits include ease-of-use for game makers and is ideal for a game which can tolerate the occasional cheater. It is hackable.
• False: Allows for server-authoritative score updates and requires additional setup via Microservices. Benefits include higher system security and is ideal for a game which requires that. It is less hackable.

Rewarding Leaderboard-Related Score

To appear on the Leaderboard, a player must have a competitive score.

During Development

The Portal allows the game maker to view and edit a player's score. This is a helpful, temporary workflow during the design and development of a new game feature.

During Production

To properly reward the players with score in production code, use custom C#. See the following example for inspiration.

namespace DisruptorBeam.Examples.Features.LeaderboardFlow
{
   public class LeaderboardSetScoreExample : MonoBehaviour
   {
      public double Score;
      public LeaderboardRef Leaderboard;

      protected async void Start()
      {
         LeaderboardSetScore(Leaderboard.Id, Score);
      }

      private async void LeaderboardSetScore(string id, double score)
      {
         var de = await DisruptorBeam.DisruptorEngine.Instance;
         await de.LeaderboardService.SetScore(id, score);
      }
   }
}

Managing Leaderboard Via Portal

The Portal allows the game maker to manage LeaderboardLeaderboard - A list of high scores by all players of a games.

Step	Detail
Open the Portal Window	• See Portal for more info
Click a Realm
Click a Leaderboard
Administer the Leaderboard	Available Operations • Delete a single score • Delete the Leaderboard • Clear the Leaderboard Note: Some of these operations cannot be undone.

📘

FAQ

Here are highlights from the Beamable FAQ. See FAQ for more info.

• Leaderboard Flow