ManiaAPI.ManiaPlanetAPI 2.10.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package ManiaAPI.ManiaPlanetAPI --version 2.10.1
                    
NuGet\Install-Package ManiaAPI.ManiaPlanetAPI -Version 2.10.1
                    
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.ManiaPlanetAPI" Version="2.10.1" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="ManiaAPI.ManiaPlanetAPI" Version="2.10.1" />
                    
Directory.Packages.props
<PackageReference Include="ManiaAPI.ManiaPlanetAPI" />
                    
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.ManiaPlanetAPI --version 2.10.1
                    
#r "nuget: ManiaAPI.ManiaPlanetAPI, 2.10.1"
                    
#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.ManiaPlanetAPI@2.10.1
                    
#: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.ManiaPlanetAPI&version=2.10.1
                    
Install as a Cake Addin
#tool nuget:?package=ManiaAPI.ManiaPlanetAPI&version=2.10.1
                    
Install as a Cake Tool

ManiaAPI.ManiaPlanetAPI

NuGet

Wraps https://maniaplanet.com/swagger (ManiaPlanet web API). This API does not require authorization, but you can authorize to have more methods available.

Features

  • All available on Swagger
  • Couple of ingame requests:
    • Authenticating a ManiaPlanet user via login and token
    • Search title packs (contains more info than from WebServices)
    • Get title pack info (contains more info than from WebServices)
    • Search online servers (if you have login and token, allows filtering by favorites)
    • Downloading a title pack
  • Channel map leaderboards from the Channel Record API:
    • Top 10 records with the ranks of chosen players
    • Pages of records, up to 101 at once
    • A player's record and rank
  • Channel map feedback totals (yes/no votes and star ratings) from the Channel Feedback API

Setup

For the list of scopes, see here at the bottom. Generate your credentials here.

using ManiaAPI.ManiaPlanetAPI;

var mp = new ManiaPlanetAPI();

// You can optionally authorize to do more things, and possibly be less limited
await mp.AuthorizeAsync("clientId", "clientSecret", ["basic", "dedicated", "maps"]);

// Ready to use

For ingame API, use the ManiaPlanetIngameAPI. This is not an authenticated API, but you can use it to authenticate logins of users or servers by their token.

using ManiaAPI.ManiaPlanetAPI;

var mpIngame = new ManiaPlanetIngameAPI();

// Authenticate a user
var user = await mpIngame.AuthenticateAsync("username", "token");

if (user.Login != "username")
{
	throw new Exception("Invalid token");
}

For leaderboards of channel maps, use the ManiaPlanetChannelRecordAPI. It doesn't need authorization.

using ManiaAPI.ManiaPlanetAPI;

var channel = new ManiaPlanetChannelRecordAPI();

// Top 10, the number of records, and the ranks of the given players
var leaderboard = await channel.GetLeaderboardAsync("9W_9qjV56i67CWpYDclFyOhz5g", ["lbt76240"]);

// Records 101 to 200
var page = await channel.GetRecordsAsync("9W_9qjV56i67CWpYDclFyOhz5g", offset: 100, length: 100);

// A player's record, or null Record when they have none
var player = await channel.GetPlayerRecordAsync("9W_9qjV56i67CWpYDclFyOhz5g", "lbt76240");

For feedback of channel maps, use the ManiaPlanetChannelFeedbackAPI. Only the totals are public; votes and ratings of single maps need the game servers' credentials.

using ManiaAPI.ManiaPlanetAPI;

var feedback = new ManiaPlanetChannelFeedbackAPI();

var status = await feedback.GetStatusAsync();

Console.WriteLine($"{status.YesNo.VotesYes} yes, {status.YesNo.VotesNo} no, {status.Stars.Notes5Star} five-star ratings");

For DI, consider using the ManiaAPI.ManiaPlanetAPI.Extensions.Hosting package.

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 (1)

Showing the top 1 NuGet packages that depend on ManiaAPI.ManiaPlanetAPI:

Package Downloads
ManiaAPI.ManiaPlanetAPI.Extensions.Hosting

Extension methods of ManiaPlanet API for ASP.NET Core. Part of the ManiaAPI.NET library set.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
2.11.0 49 11/20/2026
2.10.1 87 11/17/2026
2.10.0 123 11/14/2026
2.8.5 233 7/2/2026
2.7.0 294 2/21/2026
2.6.0 201 2/7/2026
2.5.1 479 10/19/2025
2.4.0 520 9/18/2025
2.3.1 268 8/21/2025
2.2.0 362 4/6/2025
2.1.0 610 3/24/2025
2.0.0 309 3/23/2025
2.0.0-beta3 169 12/21/2024
2.0.0-beta2 202 7/12/2024
2.0.0-alpha2 346 11/1/2023
2.0.0-alpha10 190 6/19/2024

- Fixed authorization failing on access tokens with fractional timestamps
- Made `AuthorizationResponse.RefreshToken` nullable and obsolete, as ManiaPlanet never sends it