evoid-transport 0.1.2

Low-latency UDP transport for EVOID — replaces WebSocket with ENet-level performance

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

Channel	Use Case	Reliability	Ordering
0	Card plays, game actions	Reliable	Ordered
1	Position, animations	Unreliable	Unordered
2	Chat messages	Reliable	Unordered

---

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

Method	Signature	Description
start	async start(game_id)	Start UDP server
stop	async stop()	Stop UDP server
broadcast_state_sync	async broadcast_state_sync(state, tick)	Broadcast game state
send_intent_to_client	async send_intent_to_client(addr, name, data)	Send to specific client

---

DI Integration

All plugins register with evoid-di for automatic service discovery and fault tolerance.

from evoid_di import di

# Resolve with fallback
storage = di.resolve_with_fallback("storage.postgresql")
# Tries: postgresql → sqlite → redis → cluster peers → None

Dependencies

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

Links

• EVOID Runtime
• Documentation
• Plugin Collection

License

MIT