KravasNet

A lightweight abstraction layer over ByteNet for Roblox, built to simplify networking inside Kravas.

Group related packets into Namespaces, define Channels with a clean chainable API, and get built-in middleware and reliability controls — without writing raw ByteNet.definePacket boilerplate everywhere.

📖 Full documentation: kravasnet-docs.vercel.app

---

Installation

Add KravasNet to your wally.toml:

[dependencies]
KravasNet = "brunnogames3776/kravasnet@0.5.0"

Then run:

wally install

Quick Example

local ReplicatedStorage = game:GetService("ReplicatedStorage")
local KravasNet = require(ReplicatedStorage.Packages.KravasNet)

local CombatNet = KravasNet.createNamespace("Combat")
	:add("Damage",   { amount = KravasNet.float32, target = KravasNet.inst })
	:add("Position", { pos = KravasNet.vec3 }, { reliability = "unreliable" })

CombatNet:build() -- registers everything with ByteNet right now

-- Server
CombatNet.Damage:sendTo(player, { amount = 50, target = someCharacter })

-- Client
CombatNet.Position:on(function(data)
	print(data.pos)
end)

For the full Quick Start guide, API reference, middleware/reliability details, supported data types, and best practices, see the documentation.

Features

• Namespaces & Channels — organize related packets under one named container instead of scattering definePacket calls across scripts.
• Unified Channel API — sendTo, sendToAll, sendToAllExcept, send, on — context-aware for server and client automatically.
• Middleware pipeline — validate, sanitize, or reject incoming packets before your handler runs.
• Reliability options — reliable / unreliable per channel.
• Direct ByteNet access — drop down to KravasNet.ByteNet whenever you need something the abstraction doesn't cover.

Requirements

• ByteNet 0.4.x (installed automatically as a dependency via Wally)
• Roblox Luau

License

MIT