Local Leaderboard

This Local Leaderboard lets you manage and display dynamic leaderboards in your UEFN maps. Configure how scores are fetched, sorted, and rendered on billboards so you can focus on designing competitive, replayable gameplay. Swap in your own billboard styles and HUD layouts to match your world’s aesthetic.

A local leaderboard fetches data from the current session since the platform currently doesn't allow retrieving information from players outside the current session.

New in 1.1.0

Now you can set up your leaderboards to keep data from players who already left your map! While this isn't yet a Global Leaderboard where you can retrieve data from others sessions (it's not yet possible) this new version doesn't clear leaderboard data from players who left the session and only does so when it needs to be replaced by a new score/stat at that position.

Perfect for: racing games, time trials, FPS arenas, party minigames, or any experience that benefits from a real-time top-scores display.

As seen on:

KARKI'S PARTY ROYALE (1654-5067-2782)

Fortnite.GG Link

Airlock Crisis (2888-6118-5758)

Fortnite.GG Link

Overview

The leaderboard_display.verse device handles the full leaderboard lifecycle: it periodically pulls player stats via a custom GetAllPlayersStat(StatType) function, sorts entries (ascending or descending), and updates your array of leaderboard_item billboard devices. Integration with stats_persistence.verse ensures you’re always showing the latest persisted stat values.

Key Features

Included Stats

• TimePlayed
• Wins (increased manually by Trigger Device)

Leaderboard Item
Define individual entries in leaderboard_item.verse—each with two editable billboards (PlayerNameBillboard and StatBillboard) plus `Clear()` and `UpdateDevices()` methods for easy control.

Auto-Refresh Display
leaderboard_display.verse auto-refreshes at your chosen UpdateRate (default 5 seconds), applies your chosen sort order (`IsAscending`), and maps values to each billboard instance.

Persistence Integration
Leverages VersePersistenceModule.stats_persistence to load and save stats like TimePlayed. Easily extend the stat_type enum and persistence logic for custom metrics.

Editable Billboards
Position, resize, and style each billboard in UEFN. Tweak fonts, colors, or layouts directly on your Billboard Devices.

Centralized Manager
One creative device (leaderboard_display) handles fetching, sorting, and UI updates—no extra scripting required for each new leaderboard you add.

Project Outline

Content/
├── Scripts/
│   ├── CoreModule/
│   │   ├── agent_spawner_manager.verse
│   │   ├── game_manager.verse
│   │   └── utilities.verse
│   ├── CustomPlayerModule/
│   │   ├── custom_player_manager.verse
│   │   └── custom_player.verse
│   ├── LeaderboardModule/
│   │   ├── custom_types.verse
│   │   ├── leaderboard_display.verse
│   │   ├── leaderboard_item.verse
│   │   ├── leaderboards_manager.verse
│   │   └── utilities.verse
│   └── VersePersistenceModule/
│       ├── increase_stat_location.verse
│       ├── stats_persistence.verse
│       └── utilities.verse
├── Textures/
│   ├── leaderboard_time_played.png
│   └── leaderboard_wins.png
├── CHANGELOG.md
└── README.md

Frequently Asked Questions

What does the Local Leaderboard show?

Rankings of players by a saved stat, such as time played or wins, written onto Billboard devices in your level. It refreshes every few seconds and hides unused rows.

Which stats can it show?

Time played and wins out of the box, using the included persistence module, plus a trigger-based Increase Stat Location to raise a stat from any device. New stats can be added in Verse.

Can players switch what the board shows?

Yes. The Leaderboards Manager lets players cycle through stats with a Button device, with a display format and sort order per stat.

How do I set it up?

For each row place two Billboards (name and value) as a leaderboard item, list the items on a Leaderboard Display, and set the stat, format and refresh rate. Player Spawners register players. No code is needed; it needs UEFN.

Do rows move when ranks change?

Yes. With Preserve Agents on, players keep their slot and the billboards physically reorder by rank. Off, the board rebuilds every refresh.

NOTE: Level design is not included—this package provides the code and logic system only. The code is sold as is. Updates to the code and bug fixes can be obtained but aren't guaranteed.