evoid-transport

Low-latency UDP transport — Intent Handler system

Quick Start • Intent Handler • Channels • API

Quick Start

uv add evoid-transport

Method 1: Intent Handler (Recommended)

from evoid_transport import register_handlers

# Register UDP transport as Intent handlers
register_handlers(host="0.0.0.0", port=9000)

Method 2: Direct API

from evoid_transport import EvoidUDPPort

transport = EvoidUDPPort(host="0.0.0.0", port=9000)
await transport.start(game_id="my_game")

Intent Handler

evoid-transport registers UDP packet handling as Intent handlers.

Performance

WebSocket (TCP):  ~2-5ms overhead
evoid-transport:  ~0.5-1ms overhead
ENet:             ~0.3-0.5ms overhead

Channels

Configuration

TOML

[engines]
transport = "transport"

[engines.options.transport]
host = "0.0.0.0"
port = 9000

API

register_handlers(host, port)

Register UDP transport as Intent handlers.

EvoidUDPPort Methods

How It Works

UDP transport maps IOP levels to channels:

• Channel 0 (Reliable) — card plays, purchases (CRITICAL/STANDARD)
• Channel 1 (Unreliable) — position updates, animations (EPHEMERAL)
• Channel 2 (Chat) — chat messages (STANDARD)

The transport doesn't know your game logic. Your Intent's level determines the channel.

Dependencies

• evoid>=0.4.0
• Optional: evoid-godot>=1.0.0 (for Godot integration)

Build Requirements

This plugin has a Rust core (PyO3 + maturin). Pre-built wheels are available on PyPI for Linux/macOS/Windows. If building from source:

• Rust toolchain (rustup)
• Python development headers (python3-dev)
• maturin (pip install maturin)

Links

• EVOID Runtime
• Documentation
• Plugin Collection

License

MIT