Godot multiplayer

Two ways to use it from Godot

• Web exports: call the JavaScript SDK through JavaScriptBridge and get WebRTC peer-to-peer with relay fallback for free.
• Native exports: talk to the API over HTTP with HTTPRequest. Three routes are enough to play; the OpenAPI 3.1 schema documents the rest. Traffic uses the server relay in /v1/rt/sync, whose cadence the server tells you in tick_ms.

A complete Godot integration

extends Node

const API := "https://multiplayerapi.com/v1"
const KEY := "mp_pk_..."
var token := ""
var room_code := ""
var since := 0
var tick_ms := 1000

func _ready() -> void:
    var guest = await post("/auth/guest", {"display_name": "Player"})
    token = guest.session.access_token
    var qm = await post("/rooms/quickmatch", {"mode": "ffa", "max_players": 8})
    room_code = qm.room.code
    tick_ms = qm.tick_ms
    loop()

func loop() -> void:
    while room_code != "":
        var r = await post("/rt/sync", {
            "room": room_code, "since": since, "transport": "relay",
            "relay": [{"data": Marshalls.utf8_to_base64(JSON.stringify({"x": $Player.position.x, "y": $Player.position.y}))}],
        })
        since = r.seq
        tick_ms = r.tick_ms                      # always respect the server cadence
        for p in r.relay:
            var pos = JSON.parse_string(Marshalls.base64_to_utf8(p.data))
            update_remote(p.from, pos)
        await get_tree().create_timer(tick_ms / 1000.0).timeout

func post(path: String, body: Dictionary) -> Dictionary:
    var http := HTTPRequest.new()
    add_child(http)
    var headers := ["Content-Type: application/json", "X-Mp-Key: " + KEY]
    if token != "":
        headers.append("Authorization: Bearer " + token)
    http.request(API + path, headers, HTTPClient.METHOD_POST, JSON.stringify(body))
    var res = await http.request_completed
    http.queue_free()
    return JSON.parse_string(res[3].get_string_from_utf8())

What goes where

• Write health and score with ops in the same sync call: {"op":"set","path":"players.$me.hp","value":80}.
• Batch profile, stats and leaderboard reads with POST /v1/batch (up to 20 calls).

Keep reading