Wrapper for the official in-game Nadeo API from Trackmania released in 2020. Part of the ManiaAPI.NET library set.
Get Started
$ dotnet add package ManiaAPI.NadeoAPIReadme
ManiaAPI.NadeoAPI
Wraps the official Nadeo API used in the latest Trackmania (2020). This API requires authentication.
After initial authentication, the connectivity is managed by the library, so you don't have to worry about refreshing the token.
The game provides 3 domains, and they are split into 3 separate services:
NadeoServicesfor the core functionalityNadeoLiveServicesfor leaderboards, clubs, and other live contentNadeoMeetServicesfor getting the current Cup of the Day
Features
For NadeoServices:
- Get map records
- Get account records
- Get player zones
- Get API routes
- Get all available zones
- Get player club tags
- Get map info
For NadeoLiveServices:
- Edit club campaigns
- Edit club activities
- Get map info
- Get map leaderboards
- Get leaderboard positions by time
- Get map medal records
- Get seasonal campaigns
- Get weekly shorts and grands
- Get TOTDs
- Get club campaigns
- Get club info
- Get club members
- Get club activities
- Get club rooms
- Get player season rankings
- Get active advertisements
- Join daily channel (COTD)
For NadeoMeetServices:
- Get the current Cup of the Day
- Get various Cups of the Day
Setup for a single service
using ManiaAPI.NadeoAPI;
var ns = new NadeoServices();
await ns.AuthorizeAsync("mylogin", "mypassword", AuthorizationMethod.UbisoftAccount);
// Ready to use
var zones = await ns.GetZonesAsync();
You can also use a dedicated server. Just be aware it has some limitations.
await ns.AuthorizeAsync("my_dedicated_server", "ls>97jO>e3>>D/Ce", AuthorizationMethod.DedicatedServer);
For other services, just replace NadeoServices with NadeoLiveServices or NadeoMeetServices.
Setup for multiple services
using ManiaAPI.NadeoAPI;
var login = "mylogin";
var password = "mypassword";
var ns = new NadeoServices();
await ns.AuthorizeAsync(login, password, AuthorizationMethod.UbisoftAccount);
var nls = new NadeoLiveServices();
await nls.AuthorizeAsync(login, password, AuthorizationMethod.UbisoftAccount);
// Ready to use combined
// With NadeoLiveServices
var weeklyCampaigns = await nls.GetSeasonalCampaignsAsync(1);
var campaignMap = weeklyCampaigns.CampaignList.First().Playlist.First();
var mapInfo = await nls.GetMapInfoAsync(campaignMap.MapUid);
var mapLeaderboard = await nls.GetTopLeaderboardAsync(campaignMap.MapUid);
// With NadeoServices
var records = await ns.GetMapRecordsAsync(mapLeaderboard.Top.Top.Select(x => x.AccountId), mapInfo.MapId);
For DI, consider using the ManiaAPI.NadeoAPI.Extensions.Hosting package. It also handles the authorization for you without additional startup code.