Mint-SDK.Server 0.1.0

MiNT Multiplayer C# Server SDK

Mint-SDK.Server provides the .NET 8 API for C# server resources in MiNT Multiplayer. The NuGet package name is Mint-SDK.Server; C# namespaces use Mint.Server, and the SDK assembly is Mint.Server.Sdk.dll.

Building resources requires the .NET 8 SDK. Running them requires a MiNT Windows server with C# support and the x64 .NET 8 Runtime. Client scripts run as separate JavaScript resources.

Create a resource

Create a folder named MyResource containing these three files.

MyResource.csproj

<Project Sdk="Microsoft.NET.Sdk">
  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <AssemblyName>MyResource</AssemblyName>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
    <IsPackable>false</IsPackable>
  </PropertyGroup>
  <ItemGroup>
    <PackageReference Include="Mint-SDK.Server" Version="0.1.0"
                      ExcludeAssets="runtime" />
  </ItemGroup>
</Project>

Keep ExcludeAssets="runtime": the package provides the compile-time API, and the server supplies the SDK assembly at runtime. NuGet restores the package when you build or publish the project.

MyResource.cs

using Mint.Server.Resources;
using MintServer = global::Mint.Server.Server;

namespace Mint.Resources.MyResource;

public sealed class MyResource : Resource
{
    public override void OnStart() =>
        MintServer.Logging.Log("[MyResource] C# server resource started.");

    public override void OnStop() =>
        MintServer.Logging.Log("[MyResource] C# server resource stopped.");
}

resource.toml

type = 'csharp'
main = 'bin/MyResource.dll'

Build and run

Run this command from the resource's project folder:

dotnet publish -c Release -o bin

Place the resource folder in the server's resource directory. It must contain resource.toml and the published files under bin:

resources/
  MyResource/
    resource.toml
    bin/
      MyResource.dll
      ...

Set the server's resourcesPath to this resources directory and start the server. Keep any other published dependencies with the resource. Do not copy Mint.Server.Sdk.dll into the resource; the matching assembly belongs to the server installation.

License

This SDK is licensed under the MIT License. The package includes the license text and third-party notices.