Készíts böngészős játékot a Sofalára
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.
A MI-ügynököddel
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.
A ZIP
- Az index.html indítja a játékot. Tedd a ZIP tetejére, vagy a ZIP egyetlen mappájába.
- Minden, amit a játék betölt, a ZIP-ben van, relatív útvonalakkal hivatkozva: Build/game.wasm, soha /Build/game.wasm vagy a saját oldalad teljes címe.
- Legfeljebb 1 GB tömörítve, 10 000 fájl és 2 GB kicsomagolva.
Motorok és fájltípusok
- Minden böngészőben futó játék működik: HTML5 canvas, WebGL és WebGPU (three.js, Babylon.js, PixiJS, Phaser, PlayCanvas), WebAssembly (Emscripten, Rust, Bevy, Go), Godot 3 és 4, GameMaker, Construct, Defold, PICO-8, RPG Maker és LÖVE a love.js-en keresztül.
- Unity WebGL: bármilyen tömörítés működik. A Brotli és gzip fájlok a megfelelő fejlécekkel mennek ki, így nincs szükséged decompression fallbackre.
- A JavaScript-modulok, az import mapek, a .mjs fájlok, a glTF és GLB modellek, a KTX2 textúrák és a WAV, OGG, Opus és MP3 hang mind a megfelelő típussal mennek ki.
Többszálas játékok
- A szálakat használó buildek (SharedArrayBuffer), például a bekapcsolt szálas Godot 4, a -pthread kapcsolós Emscripten és a szálas Unity vagy love.js buildek, eredetek között izolált oldalt igényelnek. A Sofala felismeri őket a ZIP feltöltésekor, és így futtatja. Csak Brotlival tömörített Unity buildnél jelöld be a hirdetésben: „SharedArrayBuffert igényel”.
- Egy izolált játék nem tölthet be szkripteket, képeket vagy hangokat más oldalakról, hacsak azok nem küldenek CORS vagy Cross-Origin-Resource-Policy fejlécet, ezért tegyél mindent a ZIP-be. A szálak nélküli játékok tölthetnek más oldalakról.
A játékon belül
- A localStorage-be vagy IndexedDB-be mentett állások a játékos böngészőjében maradnak, minden játéknál külön.
- A játék használhatja a teljes képernyőt, az egérmutatót, a kontrollereket, a hangot és a WebXR-t. A Sofala oldalán is van teljes képernyős gomb.
- Elkülönített keretben fut, saját címen: nem nyithat felugró ablakot, nem hagyhatja el az oldalt, és nem látja a játékos Sofala-fiókját. Ne kérd a játékosokat, hogy a játékban jelentkezzenek be vagy fizessenek; a Sofala árulja.
- A többjátékos módhoz nem kell saját szerver: a Sofala futtatja a szobákat (lásd lent). Egy játék beszélhet a saját szervereddel is.
Telefonok és táblagépek
- A játék egy elemén figyeld az érintéseket, például a canvasán, ne a window vagy a document objektumon: a kereten belül az iPhone nem mindig adja tovább az érintéseket a window-nak.
- Add meg ennek az elemnek a touch-action: none CSS-t, és hívd meg a preventDefault() függvényt a touchstart és touchmove figyelőiben, amelyeket { passive: false } beállítással adsz hozzá. Különben a telefon a húzást az oldal görgetésének veszi, és néhány képpont után nem szól róla a játékodnak.
- A pointer események (pointerdown, pointermove) telefonon is megérkeznek. Egy játék mindkét fajtát figyelheti, amíg egy ujj egyszer számít.
- A Snake Party mindezt megcsinálja, és a húzásai iPhone-on is működnek; a forráskódja megmutatja, hogyan.
- Ha a játékodat egy játékmotor készítette, az érintéses bevitel a motor dolga. Bármivel készült is, próbáld ki telefonon, mielőtt közzéteszed.
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 });Többjátékos mód
- A Sofala futtatja a szobákat, így a játékodnak nem kell szerver. Tedd a(z) sofala-game-1.1.js fájlt a ZIP-be az index.html mellé, töltsd be a saját szkripted előtt, és egyetlen sor szobába viszi a játékost a többiekkel.
- Amit egy játékos küld, eljut a szoba többi tagjához, a küldés sorrendjében. Egy szobában legfeljebb 32 játékos lehet, és mindegyik másodpercenként 60 üzenetet küldhet, legfeljebb 16 KB méretben: körökre osztott, party- és nyugodt valós idejű játékokhoz pont jó. Egy gyors lövöldözős játéknak továbbra is saját szerver kell.
- A Sofala egyetlen kódodat sem futtatja. A szobában legrégebben lévő játékos a házigazda: hagyd, hogy ő vezesse a játékot, és elmondja a többieknek, mi változott. Ha a házigazda kilép, a következő játékos lesz a házigazda.
- A gyors játék nyilvános szobákat tölt fel. Egy privát szobának kódja van, amivel a barátok csatlakoznak.
- A játék minden játékost egy azonosítóról ismer, ami a játékodban mindig ugyanaz, és a játékosnevéről, soha nem e-mail-címről vagy fiókról. A játékosnév a Sofala-neve, hacsak nem választott másikat a fiókoldalán; a játékod azt is megengedheti, hogy belépéskor beírjon egyet. Aki bejelentkezés nélkül játszik egy ingyenes játékkal, vendég.
- A saját gépeden ugyanígy működik: nyisd meg a játékot a localhost címről, és a szobák a saját tesztterületed lesznek.
- Ha mégis futtatsz szervert, a Sofala.token() aláírt tokent ad neki, ami megmondja, ki a játékos. Ellenőrizd a nyilvános kulcsokkal itt:
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>Mindaz, amire a szobák képesek, a(z) sofala-game-1.1.js elején szerepel. Egy teljes játék mintának, egyetlen fájlban: Snake Party (a forráskódja).
Eladás
- Lehet ingyenes, vagy adj meg áfával együtt legalább 0,50 EUR árat. Az áfa nélküli árat kapod meg, levonva a Sofala 5%-os díját és a Stripe díját, a Stripe-on keresztül: előbb állítsd be a kifizetéseket az Eladások oldalon.
- A hirdetés első borítófotója a játék csempéje a play.sofala.marketen; legjobb egy széles, 16:9-es képernyőkép. További képernyőképeket és előzetes videót a hirdetés szerkesztőoldalán adhatsz hozzá.
- A Sofalánál egy ember kipróbál minden új játékot, mielőtt felkerül; e-mailt kapsz, amikor elérhető.
- Egy már elérhető játék frissítéséhez töltsd fel az új ZIP-et (az ügynököd: upload_files a replace beállítással). Körülbelül egy perc alatt átveszi a régi helyét, új ellenőrzés nélkül és ugyanazon a címen, így a játékosok megtartják a mentéseiket.