SuperSocketLite2 0.22.0

SuperSocketLite2

Async TCP/UDP socket server library for .NET 10 (Windows/Linux), built for the kind of workload that doesn't forgive sloppy I/O: real-time multiplayer game servers. A session-based, event-driven framework on top of SocketAsyncEventArgs (IOCP) and System.IO.Pipelines, so you can focus on your game protocol instead of reinventing connection management, buffer pooling, and backpressure handling.

This is a separate, from-scratch NuGet package — a different package ID from the older SuperSocketLite package (still the pre-rewrite, .NET 9 line). Installing this one does not affect existing SuperSocketLite users.

Install

dotnet add package SuperSocketLite2

A minimal echo server

public sealed class MyRequestInfo : IRequestInfo
{
    public string Key => string.Empty;
    public ReadOnlySequence<byte> Body { get; private set; }
    public void Set(ReadOnlySequence<byte> body) => Body = body;
}

public sealed class MyReceiveFilter : FixedHeaderReceiveFilter<MyRequestInfo>
{
    private readonly MyRequestInfo _reusable = new();
    public MyReceiveFilter() : base(4) { }

    protected override int GetBodyLengthFromHeader(ReadOnlySequence<byte> header)
    {
        Span<byte> buffer = stackalloc byte[4];
        header.CopyTo(buffer);
        return BinaryPrimitives.ReadInt32LittleEndian(buffer);
    }

    protected override MyRequestInfo ResolveRequestInfo(ReadOnlySequence<byte> header, ReadOnlySequence<byte> body)
    {
        _reusable.Set(body);
        return _reusable;
    }
}

public sealed class MySession : AppSession<MySession, MyRequestInfo> { }

public sealed class MyServer : AppServer<MySession, MyRequestInfo>
{
    public MyServer() : base(new DefaultReceiveFilterFactory<MyReceiveFilter, MyRequestInfo>()) { }
}

var server = new MyServer();
server.NewRequestReceived += (session, request) =>
{
    if (request.Body.IsSingleSegment)
        session.SendCopied(request.Body.FirstSpan);
    else
        session.SendCopied(request.Body.ToArray());
};

server.Setup(new RootConfig(), new ServerConfig { Ip = "Any", Port = 2012, MaxConnectionNumber = 1000 },
    logFactory: new ConsoleLogFactory());
server.Start();

Documentation

• README (full guide, quick start, configuration, observability)
• Getting Started — build, usage, must-knows
• Architecture guide and diagrams
• Tutorials / example servers

License

MIT