Publish a game
Every project in the cloud console can be published. Open the project, go to its Game tab, upload what a player downloads, give it a cover, and switch it on: it gets an address of its own and a card on the front page of arrr.fun.
There is nothing else to sign up for. The project you already have — its API key, its tick rate, the people you share it with — is the game.
What you upload
A zip of your build, up to 100 MB, with index.html at the top of it (or one folder down). It is served exactly as it is, from https://<your-address>.play.arrr.fun/.
One thing to know before you ship big media: the play origin does not answer HTTP Range requests yet, so seeking inside a long <audio> or <video> file will not work in Safari, which insists on byte ranges for media. Short sounds decoded with the Web Audio API are fine, and Chrome and Firefox play whole files without ranges.
If the game already lives on your own domain, choose It already lives somewhere instead and give the address. You keep hosting it; the card on the front page points at it.
An address of its own
A published game is served from a hostname that is nobody else's — https://<your-address>.play.arrr.fun/, neither the console's nor another game's. That is what keeps your game's script out of every other game's storage, and every other game's script out of yours, including the session the SDK keeps for a signed-in player.
It also means players sign in to your game without being asked to trust it: publishing adds that address to your project's allowed origins, so identity.login() hands the account straight over instead of stopping to confirm a site ARRR itself put the game on.
You choose the address on the Game tab and you can change it. Changing it moves the game: the old address stops working, so hand out the new one.
The cover
A wide picture, about 16:9, up to 2 MB — PNG, JPEG, GIF or WebP. It is the whole card on the front page: players see the cover and the name, and click straight through to the game. Nothing of ours is drawn over a game once it opens.
The switch
Show it on the front page of arrr.fun is what makes a game public. Turn it off and the game keeps working for anyone who has the address — handy while you are testing with a few people — it just is not listed.
Check it worked
Upload a trivial index.html that prints "hello", switch the game on, and open the address on the Game tab in a new tab. Then load arrr.fun and look for its card. Plays are counted from the moment someone opens it, and the count is on the Game tab.
Next steps
- API Keys — add real-time rooms to the game you just published
- Identity — what signing in inside a published game does
- Player data — saves that follow a player between your games