GS - Peer to Peer

GS - Peer to Peer

Uses AI
MIT

A Godot asset that adds functionality for peer-to-peer multiplayer.

Sessions that players host for each other: join codes, a lobby, readiness, deterministic host migration, and a plain account of what NAT will not let you do.

Part of the Gamespice collection: modular, MIT-licensed building blocks for games on the Gamespice platform (only the TMC website back end is closed). It was built with Claude Code and its headless suite passes, but little of it has met real players yet, so expect rough edges and please report what you find.

Install

Copy addons/dot_peer_to_peer/ and dot-core's addons/dot_core/ into your project and enable dot-peer-to-peer in Project > Project Settings > Plugins. dot-core is the only dependency. WebRTC is optional and is reached by name at runtime.

Use

var p2p := DotP2PSession.new()
p2p.config = my_config
p2p.signaller = DotP2PSignallerHttp.new(url, my_id, http)
add_child(p2p)
p2p.setup()

var code = (await p2p.host("Ada")).value   # show this to a friend
await p2p.join("K7M4PX", "Bob")                # or type theirs

A DotP2PSignaller is four calls (verbs). A loopback one ships for tests and split screen, and an HTTP one ships for anything with a URL and four routes. A lobby service or an existing WebSocket is a subclass.

If WebRTC is missing (a desktop build without the GDExtension) the code still parses and runs:

if not DotP2PSession.available():
    push_warning(DotP2PSession.unavailable_reason())

How it works

Part What it does
DotP2PLobby Members, readiness and join slots. It holds no connection, so a headless test covers every race (two people taking one slot, a reused code, two hosts).
Host election lobby.elect_host() is a pure function: stable first, then longest in the session, then lowest id. Every peer computes it from the member list it already has, so no messages are needed when a host disappears.
Join code Six characters from 23456789ABCDEFGHJKLMNPQRSTUVWXYZ (no 0, O, 1, I or l), about a billion codes. Its shape is checked before any lookup.
DotP2PConfig.Trust How far a host is trusted: host-authoritative (co-op among friends), verified (catches a careless host, not a determined one) or sandboxed (no records, statistics or leaderboard leave the session).

Limits you cannot code around

  • Something must introduce the players. Two machines behind two routers need a server both can reach. P2P only removes the server from the game traffic.
  • Some pairs cannot connect without a relay. Roughly 5 to 15 per cent (symmetric or carrier-grade NAT, some corporate and mobile networks). relay_servers is empty by default because a relay costs bandwidth. With none set, those pairs fail quickly with a clear reason.
  • A host is a player and can cheat. Pick the trust level on purpose, and do not feed a leaderboard from a host you do not verify.

Test

godot --headless --path . --import
godot --headless --path . res://examples/p2p_selftest.tscn

Licence

MIT. See LICENSE.

Engagement Over Time

Loading…
Step

GS - Peer to Peer is a Godot asset. It has 1 download, 30 views, and 0 favorites. This item belongs to 1 collection and 4 tags.

Reviews

Log in to leave a review.

Loading…

Comments (0)

Log in to comment.

Loading…

Discover more

See what the community is up to