Buat game browser untuk 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.
Dengan agen AI Anda
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 menjalankan game. Taruh di bagian atas ZIP, atau di dalam satu-satunya folder ZIP.
- Semua yang dimuat game ada di dalam ZIP, ditautkan dengan path relatif: Build/game.wasm, jangan /Build/game.wasm atau alamat lengkap situs Anda sendiri.
- Hingga 1 GB terkompresi, 10 000 file, dan 2 GB setelah diekstrak.
Engine dan jenis file
- Semua game yang berjalan di browser bisa: HTML5 canvas, WebGL dan WebGPU (three.js, Babylon.js, PixiJS, Phaser, PlayCanvas), WebAssembly (Emscripten, Rust, Bevy, Go), Godot 3 dan 4, GameMaker, Construct, Defold, PICO-8, RPG Maker, dan LÖVE melalui love.js.
- Unity WebGL: kompresi apa pun bisa. File Brotli dan gzip dikirim dengan header yang benar, jadi Anda tidak perlu decompression fallback.
- Modul JavaScript, import map, file .mjs, model glTF dan GLB, tekstur KTX2, serta suara WAV, OGG, Opus, dan MP3 semuanya dikirim dengan jenis yang benar.
Game multithread
- Build yang memakai thread (SharedArrayBuffer), seperti Godot 4 dengan thread aktif, Emscripten dengan -pthread, dan build Unity atau love.js multithread, memerlukan halaman yang terisolasi lintas origin. Sofala mengenalinya saat Anda mengunggah ZIP dan menjalankannya dengan cara itu. Untuk build Unity yang hanya dikompresi Brotli, centang “Memerlukan SharedArrayBuffer” di iklan.
- Game yang terisolasi tidak bisa memuat skrip, gambar, atau suara dari situs lain kecuali situs itu mengirim header CORS atau Cross-Origin-Resource-Policy, jadi masukkan semuanya ke ZIP. Game tanpa thread boleh memuat dari situs lain.
Di dalam game
- Simpanan di localStorage atau IndexedDB tetap di browser pemain, terpisah untuk setiap game.
- Game boleh memakai layar penuh, kursor mouse, gamepad, suara, dan WebXR. Halaman Sofala juga punya tombol layar penuh.
- Game berjalan di bingkai terisolasi pada alamatnya sendiri: tidak bisa membuka pop-up, meninggalkan halaman, atau melihat akun Sofala pemain. Jangan minta pemain masuk atau membayar di dalam game; Sofala yang menjualnya.
- Multipemain tidak perlu server sendiri: Sofala menjalankan ruangannya (lihat di bawah). Game juga boleh berbicara dengan server milik Anda.
Ponsel dan tablet
- Dengarkan sentuhan pada salah satu elemen game Anda, seperti canvas-nya, bukan pada window atau document: di dalam frame, iPhone tidak selalu meneruskan sentuhan ke window.
- Beri elemen itu CSS touch-action: none, dan panggil preventDefault() di listener touchstart dan touchmove-nya, yang ditambahkan dengan { passive: false }. Jika tidak, ponsel mengira usapan untuk menggulir halaman dan berhenti memberi tahu game Anda setelah beberapa piksel.
- Event pointer (pointerdown, pointermove) juga tiba di ponsel. Game boleh mendengarkan keduanya, asalkan satu jari dihitung sekali.
- Snake Party melakukan semua ini, dan usapannya berfungsi di iPhone; kode sumbernya menunjukkan caranya.
- Jika game Anda dibuat dengan engine, input sentuhnya urusan engine. Dibuat dengan apa pun, coba game di ponsel sebelum menerbitkannya.
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 });Multipemain
- Sofala menjalankan ruangannya, jadi game Anda tidak perlu server. Taruh sofala-game-1.1.js di ZIP Anda di samping index.html, muat sebelum skrip Anda sendiri, dan satu baris memasukkan pemain ke ruangan bersama yang lain.
- Apa pun yang dikirim satu pemain sampai ke pemain lain di ruangan, sesuai urutan pengirimannya. Satu ruangan memuat hingga 32 pemain, dan masing-masing bisa mengirim 60 pesan per detik hingga 16 KB: pas untuk game berbasis giliran, party game, dan game real-time santai. Game tembak-tembakan cepat tetap perlu server sendiri.
- Sofala tidak menjalankan kode Anda. Pemain yang paling lama berada di ruangan menjadi host: biarkan ia menjalankan permainan dan memberi tahu yang lain apa yang berubah. Saat host pergi, pemain berikutnya menjadi host.
- Main cepat mengisi ruangan publik. Ruangan pribadi punya kode untuk teman bergabung.
- Game mengenali setiap pemain dari id yang tetap sama di game Anda dan dari nama pemainnya, tidak pernah dari alamat email atau akun. Nama pemain adalah nama Sofala-nya, kecuali ia memilih nama lain di halaman akunnya; game Anda juga bisa membiarkannya mengetik nama saat bergabung. Orang yang memainkan game gratis tanpa masuk adalah tamu.
- Di komputer Anda sendiri cara kerjanya sama: buka game dari localhost dan ruangannya menjadi ruang uji milik Anda sendiri.
- Jika Anda tetap menjalankan server, Sofala.token() memberinya token bertanda tangan yang menyebutkan siapa pemainnya. Periksa dengan kunci publik di
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>Semua yang bisa dilakukan ruangan tercantum di bagian atas sofala-game-1.1.js. Satu game utuh untuk dicontoh, dalam satu file: Snake Party (kode sumbernya).
Menjualnya
- Jadikan gratis, atau pasang harga termasuk PPN minimal €0,50. Anda menerima harga tanpa PPN, dikurangi biaya Sofala 5% dan biaya Stripe, lewat Stripe: atur pembayaran di halaman Penjualan Anda terlebih dahulu.
- Foto sampul pertama iklan menjadi ubin game di play.sofala.market; tangkapan layar lebar 16:9 paling bagus. Tambahkan tangkapan layar lain dan video pratinjau di halaman edit iklan.
- Seseorang di Sofala memainkan setiap game baru sebelum ditayangkan; Anda menerima email saat game sudah tayang.
- Untuk memperbarui game yang sudah tayang, unggah ZIP baru (agen Anda: upload_files dengan replace). Ia menggantikan yang lama dalam sekitar satu menit, tanpa pemeriksaan baru dan di alamat yang sama, jadi pemain tetap menyimpan progres mereka.