Rumble.Net.Bots 0.1.0-preview.2

Rumble.Net

A Mumble voice chat SDK for .NET, powered by a Rust core.

🇮🇩 Baca dalam Bahasa Indonesia

Rumble.Net rewrites the Mumble client stack in Rust for speed and memory safety, then exposes it to .NET 10 through an idiomatic async/event-based API. Use it to build voice clients, bots, game voice chat, recording tools and moderation dashboards.

await using var client = new RumbleClient(new RumbleClientOptions
{
    Host = "voice.example.org",
    Username = "RumbleBot",
    Audio = { Mode = AudioMode.Devices, TransmitMode = TransmitMode.PushToTalk },
});

client.UserJoined += (_, user) => Console.WriteLine($"{user.Name} joined");
client.ChannelMessageReceived += (_, msg) => Console.WriteLine($"{msg.Sender?.Name}: {msg.PlainText}");

await client.ConnectAsync();
await client.JoinChannelAsync("Games/Minecraft");
client.SendChannelMessage("Hello from Rumble.Net!");

var busiest = client.Channels.MaxBy(c => c.TotalUserCount);   // LINQ over the live server model

Screenshots

RumbleApp is a Mumble voice client built with .NET MAUI Blazor Hybrid. Each user row shows a live amber voice trace, and the transmit strip turns amber while you're on air.

Servers	Settings	Mobile: channels	Mobile: chat

RumbleGallery is an Avalonia gallery of runnable SDK samples. Each one shows its exact source code and live output.

Features

Repository layout

native/                 Rust workspace (the core)
  crates/rumble-protocol  wire protocol, varints, OCB2-AES crypt (no I/O)
  crates/rumble-audio     Opus, jitter buffer, mixer, positional audio, DSP, devices
  crates/rumble-client    tokio/rustls client: session, reconnect, state, events
  crates/rumble-ffi       C ABI → rumble_native.{dll,so,dylib}  (include/rumble.h)
  crates/rumble-mock-server  in-process Mumble server for tests and samples
src/Rumble.Net          .NET 10 SDK
src/Rumble.Net.Bots     bot framework and AI chat
tests/Rumble.Net.Tests  xUnit tests (unit and end-to-end)
benchmarks/             BenchmarkDotNet and latency probe
samples/RumbleApp       .NET MAUI Blazor Hybrid voice client
samples/RumbleGallery   Avalonia gallery of runnable SDK samples
bridges/unity, unreal   game engine integrations
docs/                   full documentation

Getting started

Prerequisites: .NET SDK 10.0.400+ and Rust 1.85+ (rustup). You need the MAUI workload only for RumbleApp.

# Build and test everything (the .NET build compiles the Rust core automatically)
cd native; cargo test --workspace; cd ..
dotnet test --project tests/Rumble.Net.Tests/Rumble.Net.Tests.csproj

# Explore the SDK in the gallery (runs against the built-in mock server)
dotnet run --project samples/RumbleGallery

# Run the voice client (Windows)
dotnet build samples/RumbleApp -f net10.0-windows10.0.19041.0

Try it without a server by starting the embedded one:

using var server = MockMumbleServer.Start();                       // TLS + UDP on a free port
await using var client = new RumbleClient(server.CreateClientOptions("tester"));
await client.ConnectAsync();                                       // EchoBot waits in the Lobby

Measured performance

These results were measured in Release on a Windows x64 developer machine. Reproduce them with dotnet run -c Release --project benchmarks/Rumble.Net.Benchmarks -- native|latency.

See docs/testing-and-benchmarks.md for details.

Documentation

Start at docs/README.md:

• Getting started
• Architecture
• Client API
• Audio
• Bots and plugins
• Security
• Native C API
• Game engines
• Samples
• Testing and benchmarks
• Building and packaging
• Troubleshooting

Project tracking lives in PLAN.md (roadmap) and Progress.md (status).

Status

dotnet add package Rumble.Net --prerelease

The NuGet package includes the native core for Windows, Linux and macOS (x64 and arm64), built and tested by CI. For Android and iOS, build the core with build/build-native.*.

Version 0.1.0 is feature complete for the client protocol and verified end to end against the bundled mock server on Windows x64. Validation against production Murmur servers, the mobile native builds and the game engine bridges is still open. Progress.md tracks these items honestly.

License

MIT. See LICENSE and THIRD-PARTY-NOTICES.md.

Made by Gravicode Studios, led by Kang Fadhil.