Fritz.Aspire.Hosting.Minecraft 0.7.0

.NET 10.0 This package targets .NET 10.0. The package is compatible with this framework or higher. 
dotnet add package Fritz.Aspire.Hosting.Minecraft --version 0.7.0
                    


                    

                
NuGet\Install-Package Fritz.Aspire.Hosting.Minecraft -Version 0.7.0
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="Fritz.Aspire.Hosting.Minecraft" Version="0.7.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
<PackageVersion Include="Fritz.Aspire.Hosting.Minecraft" Version="0.7.0" />
                    


                            Directory.Packages.props
                        

                    

                
<PackageReference Include="Fritz.Aspire.Hosting.Minecraft" />
                    


                            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 Fritz.Aspire.Hosting.Minecraft --version 0.7.0
                    


                    

                
#r "nuget: Fritz.Aspire.Hosting.Minecraft, 0.7.0"
#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 Fritz.Aspire.Hosting.Minecraft@0.7.0
#: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=Fritz.Aspire.Hosting.Minecraft&version=0.7.0
                    


                            Install as a Cake Addin
                        

                    

                
#tool nuget:?package=Fritz.Aspire.Hosting.Minecraft&version=0.7.0
                    


                            Install as a Cake Tool

Aspire.Hosting.Minecraft

A .NET Aspire hosting integration that adds Minecraft Paper servers to your Aspire application with first-class dashboard support.

Features

  • Paper server container — runs itzg/minecraft-server with RCON enabled
  • RCON health checks — dependents can WaitFor() the Minecraft server
  • RCON protocol client — full Source RCON implementation with auto-reconnect, response parsing for TPS/MSPT/player data, and structured logging
  • BlueMap web map — optional plugin with HTTP endpoint visible in the Aspire dashboard
  • OpenTelemetry — optional JVM agent that exports metrics, traces, and logs to the Aspire dashboard
  • In-world display — optional worker that renders Aspire resource health as Minecraft structures

Quick Start

var builder = DistributedApplication.CreateBuilder(args);

var minecraft = builder.AddMinecraftServer("minecraft")
    .WithBlueMap()
    .WithOpenTelemetry();

builder.Build().Run();

Configuration

Method Description
AddMinecraftServer(name, gamePort?, rconPort?) Adds a Paper server container
WithBlueMap(port?) Adds the BlueMap web map plugin
WithOpenTelemetry() Configures JVM OpenTelemetry agent
WithAspireWorldDisplay<TWorker>() Enables in-world health visualization
WithMonitoredResource(resource) Registers a resource for in-world display

RCON Client

This package includes a built-in RCON protocol client (Aspire.Hosting.Minecraft.Rcon namespace):

using Aspire.Hosting.Minecraft.Rcon;

var client = new RconClient();
await client.ConnectAsync("localhost", 25575);
await client.AuthenticateAsync("your-rcon-password");

var response = await client.SendCommandAsync("list");

The RconConnection class provides managed connections with auto-reconnect and exponential backoff. The RconResponseParser offers built-in parsers for TPS, MSPT, player lists, and world data.

Package Note

This package includes the OpenTelemetry Java agent JAR (~23 MB) for bind-mounting into the Minecraft container. This is required for the WithOpenTelemetry() feature and contributes to the package size.

License

MIT — see LICENSE for details.

Product Compatible and additional computed target framework versions.
.NET 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last Updated
0.7.0 26 2/27/2026
0.6.0 62 2/26/2026
0.5.0 88 2/16/2026
0.4.0 86 2/12/2026
0.3.1 91 2/12/2026
0.3.0 92 2/11/2026
0.2.2 91 2/10/2026
0.1.0 88 2/10/2026