viverse-leaderboard

Submit scores and retrieve rankings via the gameDashboard SDK for VIVERSE worlds.

2|1|Updated Mar 28, 2026
One-click install
npx skills add https://github.com/viverseofficial/viverse-sdk-skills --skill viverse-leaderboard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: viverse-leaderboard
Source: https://github.com/viverseofficial/viverse-sdk-skills/tree/main/skills/viverse-leaderboard
Command: npx skills add https://github.com/viverseofficial/viverse-sdk-skills --skill viverse-leaderboard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill solves the complexity of integrating persistent, cross-session global leaderboards into VIVERSE worlds, ensuring data integrity and preventing common implementation pitfalls.

Core Features & Use Cases

  • Global Ranking Management: Provides a standardized workflow for uploading scores and fetching top-N or around-user rankings.
  • Idempotent Submission: Includes mandatory logic to prevent duplicate score inflation during match-end events.
  • Use Case: A developer building a competitive racing game uses this skill to ensure that player lap times are accurately recorded, ranked, and displayed without duplicate entries or API errors.

Quick Start

Use the viverse-leaderboard skill to initialize the gameDashboard client and upload a player score to the configured leaderboard.

Frequently Asked Questions about viverse-leaderboard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I implement persistent global rankings in a VIVERSE world?

To implement persistent global rankings in a VIVERSE world, use this skill to initialize the gameDashboard SDK client, submit player scores, and retrieve top-N or around-user ranking data.

How do I prevent duplicate score submissions when uploading to a VIVERSE leaderboard?

Preventing duplicate score submissions on a VIVERSE leaderboard requires implementing the mandatory idempotent submission logic provided by this skill during match-end events to stop score inflation.

Do I need VIVERSE Studio configuration to fetch around-user rankings?

Yes, fetching around-user rankings requires VIVERSE Studio configuration along with valid authentication tokens to initialize the gameDashboard SDK client and ensure accurate cross-session data persistence.

What is the best way to retrieve top-N player scores for a VIVERSE game dashboard?

The best way to retrieve top-N player scores for a VIVERSE game dashboard is using this skill's standardized workflow to fetch rankings while handling API errors for competitive game mechanics.

Why does my VIVERSE leaderboard API return authentication errors during score submission?

VIVERSE leaderboard API authentication errors during score submission typically occur when valid authentication tokens are missing or improperly configured within your VIVERSE Studio environment.