Jogos de navegador
Ririmi, tiko ni mali: TS · Minxavo

Guardado num cookie neste dispositivo. Os preços noutra moeda são aproximados; cada anúncio mostra também o preço do vendedor. Câmbios de Exchange Rate API, atualizados diariamente.

Jogos de navegador

Fazer um jogo de navegador para a 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.

Com o seu agente de IA

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.

  1. 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.
  2. Open PowerShellPowerShell is a window where you type commands. Press the Windows key, type powershell and press Enter. A window opens with a line that starts with PS C:\Users\ and your name. That is where the next lines go.
  3. 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.
  4. Check that it worksIn the new PowerShell window, this prints a version number:
    claude --version
    Does it say that claude is 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.
  5. 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
  6. 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
  7. 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
  8. 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
  9. 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.

O ZIP

  • O index.html inicia o jogo. Ponha-o no topo do ZIP, ou dentro da única pasta do ZIP.
  • Tudo o que o jogo carrega está no ZIP, ligado por caminhos relativos: Build/game.wasm, nunca /Build/game.wasm nem um endereço completo do seu site.
  • Até 1 GB comprimido, 10 000 ficheiros e 2 GB descomprimido.

Motores e tipos de ficheiro

  • Funciona qualquer jogo que corra num navegador: HTML5 canvas, WebGL e WebGPU (three.js, Babylon.js, PixiJS, Phaser, PlayCanvas), WebAssembly (Emscripten, Rust, Bevy, Go), Godot 3 e 4, GameMaker, Construct, Defold, PICO-8, RPG Maker e LÖVE através do love.js.
  • Unity WebGL: qualquer compressão funciona. Os ficheiros Brotli e gzip são enviados com os cabeçalhos certos, por isso não precisa do decompression fallback.
  • Módulos JavaScript, import maps, ficheiros .mjs, modelos glTF e GLB, texturas KTX2 e som WAV, OGG, Opus e MP3 são todos enviados com o tipo certo.

Jogos com várias threads

  • Versões que usam threads (SharedArrayBuffer), como Godot 4 com threads ativas, Emscripten com -pthread e versões Unity ou love.js com threads, precisam de uma página com isolamento entre origens. A Sofala deteta-as quando envia o ZIP e corre-as dessa forma. Para uma versão Unity comprimida só com Brotli, marque “Precisa de SharedArrayBuffer” no anúncio.
  • Um jogo isolado não consegue carregar scripts, imagens ou sons de outros sites, a não ser que estes enviem cabeçalhos CORS ou Cross-Origin-Resource-Policy, por isso ponha tudo no ZIP. Jogos sem threads podem carregar de outros sites.

Dentro do jogo

  • Os jogos guardados em localStorage ou IndexedDB ficam no navegador do jogador, separados para cada jogo.
  • O jogo pode usar ecrã inteiro, o ponteiro do rato, comandos, som e WebXR. A página da Sofala também tem um botão de ecrã inteiro.
  • Corre numa moldura isolada, no seu próprio endereço: não pode abrir janelas pop-up, sair da página nem ver a conta Sofala do jogador. Não peça aos jogadores que iniciem sessão ou paguem dentro do jogo; é a Sofala que o vende.
  • O multijogador não precisa de um servidor seu: a Sofala gere as salas (mais abaixo). Um jogo também pode falar com um servidor seu.

Tifoni ni tithebulete

  • Escute os toques num elemento do seu jogo, como o canvas, não em window nem em document: dentro da moldura, um iPhone nem sempre passa os toques para window.
  • Dê a esse elemento o CSS touch-action: none e chame preventDefault() nos seus listeners de touchstart e touchmove, adicionados com { passive: false }. Caso contrário, o telemóvel toma um deslize por um deslocamento da página e deixa de avisar o seu jogo ao fim de alguns píxeis.
  • Os eventos pointer (pointerdown, pointermove) também chegam nos telemóveis. Um jogo pode escutar os dois tipos, desde que um dedo conte uma só vez.
  • O Snake Party faz tudo isto, e os seus deslizes funcionam num iPhone; o código-fonte mostra como.
  • Se um motor fez o seu jogo, a entrada tátil é do motor. Seja como for que o fez, experimente o jogo num telemóvel antes de o publicar.
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 });

Multijogador

  • A Sofala gere as salas, por isso o seu jogo não precisa de servidor. Coloque sofala-game-1.1.js no seu ZIP ao lado do index.html, carregue-o antes do seu próprio script, e uma linha põe o jogador numa sala com outros.
  • O que um jogador envia chega aos outros na sala, pela ordem em que foi enviado. Uma sala leva até 32 jogadores, e cada um pode enviar 60 mensagens por segundo de até 16 KB: certo para jogos por turnos, de festa e de tempo real descontraído. Um shooter rápido continua a precisar de um servidor próprio.
  • A Sofala não corre nenhum código seu. O jogador que está há mais tempo na sala é o anfitrião: deixe-o conduzir o jogo e dizer aos outros o que mudou. Quando o anfitrião sai, o jogador seguinte passa a anfitrião.
  • O jogo rápido enche salas públicas. Uma sala privada tem um código para os amigos entrarem.
  • O jogo conhece cada jogador por um id que se mantém igual no seu jogo e pelo nome de jogador, nunca por um endereço de e-mail ou por uma conta. O nome de jogador é o nome Sofala, a não ser que a pessoa tenha escolhido outro na página da conta; o seu jogo também pode deixá-la escrever um ao entrar. Quem joga um jogo grátis sem iniciar sessão é convidado.
  • No seu próprio computador funciona da mesma forma: abra o jogo a partir de localhost e as salas são um espaço de teste só seu.
  • Se mesmo assim tiver um servidor, Sofala.token() dá-lhe um token assinado que diz quem é o jogador. Verifique-o com as chaves públicas em 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>

Tudo o que as salas fazem está listado no topo de sofala-game-1.1.js. Um jogo inteiro para copiar, num só ficheiro: Snake Party (o código-fonte).

Vender o jogo

  • Pode ser grátis ou ter um preço com IVA incluído, de pelo menos 0,50 €. Recebe o preço sem IVA, menos a comissão de 5% da Sofala e a taxa da Stripe, através da Stripe: configure primeiro os pagamentos na sua página de Vendas.
  • A primeira foto de capa do anúncio é o mosaico do jogo em play.sofala.market; resulta melhor uma captura larga em 16:9. Junte mais capturas e um vídeo de apresentação na página de edição do anúncio.
  • Uma pessoa da Sofala joga cada jogo novo antes de ser publicado; recebe um e-mail quando estiver publicado.
  • Para atualizar um jogo publicado, carregue o ZIP novo (o seu agente: upload_files com replace). Ocupa o lugar do anterior em cerca de um minuto, sem nova verificação e no mesmo endereço, por isso os jogadores mantêm os jogos guardados.

Publique o seu jogo