ManiaAPI.ManiaPlanetAPI
2.10.1
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
<PackageReference Include="ManiaAPI.ManiaPlanetAPI" Version="2.10.1" />
<PackageVersion Include="ManiaAPI.ManiaPlanetAPI" Version="2.10.1" />
<PackageReference Include="ManiaAPI.ManiaPlanetAPI" />
paket add ManiaAPI.ManiaPlanetAPI --version 2.10.1
#r "nuget: ManiaAPI.ManiaPlanetAPI, 2.10.1"
#:package ManiaAPI.ManiaPlanetAPI@2.10.1
#addin nuget:?package=ManiaAPI.ManiaPlanetAPI&version=2.10.1
#tool nuget:?package=ManiaAPI.ManiaPlanetAPI&version=2.10.1
ManiaAPI.ManiaPlanetAPI
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 | 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 (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