HakuuLib.MultiplayerLAN 0.1.5

HakuuLib.MultiplayerLAN

A .NET library for LAN discovery and forwarding in multiplayer games.

Supported Games

Features

• 🔍 LAN Discovery - Listen for game server announcements on local network
• 📡 Broadcasting - Advertise game servers to the local network
• 🔀 Forwarding - Forward LAN game traffic across network boundaries
• ⚡ Async/Await - Fully asynchronous API with cancellation support
• 🎯 AOT Compatible - Ready for Native AOT compilation
• 🎮 Multi-Game - Support for Minecraft, L4D2, Civilization VI, and Source Engine games

Installation

dotnet add package HakuuLib.MultiplayerLAN

Quick Start

Using the Factory (Recommended)

using HakuuLib.MultiplayerLAN;

// Minecraft Java
var javaListener = MultiplayerLanFactory.CreateMinecraftJavaDiscoveryListener();

// Minecraft Bedrock
var bedrockListener = MultiplayerLanFactory.CreateMinecraftBedrockDiscoveryListener();

// Left 4 Dead 2
var l4d2Listener = MultiplayerLanFactory.CreateL4D2DiscoveryListener();

// Civilization VI - Discover LAN lobbies
await foreach (var lobby in MultiplayerLanFactory.DiscoverCiv6LobbiesAsync())
{
    Console.WriteLine($"Found Civ6: {lobby.DisplayName}");
}

Minecraft Java Edition

using HakuuLib.MultiplayerLAN.Minecraft.Java.Discovery;
using HakuuLib.MultiplayerLAN.Minecraft.Java.Forwarding;

// Listen for LAN games
var listener = new JavaLanDiscoveryListener();
await listener.StartAsync();

await foreach (var announcement in listener.ListenAsync())
{
    Console.WriteLine($"Found: {announcement.Motd} at port {announcement.Port}");
}

// Forward a remote server to LAN
var forwarder = new JavaLanForwarder(new JavaLanForwarderOptions
{
    RemoteHost = "mc.example.com",
    RemotePort = 25565,
    Motd = "My LAN Server"
});
await forwarder.StartAsync();

Minecraft Bedrock Edition

using HakuuLib.MultiplayerLAN.Minecraft.Bedrock.Discovery;
using HakuuLib.MultiplayerLAN.Minecraft.Bedrock.Forwarding;

var listener = new BedrockLanDiscoveryListener();
await listener.StartAsync();

await foreach (var server in listener.ListenAsync())
{
    Console.WriteLine($"Found: {server.MotdLine1} v{server.VersionName} [{server.PlayerCount}/{server.MaxPlayerCount}]");
}

// Forward a remote Bedrock server to LAN
var forwarder = new BedrockLanForwarder(new BedrockLanForwarderOptions
{
    RemoteHost = "bedrock.example.com",
    RemotePort = 19132,
    MotdLine1 = "My LAN Server"
});
await forwarder.StartAsync();

Left 4 Dead 2 / Source Engine Games

using HakuuLib.MultiplayerLAN.SourceEngine.Discovery;
using HakuuLib.MultiplayerLAN.SourceEngine.LeftForDead2;

// Query a specific server
var info = await SourceServerQuery.QueryInfoAsync("192.168.1.100", 27015);
if (info != null)
{
    Console.WriteLine($"Server: {info.Name} - Map: {info.Map} - Players: {info.Players}/{info.MaxPlayers}");
}

// Listen for L4D2 LAN servers
var listener = new L4D2LanDiscoveryListener();
await listener.StartAsync();

await foreach (var server in listener.ListenAsync())
{
    Console.WriteLine($"Found: {server.Name} - Map: {server.Map} - Mode: {server.GameMode}");
}

// Discover all L4D2 servers on LAN
await foreach (var server in L4D2ServerQuery.DiscoverLanServersAsync())
{
    Console.WriteLine($"Discovered: {server.Name} at {server.Address}");
}

Civilization VI

using HakuuLib.MultiplayerLAN.Civilization6.Discovery;
using HakuuLib.MultiplayerLAN.Civilization6.Forwarding;

// Discover Civ6 LAN lobbies
await foreach (var lobby in Civ6LanDiscovery.DiscoverLobbiesAsync())
{
    Console.WriteLine($"Found: {lobby.DisplayName}");
    Console.WriteLine($"  Host: {lobby.HostName}");
    Console.WriteLine($"  Map: {lobby.MapName} ({lobby.MapSize})");
    Console.WriteLine($"  Players: {lobby.CurrentPlayers}/{lobby.MaxPlayers}");
}

// Query a specific host
var lobbyInfo = await Civ6LanDiscovery.QueryHostAsync("192.168.1.100");
if (lobbyInfo != null)
{
    Console.WriteLine($"Game: {lobbyInfo.GameName} - Turn: {lobbyInfo.GameTurn}");
}

// Using options to customize discovery
var options = new Civ6LanDiscoveryOptions
{
    Timeout = 5000,
    ScanAllPorts = true // Scan all 100 ports (62900-62999)
};
var lobbies = await Civ6LanDiscovery.DiscoverLobbiesListAsync(options);