How does the join code work, and the share link?

Updated on

The host's game makes a code of six characters for one match, and anyone who types it on the Join tab lands in that match; the share link carries the same code inside a web address, so a friend who opens it finds the code already filled in. Boomer Brawl works this way in the browser, with no account and no friends list, for up to four people and bots.

What the code is

The code is a string of six characters, letters and digits mixed, which the game requests from Unity's online services when someone hosts. The lobby displays it large on the screen so everyone can see it.

Unity documentation, Find and join a session, says such a code is made when a host starts a session. It mixes letters and numbers, and is meant to be short and easy to type or to spell out loud.

The code has no vowels, no zero and no one, so nobody mistakes an O for a zero or an I for a one when it is read out on a call. It belongs to the match, not to the host: whoever has it can join, and the next match the host opens gets a new code.

Hosting and sharing the code

To host and share the code, the host opens the game, presses Play, then the Host tab, picks the map, the bots and the round's length, and presses Host. The lobby opens with the code at the top and a Share code button under it.

The Share code button sends one message with an invitation to join the game, including the code, and on its own line the link, boomerbrawl.com/play/?join= followed by the code. Where the browser can share, the button opens the device's own share sheet.

MDN Web Docs, Navigator: share() method, says the browser's share function hands the text to the device's native sharing, whose targets depend on the device and can include the clipboard, contacts and email apps, and that it is not available in some widely used browsers. Where the browser cannot share, the button copies the message instead, ready to paste. A short note says Shared, Copied or Could not share.

The message goes wherever the group talks: a group chat, a text, the chat of the video call you are on. On a call, reading the code out works too.

What the share link does

The share link takes a friend straight into the match by attaching the code to the game's web address. The link is the game's own address with the code on the end. Opening it loads the game and goes straight to the Join tab with the code filled in.

The friend sees the name and the character they will play as, and presses Join. There is nothing to type.

On a phone this is the quickest way in, since nobody has to switch between the chat and the game to copy characters. The link works for as long as the code does: while the host's match is open.

Typing a code by hand

Typing a code by hand is done on the Join tab through an on-screen keypad. Press Play, then the Join tab. Under "Have a code?", a press on the field opens a set of keys.

The keys hold only the characters a code can have, so a character that cannot be in a code cannot be typed. Press Join once the code is in. The friend waits in the lobby with the others until the host presses Start.

The Join tab also lists open public games. On the Host tab, the Public switch decides it: on, the game also shows in that list, where strangers can pick it; off, only people with the code get in. Unity documentation, Find and join a session, says such a list shows the public sessions a player can join that are not full.

When a code does not work

A code does not work if the match cannot be found, has reached capacity or is running on another version. No game has that code: a character is wrong, or the host has closed the match or opened a new one.

The match is full: it already holds four people, the most a match takes. Another version: the friend's game and the host's differ, and reloading the game's page fetches the newest.

The host left: the host's game runs the match for everyone. When the host closes it, the match ends and the code finds nothing.

How Boomer Brawl does it

Boomer Brawl handles multiplayer connections directly in the browser without downloads or sign-ups. Boomer Brawl is a free top-down arena brawler in the browser with nothing to install, and its code and link need no account, no email and no friends list.

Up to three friends join the host, and bots take the seats nobody fills: up to eight bots, twelve seats in all. A friend who arrives late joins the match already running, and a bot takes over the seat of anyone who leaves.

A guide to play with friends goes through an evening step by step, how join codes work explains codes in any game, and playing on a video call has the call that goes with it. Boomer Brawl is free in the browser with nothing to install: host a match.

Common questions

Do my friends need an account to join?

No. The code finds the match, and each player only picks a name and a character.

How long does the code last?

The code lasts as long as the host's match stays open. A new match gets a new code.

Does the share link work on a phone?

Yes. It opens the game in the phone's browser on the Join tab with the code filled in, and the friend presses Join.

Can a stranger join with our code?

Yes, if they have it. Share the code only where your friends see it, and leave Public off.

Can a friend join after the round has started?

Yes. A friend who joins late drops into the match already running.

Sources

Keep reading