ManiaAPI.UnitedLadder 2.11.0

dotnet add package ManiaAPI.UnitedLadder --version 2.11.0
                    
NuGet\Install-Package ManiaAPI.UnitedLadder -Version 2.11.0
                    
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="ManiaAPI.UnitedLadder" Version="2.11.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ManiaAPI.UnitedLadder" Version="2.11.0" />
                    
Directory.Packages.props
<PackageReference Include="ManiaAPI.UnitedLadder" />
                    
Project file
For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.
paket add ManiaAPI.UnitedLadder --version 2.11.0
                    
#r "nuget: ManiaAPI.UnitedLadder, 2.11.0"
                    
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
#:package ManiaAPI.UnitedLadder@2.11.0
                    
#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.
#addin nuget:?package=ManiaAPI.UnitedLadder&version=2.11.0
                    
Install as a Cake Addin
#tool nuget:?package=ManiaAPI.UnitedLadder&version=2.11.0
                    
Install as a Cake Tool

ManiaAPI.UnitedLadder

NuGet

Wraps the UnitedLadder API, which combines TrackMania Forever profiles, rankings, statistics, and historical data. Authentication is not required.

Features

  • Player profiles, including solo and multiplayer statistics, zone ranks, tags, and metadata
  • Force a profile refresh through TMF Web Services with forceWebServices: true
  • Solo and multiplayer rankings by zone and environment
  • Track leaderboards, including record scores and ghost links
  • A player's official map results and statistics by environment and campaign
  • Login registration and United account status
  • Player history and progression of skill points, ladder points, or nicknames
  • Recent leaderboard snapshots
  • Ghost replay downloads by track UID and numeric player ID

Setup

using ManiaAPI.UnitedLadder;

using var ul = new UnitedLadder("MyApp/1.0 (contact: me@example.com)");

var player = await ul.GetPlayerAsync("bigbang1112");
var refreshed = await ul.GetPlayerAsync("bigbang1112", forceWebServices: true);
var solo = await ul.GetSoloRankingsAsync(zone: "World|France", page: 0);
var multiplayer = await ul.GetMultiplayerRankingsAsync(environment: "Stadium");
var leaderboard = await ul.GetTrackLeaderboardAsync("BeySZdnfuSh4nHY5xztiXLmlrXe");
var maps = await ul.GetPlayerMapsAsync("bigbang1112");
var breakdown = await ul.GetPlayerSoloBreakdownAsync("bigbang1112");
var registration = await ul.CheckLoginAsync("bigbang1112");

or with DI, using an injected HttpClient:

using ManiaAPI.UnitedLadder;

builder.Services.AddHttpClient<UnitedLadder>();

All paged methods use zero-based pages. Zone paths such as World|France and player logins are escaped automatically. Environments are Stadium, Island, Desert, Rally, Bay, Coast, Snow, Mixed, or Merge; multiplayer rankings default to Merge.

History and progression

var start = new DateTimeOffset(2026, 1, 1, 0, 0, 0, TimeSpan.Zero);
var history = await ul.GetPlayerHistoryAsync("bigbang1112", startDate: start);
var points = await ul.GetPlayerProgressionAsync("bigbang1112",
    field: "ladderpoints", environment: "Stadium", startDate: start);
var names = await ul.GetPlayerProgressionAsync("bigbang1112", field: "nickname");
var snapshot = await ul.GetLeaderboardSnapshotAsync("solo", environment: "solo", page: 0);

Replay files

using var response = await ul.GetReplayResponseAsync("BeySZdnfuSh4nHY5xztiXLmlrXe", player.Id);
await using var file = File.Create("ghost.Replay.Gbx");
await response.Content.CopyToAsync(file);
Product Compatible and additional computed target framework versions.
.NET net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed.  net9.0 is compatible.  net9.0-android was computed.  net9.0-browser was computed.  net9.0-ios was computed.  net9.0-maccatalyst was computed.  net9.0-macos was computed.  net9.0-tvos was computed.  net9.0-windows was computed.  net10.0 is compatible.  net10.0-android was computed.  net10.0-browser was computed.  net10.0-ios was computed.  net10.0-maccatalyst was computed.  net10.0-macos was computed.  net10.0-tvos was computed.  net10.0-windows was computed.  net11.0 is compatible. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • net10.0

    • No dependencies.
  • net11.0

    • No dependencies.
  • net8.0

    • No dependencies.
  • net9.0

    • No dependencies.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.11.0 50 11/20/2026
2.10.0 95 11/14/2026
2.7.0 225 2/21/2026
2.6.0 152 2/7/2026
2.3.3 471 8/24/2025
2.3.2 164 8/23/2025

- Added `GetSoloRankingsAsync`, `GetMultiplayerRankingsAsync`, `GetTrackLeaderboardAsync`, and `GetLeaderboardSnapshotAsync`
- Added `GetPlayerMapsAsync`, `GetPlayerSoloBreakdownAsync`, `GetPlayerHistoryAsync`, and `GetPlayerProgressionAsync`
- Added `CheckLoginAsync`, `GetReplayResponseAsync`, and a `forceWebServices` overload of `GetPlayerAsync`
- Added constructors with an application User-Agent