ManiaAPI.UnitedLadder
2.11.0
dotnet add package ManiaAPI.UnitedLadder --version 2.11.0
NuGet\Install-Package ManiaAPI.UnitedLadder -Version 2.11.0
<PackageReference Include="ManiaAPI.UnitedLadder" Version="2.11.0" />
<PackageVersion Include="ManiaAPI.UnitedLadder" Version="2.11.0" />
<PackageReference Include="ManiaAPI.UnitedLadder" />
paket add ManiaAPI.UnitedLadder --version 2.11.0
#r "nuget: ManiaAPI.UnitedLadder, 2.11.0"
#:package ManiaAPI.UnitedLadder@2.11.0
#addin nuget:?package=ManiaAPI.UnitedLadder&version=2.11.0
#tool nuget:?package=ManiaAPI.UnitedLadder&version=2.11.0
ManiaAPI.UnitedLadder
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 | Versions 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. |
-
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.
- 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