Modrinth.Net 3.0.10

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

Modrinth.Net

GitHub Nuget Nuget (with prereleases) Modrinth API

Usage

using Modrinth;

// You must provide a user-agent, and optionally an authentication token if you wish to access authenticated API endpoints
var client = new ModrinthClient(userAgent: "My_Awesome_Project", token: "Your_Authentication_Token");

var project = await client.Project.GetAsync("sodium");

Console.WriteLine(project.Description);

User-Agent

  • You can also use the UserAgent class to help you create a valid user-agent
  • User-Agent currently cannot be changed after the client has been created
  • More info about the User-Agent can be found here
using Modrinth;
using Modrinth.Client;

// Note: All properties are optional, and will be ignored if they are null or empty
var userAgent = new UserAgent
{
    ProjectName = "ProjectName",
    ProjectVersion = "1.0.0",
    GitHubUsername = "Username",
    Contact = "contact@contact.com"
};

var client = new ModrinthClient(userAgent: userAgent, token: "Your_Authentication_Token");
  • You can search for projects using the SearchAsync method, in the Project endpoint
using Modrinth;
using Modrinth.Client;

var client = new ModrinthClient(userAgent: "My_Awesome_Project");

var search = await client.Project.SearchAsync("sodium");

foreach (var project in search.Projects)
{
    Console.WriteLine(project.Title);
}
Search with facets/filtering
  • You can filter the search results by using facets, which are a way to filter the results by certain criteria
  • You can read more about facets here
  • You can create a FacetCollection and add facets to it, and then pass it to the SearchAsync method

Example:

// For search with facets, you first need to create a FacetCollection
var facets = new FacetCollection();

// Then you can add facets to it
// You add a facet by calling the Add method on the FacetCollection
// In one call, you can add multiple facets, they will be combined in an OR statement
// If you call Add again, the new facets will be combined in an AND statement with the previous ones

// Example:
facets.Add(Facet.Category("adventure"), Facet.Version("1.19.3"));
facets.Add(Facet.Category("magic"));

// This will create a query that looks like this:
// (category:adventure OR version:1.19.3) AND category:magic

// Then you can pass the FacetCollection to the SearchAsync method
var search = await _client.Project.SearchAsync("", facets: facets);

Unsuccesful API calls

  • If the API call was unsuccessful, the client will throw an ModrinthApiException exception
  • This will be thrown if the API call return non-200 status code, or if the response body is not valid JSON
  • This approach will be revisited in future versions
using Modrinth;
using Modrinth.Exceptions;
using System.Net;

var client = new ModrinthClient(userAgent: "My_Awesome_Project");

try 
{
    var project = await _client.Project.GetAsync("non-existent-project");
    
    Console.WriteLine(project.Title);
}
// You can catch the exception and only handle the 404 status code
catch (ModrinthApiException e) when (e.StatusCode == HttpStatusCode.NotFound) 
{
    Console.WriteLine("Project not found");
}
// Or you can catch the exception and handle all non-200 status codes
catch (ModrinthApiException e)
{
    Console.WriteLine($"API call failed with status code {e.StatusCode}");
}

List of endpoints and their support in this library

Icon Meaning
✅ Implemented
❌ Not implemented
⚠️ Untested

Project endpoints

Name Method Implemented
Search projects GET ✅
Get a project GET ✅
Modify a project PATCH ❌
Delete a project DELETE ✅
Get multiple projects GET ✅
Edit multiple projects PATCH ❌
Get a list of random projects GET ✅
Create a project POST ❌
Change project's icon PATCH ✅
Delete project's icon DELETE ✅
Check project slug/ID validity GET ✅
Add a gallery image POST ✅
Modify a gallery image PATCH ✅
Delete a gallery image DELETE ✅
Get all of a project's dependencies GET ✅
Follow a project POST ✅
Unfollow a project DELETE ✅
Schedule a project POST ❌

Version endpoints

Name Method Implemented
Get list of project's versions GET ✅
Get a version GET ✅
Modify a version PATCH ❌
Delete a version DELETE ⚠️
Create a version POST ❌
Schedule a version POST ⚠️
Get multiple versions GET ✅
Add files to version POST ❌

Version file endpoints

Name Method Implemented
Get version from hash GET ✅
Delete a file from its hash DELETE ✅
Latest version of a project from a hash, loader(s), and game version(s) POST ❌
Get versions from hashes POST ❌
Latest versions of multiple projects from hashes, loader(s), and game version(s) POST ❌

User endpoints

Name Method Implemented
Get a user GET ✅
Modify a user PATCH ❌
Delete a user DELETE ❌
Get user from authorization header GET ✅
Get multiple users GET ✅
Change user's avatar PATCH ✅
Get user's projects GET ✅
Get user's notifications GET ✅
Get user's followed projects GET ✅
Get user's payout history GET ❌
Withdraw payout balance to PayPal or Venmo POST ❌

Team endpoints

Name Method Implemented
Get a project's team members GET ✅
Get a team's members GET ✅
Add a user to a team POST ❌
Get the members of multiple teams GET ✅
Join a team POST ❌
Modify a team member's information PATCH ❌
Remove a member from a team DELETE ❌
Transfer team's ownership to another user PATCH ❌

Tag endpoints

Name Method Implemented
Get a list of categories GET ✅
Get a list of loaders GET ✅
Get a list of game versions GET ✅
Get a list of licenses GET ✅
Get a list of donation platforms GET ✅
Get a list of report types GET ✅

Miscellaneous endpoints

Name Method Implemented
Report a project, user, or version POST ❌
Various statistics about this Modrinth instance GET ✅
Product Compatible and additional computed target framework versions.
.NET net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 was computed.  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 was computed.  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 was computed.  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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (1)

Showing the top 1 NuGet packages that depend on Modrinth.Net:

Package Downloads
Gml.Core

Package Description

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
3.8.2 449 10/17/2026
3.8.1 150 10/17/2026
3.8.0 632 6/9/2026
3.7.2 2,390 4/15/2026
3.7.1 171 4/14/2026
3.7.0 157 4/13/2026
3.6.0 1,421 8/6/2025
3.5.2 367 8/6/2025
3.5.1 524 6/2/2025
3.5.0 750 2/18/2025
3.4.5 1,555 4/22/2024
3.4.4 286 4/21/2024
3.4.3 427 2/22/2024
3.4.2 336 2/22/2024
3.4.1 303 1/29/2024
3.4.0 518 11/28/2023
3.4.0-alpha2 217 9/29/2023
3.4.0-alpha 236 9/29/2023
3.3.0 525 8/7/2023
3.0.10 374 3/20/2023
Loading failed