PicoMP vNext
Room state, five calls.
PicoMP vNext is a small backend contract for room lifecycle, player sessions, shared state patches, and room-scoped state subscriptions.
SDK Surface
createRoom(options?)joinRoom(code, player?)leaveRoom()setState(patch)onState(callback)onState(path, callback) HTTP
| SDK | Method | Path | Auth |
|---|---|---|---|
| createRoom | POST | /vnext/rooms | Authorization: Bearer <projectApiKey> |
| joinRoom | POST | /vnext/rooms/:code/join | Authorization: Bearer <projectApiKey> |
| leaveRoom | POST | /vnext/rooms/current/leave | Authorization: Bearer <sessionToken> |
| setState | PATCH | /vnext/rooms/current/state | Authorization: Bearer <sessionToken> |
WebSocket
GET /vnext/rooms/current/connect
first client frame:
{
"type": "auth",
"sessionToken": "<sessionToken>"
} Limits
defaultMaxPlayers8
defaultRoomTTLSeconds7200
emptyRoomTTLSeconds300
disconnectGraceSeconds60
maxStateSizeBytes65536
maxPatchSizeBytes16384
maxWritesPerRoomPerSecond5
State Rules
Objects deep merge. Arrays and primitives replace existing values.
Top-level keys beginning with _ are reserved by PicoMP.
Each accepted write increments the room state version.
Path subscriptions are SDK-local and filtered with changedPaths.