🌾 godot-genosdb — Serverless P2P multiplayer for Godot (Web)

Add real-time, peer-to-peer multiplayer to a Godot game exported to the Web with zero servers, using GenosDB (WebRTC data channels + a reactive, persistent graph database that runs entirely in the browser). The plugin's API mirrors GenosDB, so using it teaches you the real GenosDB API.

▶ Live demo: https://estebanrfp.github.io/godot-genosdb/ — open it in two tabs: each shows the other farmer moving, and a tree you chop falls in every window (and stays fallen, even for someone who joins later).

📦 What's in this repo

📥 Install the plugin in YOUR game (3 steps)

1. Copy the folder addons/godot_genosdb/ into your own project's addons/ folder (create addons/ if it doesn't exist).
2. In Godot: Project → Project Settings → Plugins, find “GenosDB for Godot” and switch it to Enabled.
3. Export to Web (Project → Export → Web; renderer GL Compatibility recommended). The plugin auto-injects the GenosDB bridge into your exported index.html — you don't edit any HTML.

No npm, no bundling: the bridge loads GenosDB from a CDN. No signaling server: GenosDB uses decentralized Nostr relays.

Use it in code (the API mirrors GenosDB)

func _ready():
    Net.peer_join.connect(func(id): spawn_remote(id))
    Net.peer_leave.connect(func(id): remove_remote(id))
    Net.message.connect(_on_state)        # ephemeral (fast)
    Net.graph_changed.connect(_on_world)  # persistent (synced + stored)
    Net.join("my-room")                    # = gdb("my-room", {rtc:true})
    Net.map({})                            # = db.map({}, cb)  -> graph_changed

func _physics_process(_d):
    Net.send({ "x": position.x, "y": position.y })          # = channel.send(...)

func chop_tree():
    Net.put({ "type": "tree", "hp": 0 }, "tree_3")          # = db.put(node, id)

Full API: addons/godot_genosdb/README.md.

▶ Run the demo

Editor (single-player): open the project in Godot 4.6+ and press ▶. Move with WASD/arrows, chop trees with E / Space. (P2P is Web-only, so in the editor it runs as a normal single-player game.)

Web (multiplayer), locally:

GODOT=/path/to/Godot ./web/build.sh        # exports into docs/
python3 docs/serve.py 8088                 # open http://127.0.0.1:8088 in two tabs

Or just open the live demo above.

🧠 How it works (the hybrid model)

GenosDB isn't only WebRTC — it's a reactive graph database that syncs P2P and persists. So the demo uses both layers, the recommended GenosDB pattern:

• Ephemeral — player positions over a GenosRTC data channel (Net.send).
• Persistent — tree state in the GenosDB graph (Net.put / Net.map); a late-joiner gets the current world automatically (via the initial action) and chops survive reloads.

🛠 Tech

• Godot 4.6 — GL Compatibility, Web export, no threads → any static host.
• GenosDB / GenosRTC — loaded from CDN; auto-injected on export.

Author

Esteban Fuster Pozzi (@estebanrfp) — Full Stack JavaScript Developer

License

MIT