Udělejte hru do prohlížeče pro Sofalu
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.
S vaším AI agentem
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.
ZIP
- index.html spouští hru. Dejte ho nahoru do ZIPu, nebo do jeho jediné složky.
- Vše, co hra načítá, je v ZIPu a odkazuje se relativními cestami: Build/game.wasm, nikdy /Build/game.wasm ani plná adresa vašeho webu.
- Až 1 GB zabaleno, 10 000 souborů a 2 GB rozbaleno.
Enginy a typy souborů
- Funguje každá hra, která běží v prohlížeči: HTML5 canvas, WebGL a WebGPU (three.js, Babylon.js, PixiJS, Phaser, PlayCanvas), WebAssembly (Emscripten, Rust, Bevy, Go), Godot 3 a 4, GameMaker, Construct, Defold, PICO-8, RPG Maker a LÖVE přes love.js.
- Unity WebGL: funguje jakákoli komprese. Soubory Brotli a gzip se posílají se správnými hlavičkami, takže decompression fallback nepotřebujete.
- Moduly JavaScriptu, import mapy, soubory .mjs, modely glTF a GLB, textury KTX2 a zvuk WAV, OGG, Opus a MP3 se posílají se správným typem.
Vícevláknové hry
- Sestavení s vlákny (SharedArrayBuffer), třeba Godot 4 se zapnutými vlákny, Emscripten s -pthread a vícevláknová sestavení Unity nebo love.js, potřebují stránku izolovanou od jiných původů. Sofala je pozná, když nahrajete ZIP, a tak je spustí. U sestavení Unity komprimovaného jen Brotli zaškrtněte v inzerátu „Vyžaduje SharedArrayBuffer“.
- Izolovaná hra nemůže načítat skripty, obrázky ani zvuky z jiných webů, pokud ty neposílají hlavičky CORS nebo Cross-Origin-Resource-Policy, takže dejte všechno do ZIPu. Hry bez vláken z jiných webů načítat mohou.
Uvnitř hry
- Uložené pozice v localStorage nebo IndexedDB zůstávají v prohlížeči hráče, pro každou hru zvlášť.
- Hra smí používat celou obrazovku, kurzor myši, gamepady, zvuk a WebXR. Stránka Sofaly má i tlačítko pro celou obrazovku.
- Běží v izolovaném rámu na vlastní adrese: nemůže otevírat vyskakovací okna, opustit stránku ani vidět hráčův účet na Sofale. Nežádejte hráče, aby se ve hře přihlásili nebo platili; hru prodává Sofala.
- Hra pro více hráčů nepotřebuje vlastní server: Sofala provozuje místnosti (níže). Hra může mluvit i s vaším vlastním serverem.
Telefony a tablety
- Poslouchejte dotyky na prvku hry, například na jejím canvasu, ne na window ani document: uvnitř rámu iPhone dotyky na window vždy nepředává.
- Dejte tomu prvku CSS touch-action: none a volejte preventDefault() v jeho posluchačích touchstart a touchmove, přidaných s { passive: false }. Jinak telefon považuje přejetí prstem za posouvání stránky a po pár pixelech přestane hře dávat vědět.
- Události pointer (pointerdown, pointermove) chodí i na telefonech. Hra smí poslouchat oba druhy, pokud se jeden prst počítá jednou.
- Snake Party tohle všechno dělá a jeho přejetí prstem fungují na iPhonu; jeho zdrojový kód ukazuje jak.
- Pokud vaši hru vytvořil engine, dotykový vstup je věc enginu. Ať je vytvořená čímkoli, vyzkoušejte hru na telefonu, než ji zveřejníte.
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 });Hra pro více hráčů
- Sofala provozuje místnosti, takže vaše hra nepotřebuje server. Dejte sofala-game-1.1.js do svého ZIPu vedle index.html, načtěte ho před vlastním skriptem a jeden řádek dá hráče do místnosti s ostatními.
- Co jeden hráč pošle, dorazí ostatním v místnosti v pořadí odeslání. Místnost pojme až 32 hráčů a každý může poslat 60 zpráv za sekundu o velikosti až 16 KB: akorát pro tahové hry, party hry a klidné hry v reálném čase. Rychlá střílečka pořád potřebuje vlastní server.
- Sofala nespouští žádný váš kód. Hráč, který je v místnosti nejdéle, je hostitel: nechte ho řídit hru a říkat ostatním, co se změnilo. Když hostitel odejde, stane se hostitelem další hráč.
- Rychlá hra plní veřejné místnosti. Soukromá místnost má kód, kterým se připojují přátelé.
- Hra zná každého hráče podle id, které je ve vaší hře stále stejné, a podle jména hráče, nikdy podle e-mailové adresy ani účtu. Jméno hráče je jeho jméno na Sofale, pokud si na stránce účtu nevybral jiné; vaše hra mu může dovolit i napsat jméno při připojení. Kdo hraje hru zdarma bez přihlášení, je host.
- Na vlastním počítači to funguje stejně: otevřete hru z localhost a místnosti jsou vaším vlastním testovacím prostorem.
- Pokud přece jen provozujete server, Sofala.token() mu dá podepsaný token, který říká, kdo je hráč. Ověřte ho veřejnými klíči na
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>Vše, co místnosti umí, je popsáno na začátku sofala-game-1.1.js. Celá hra k inspiraci, v jednom souboru: Snake Party (jeho zdrojový kód).
Prodej
- Dejte ji zdarma, nebo nastavte cenu s DPH aspoň 0,50 €. Dostanete cenu bez DPH po odečtení poplatku Sofaly 5 % a poplatku Stripe, přes Stripe: nejdřív si na stránce Prodeje nastavte výplaty.
- První titulní fotka inzerátu je dlaždice hry na play.sofala.market; nejlépe vypadá široký snímek obrazovky v poměru 16:9. Další snímky a ukázkové video přidáte na stránce úprav inzerátu.
- Člověk ze Sofaly si každou novou hru zahraje, než ji zveřejníme; dostanete e-mail, až bude venku.
- Chcete-li aktualizovat zveřejněnou hru, nahrajte nový ZIP (váš agent: upload_files s replace). Zhruba za minutu nahradí starý, bez nové kontroly a na stejné adrese, takže hráči si ponechají uložené hry.