Local Leaderboard Module

This Local Leaderboard Module 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.

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

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/
│   │   ├── leaderboard_display.verse
│   │   ├── leaderboard_item.verse
│   │   └── utilities.verse
│   │   
│   └── VersePersistenceModule/
│       ├── increase_stat_location.verse
│       ├── stats_persistence.verse
│       └── utilities.verse
│   
├── Textures/
│   ├── leaderboard_time_played.png
│   └── leaderboard_wins.png
│   
└── README.md

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.