Browse documentation

DocsShare and export3 min read

Multiplayer rooms

Play your game with a friend in a live room: ask for online multiplayer, publish, send the link, and you are both in the same game.

Ask for online multiplayer

Ask for online multiplayer in your prompt, for example "an online multiplayer game where two players chase each other around the same arena". The agent then builds for two devices instead of two players on one keyboard.

It adds a small room file to the project, .oddshed/multiplayer.json, and connects the game to OddShedNet, the room service OddShed runs. There is no server to set up, and no server address or key ends up in your code.

Share the room

  • Publish the game.
  • Send your friend the game's link.
  • You both open it in a browser and sign in. The game puts you in the same room.

Nothing to install. The first two players to open the game share a room, and the next player to arrive starts a new one.

What a room does

  • Two players share one live game, each on their own device.
  • The room server runs the match. Every move goes to the server, which checks it and sends both players the same state, so you always see the same game.
  • Each player sees who is in the room, and when someone joins or leaves.
  • A player who drops has 15 seconds to reconnect and carry on.
  • A room stays open for up to 30 minutes.

Limits

  • Two players per room.
  • One style of play: a live arena where both players move at the same time.
  • No room codes. The game picks the room for you.
  • Both players need an OddShed account.
  • In the editor, the preview opens a room for you alone. Play with a friend on the published game.
  • Multiplayer is a closed beta. Rooms open only for games and accounts that have been added to it.