Een browserspel maken voor Sofala
Players start your game right on play.sofala.market, with nothing to install: free games at once, paid ones after one payment. The easy way is to let an AI agent build and upload it; doing it by hand comes after.
Met je AI-agent
You do not need to know how to program. A coding agent writes the game with you, uploads it to Sofala, writes the listing and publishes it when you say it’s done. Any agent that works with MCP servers can do this; these steps use Claude Code on Windows, and we recommend it with the model Opus 5.5 or newer.
- Get a Claude accountGo to claude.ai, create an account and choose a paid plan (Pro or higher). Claude Code is not part of the free plan.
- Open PowerShellPowerShell is a window where you type commands. Press the Windows key, type
powershelland press Enter. A window opens with a line that starts withPS C:\Users\and your name. That is where the next lines go. - Install Claude CodeCopy this line, paste it into PowerShell (right-click pastes) and press Enter. Nothing seems to happen while it downloads; wait until it says it is done.
irm https://claude.ai/install.ps1 | iex
Now close PowerShell and open it again. This matters: the window you installed from does not know the new program yet. - Check that it worksIn the new PowerShell window, this prints a version number:
claude --version
Does it say thatclaudeis not recognized? Then Windows has not been told where Claude Code is. Paste these two lines, one after the other, close PowerShell, open it again and try once more:$currentPath = [Environment]::GetEnvironmentVariable('PATH', 'User') [Environment]::SetEnvironmentVariable('PATH', "$currentPath;$env:USERPROFILE\.local\bin", 'User')Still stuck? Claude Code’s page for installation problems lists the other causes. - Add Sofala, before you start Claude CodeThis tells Claude Code where Sofala is, so it can upload and publish for you. Paste it and press Enter:
claude mcp add --transport http Sofala https://sofala.market/mcp
- Start Claude CodeType this and press Enter:
claude
The first time, your browser opens and asks you to sign in with your Claude account. Do that and come back to the PowerShell window.
Does it stop to ask permission too often? Start it with this line instead, with no checks at all. It then does everything without asking, also when it gets something wrong, so use it only if you accept that; Anthropic advises it only on a computer with nothing on it that you would miss.claude --dangerously-skip-permissions
- Connect it to your Sofala accountInside Claude Code, type the line below and press Enter, pick Sofala and choose to sign in. Your browser opens sofala.market: type your email address, then the code Sofala emails you. That also makes your Sofala account if you have none; it is free and has no password. Then press Allow. Back in Claude Code, Sofala now shows as connected.
/mcp
- Pick the modelType the line below, press Enter and choose Opus 5.5 or newer. A game is a lot of code, and smaller models make more mistakes.
/model
- Ask for your gameNow say what you want, in your own words and in any language. For example:
Make a simple online multiplayer snake game that runs in the browser, for Sofala. Use Sofala’s multiplayer rooms so friends can join. Let me test it, and when I say it’s done, put it on Sofala as a free game.
- When the game is ready to try, your agent gives you a link to play it on Sofala before anyone else can see it. Say what to change, as often as you like: “make the snakes faster”, “add a score board”.
- Happy with it? Say “publish it”. A person at Sofala plays each new game before it goes up; you get an email when it is live.
- To change a live game later, open PowerShell, start Claude Code again and ask. The new build replaces the old one at the same address.
- On a Mac or on Linux, open Terminal instead of PowerShell and install with the line on Claude Code’s setup page; the other steps are the same. Using another agent? Add a remote MCP server with the address
https://sofala.market/mcp.
For manual game devs
Building or packaging the game yourself? This is what Sofala expects. An AI agent follows the same rules; it reads them from Sofala.
De ZIP
- index.html start het spel. Zet het bovenaan in de ZIP, of in de enige map van de ZIP.
- Alles wat het spel laadt zit in de ZIP, gelinkt met relatieve paden: Build/game.wasm, nooit /Build/game.wasm of een volledig adres van je eigen site.
- Tot 1 GB ingepakt, 10 000 bestanden en 2 GB uitgepakt.
Engines en bestandstypen
- Elk spel dat in een browser draait werkt: HTML5 canvas, WebGL en WebGPU (three.js, Babylon.js, PixiJS, Phaser, PlayCanvas), WebAssembly (Emscripten, Rust, Bevy, Go), Godot 3 en 4, GameMaker, Construct, Defold, PICO-8, RPG Maker en LÖVE via love.js.
- Unity WebGL: elke compressie werkt. Brotli- en gzip-bestanden worden met de juiste headers verstuurd, dus je hebt de decompression fallback niet nodig.
- JavaScript-modules, import maps, .mjs-bestanden, glTF- en GLB-modellen, KTX2-texturen en WAV-, OGG-, Opus- en MP3-geluid worden allemaal met het juiste type verstuurd.
Spellen met meerdere threads
- Builds met threads (SharedArrayBuffer), zoals Godot 4 met threads aan, Emscripten met -pthread en Unity- of love.js-builds met threads, hebben een cross-origin geïsoleerde pagina nodig. Sofala herkent ze bij het uploaden van de ZIP en draait ze zo. Vink bij een Unity-build die alleen met Brotli is gecomprimeerd „Heeft SharedArrayBuffer nodig” aan in de advertentie.
- Een geïsoleerd spel kan geen scripts, afbeeldingen of geluiden van andere sites laden, tenzij die CORS- of Cross-Origin-Resource-Policy-headers sturen; zet dus alles in de ZIP. Spellen zonder threads mogen van andere sites laden.
In het spel
- Opgeslagen spellen in localStorage of IndexedDB blijven in de browser van de speler, apart per spel.
- Het spel mag volledig scherm, de muisaanwijzer, gamepads, geluid en WebXR gebruiken. De pagina van Sofala heeft ook een knop voor volledig scherm.
- Het draait in een afgeschermd frame op een eigen adres: het kan geen pop-ups openen, de pagina niet verlaten en het Sofala-account van de speler niet zien. Laat spelers in het spel niet inloggen of betalen; Sofala verkoopt het.
- Voor multiplayer heb je geen eigen server nodig: Sofala draait de kamers (hieronder). Een game mag ook met een eigen server praten.
Telefoons en tablets
- Luister naar aanrakingen op een element van je game, zoals het canvas, niet op window of document: binnen het frame geeft een iPhone aanrakingen niet altijd door aan window.
- Geef dat element de CSS touch-action: none, en roep preventDefault() aan in de touchstart- en touchmove-listeners, toegevoegd met { passive: false }. Anders denkt de telefoon bij een veeg dat de pagina moet scrollen en vertelt hij het je game na een paar pixels niet meer.
- Pointer-events (pointerdown, pointermove) komen ook op telefoons aan. Een game mag naar beide luisteren, zolang één vinger maar één keer telt.
- Snake Party doet dit allemaal, en het vegen werkt op een iPhone; de broncode laat zien hoe.
- Als een engine je game heeft gemaakt, is de touchinvoer de zaak van de engine. Hoe hij ook gemaakt is: probeer de game op een telefoon voordat je hem publiceert.
const area = document.querySelector('canvas'); // an element of the game, not window
area.style.touchAction = 'none';
let from = null;
area.addEventListener('touchstart', e => {
e.preventDefault();
from = [e.touches[0].clientX, e.touches[0].clientY];
}, { passive: false });
area.addEventListener('touchmove', e => {
e.preventDefault();
if (!from) return;
const x = e.touches[0].clientX, y = e.touches[0].clientY, dx = x - from[0], dy = y - from[1];
if (Math.abs(dx) < 20 && Math.abs(dy) < 20) return;
from = [x, y];
swipe(Math.abs(dx) > Math.abs(dy) ? (dx > 0 ? 'right' : 'left') : (dy > 0 ? 'down' : 'up'));
}, { passive: false });Multiplayer
- Sofala draait de kamers, dus je game heeft geen server nodig. Zet sofala-game-1.1.js in je ZIP naast index.html, laad hem vóór je eigen script, en één regel zet de speler in een kamer met anderen.
- Wat een speler stuurt, bereikt de anderen in de kamer, in de volgorde waarin het is verstuurd. Een kamer heeft plek voor maximaal 32 spelers, en elk kan 60 berichten per seconde van maximaal 16 KB sturen: goed voor beurtspellen, partygames en rustige realtime games. Een snelle shooter heeft nog steeds een eigen server nodig.
- Sofala draait geen code van jou. De speler die het langst in de kamer is, is de host: laat die het spel leiden en de anderen vertellen wat er veranderd is. Als de host weggaat, wordt de volgende speler host.
- Snel spelen vult openbare kamers. Een privékamer heeft een code waarmee vrienden meedoen.
- De game kent elke speler aan een id die in je game hetzelfde blijft en aan de spelersnaam, nooit aan een e-mailadres of een account. De spelersnaam is de Sofala-naam, tenzij de speler op de accountpagina een andere koos; je game kan ook iemand er een laten typen bij het meedoen. Wie een gratis game speelt zonder in te loggen, is gast.
- Op je eigen computer werkt het net zo: open de game via localhost en de kamers zijn een eigen testruimte.
- Draai je toch een server, dan geeft Sofala.token() hem een ondertekend token dat zegt wie de speler is. Controleer het met de publieke sleutels op
https://sofala.market/game-api/keys.
<script src="sofala-game-1.1.js"></script>
<script type="module">
const room = await Sofala.rooms.quick({ max: 4 }); // a room with other players, or a new one
room.on('message', (data, from) => { /* from.name did something */ });
room.on('enter', peer => { });
room.on('exit', peer => { });
room.send({ move: 'e2e4' }); // to everyone else in the room
</script>Alles wat de kamers kunnen, staat bovenaan in sofala-game-1.1.js. Een hele game om van te leren, in één bestand: Snake Party (de broncode).
Verkopen
- Maak het gratis, of geef het een prijs inclusief btw van minstens € 0,50. Je krijgt de prijs zonder btw, min Sofala’s commissie van 5% en de kosten van Stripe, via Stripe: stel eerst uitbetalingen in op je Verkoop-pagina.
- De eerste omslagfoto van de advertentie is de tegel van het spel op play.sofala.market; een brede screenshot in 16:9 werkt het best. Voeg meer screenshots en een preview-video toe op de bewerkpagina van de advertentie.
- Een mens bij Sofala speelt elke nieuwe game voordat hij online gaat; je krijgt een e-mail als hij live is.
- Om een game bij te werken die al live is, upload je de nieuwe ZIP (je agent: upload_files met replace). Hij neemt binnen ongeveer een minuut de plaats van de oude in, zonder nieuwe controle en op hetzelfde adres, zodat spelers hun opgeslagen spellen houden.