Painless peer-to-peer WebRTC networking for rust wasm applications.
The goal of the Matchbox project is to enable udp-like, unordered, unreliable p2p connections in web browsers to facilitate low-latency multiplayer games.
It is currently an all-in-one solution, it comes with:
bevy and bevy_ggrs:
matchbox_demoggrs-socket for providing a
ggrs compatible socket.Open each link in a separate browser window (or machine).
When enough players have joined, you should see a couple of boxes, one of which
you can move around using the WASD keys.
You can open the browser console to get some rough idea about what's happening (or not happening if that's the unfortunate case).
WebRTC allows direct connections between peers, but in order to establish
those connections, some kind of signalling service is needed.
matchbox_server is such a service. Once the connections are established,
however, data will flow directly between peers, and no traffic will go through
the signalling server.
The signalling service needs to run somewhere all clients can reach it over http or https connections. In production, this usually means the public internet.
When a client wants to join a p2p (mesh) network, it connects to the signalling
service and provides a room id. The signalling server then notifies the peers
that have already connected about the new peer (sends a new_peer event).
The existing peers then send back WebRTC connection offers through the signalling service to the new client, each of which the new client responds with an "answer". Once the peers have enough information about each other, a WebRTCPeerConnection is established for each peer, and an unreliable, unordered data channel is opened.
All of this, however, is hidden from rust application code. All you will need to do on the client side, is:
.await the message loop future that processes new messages. If you are
using Bevy, it can be spawned as a Bevy io task (see
matchbox_demo).
See
matchbox_simple_demo
for usage with
wasm-bindgen-futures. Alternatively, the future can be polled manually (at
least once per frame).You will then get notified whenever a new peer data connection has been
established, and you will get all packets from peers in a single channel.
Packets include a boxed u8 slice and the corresponding client's id.
Similarly, you can send packets to clients using a simple non-blocking method.
matchbox_server supports a rudimentary form of matchmaking. By appending
?next=3 to the room id, the next three players to join will be connected, and
then the next three players will be connected separately to the first three.
You can also use the room id for scoping what kind of players you want to
match. i.e.: wss://match.example.com/awesome_game_v1.1.0_pvp?next=2
Projects using Matchbox:
matchbox_socket is
heavily inspired its wasm-bindgen server_socket and Matchbox would probably not
exist without it.All code in this repository dual-licensed under either:
Unless you explicitly state otherwise, any contribution intentionally submitted for inclusion in the work by you, as defined in the Apache-2.0 license, shall be dual licensed as above, without any additional terms or conditions.