Сделайте браузерную игру для 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.
С вашим ИИ-агентом
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 запускает игру. Положите его в корень ZIP или в его единственную папку.
- Всё, что загружает игра, лежит в ZIP и подключается по относительным путям: Build/game.wasm, а не /Build/game.wasm и не полный адрес вашего сайта.
- До 1 GB в архиве, 10 000 файлов и 2 GB в распакованном виде.
Движки и типы файлов
- Подойдёт любая игра, которая работает в браузере: HTML5 canvas, WebGL и WebGPU (three.js, Babylon.js, PixiJS, Phaser, PlayCanvas), WebAssembly (Emscripten, Rust, Bevy, Go), Godot 3 и 4, GameMaker, Construct, Defold, PICO-8, RPG Maker и LÖVE через love.js.
- Unity WebGL: подходит любое сжатие. Файлы Brotli и gzip отдаются с правильными заголовками, так что decompression fallback не нужен.
- Модули JavaScript, import maps, файлы .mjs, модели glTF и GLB, текстуры KTX2 и звук WAV, OGG, Opus и MP3 отдаются с правильным типом.
Многопоточные игры
- Сборкам с потоками (SharedArrayBuffer), например Godot 4 с включёнными потоками, Emscripten с -pthread и многопоточным сборкам Unity или love.js, нужна страница с изоляцией между источниками. Sofala распознаёт их при загрузке ZIP и запускает так. Для сборки Unity, сжатой только Brotli, отметьте в объявлении «Нужен SharedArrayBuffer».
- Изолированная игра не может загружать скрипты, изображения или звуки с других сайтов, если те не отправляют заголовки CORS или Cross-Origin-Resource-Policy, поэтому кладите всё в ZIP. Игры без потоков могут загружать с других сайтов.
Внутри игры
- Сохранения в localStorage или IndexedDB остаются в браузере игрока, отдельно для каждой игры.
- Игра может использовать полный экран, указатель мыши, геймпады, звук и WebXR. На странице Sofala тоже есть кнопка полного экрана.
- Она работает в изолированном фрейме по собственному адресу: не может открывать всплывающие окна, уходить со страницы или видеть аккаунт игрока на Sofala. Не просите игроков входить в аккаунт или платить внутри игры; её продаёт Sofala.
- Для мультиплеера не нужен свой сервер: Sofala ведёт комнаты (ниже). Игра может общаться и с вашим собственным сервером.
Телефоны и планшеты
- Слушайте касания на элементе игры, например на её canvas, а не на window или document: внутри фрейма iPhone не всегда передаёт касания в window.
- Задайте этому элементу CSS touch-action: none и вызывайте preventDefault() в его обработчиках touchstart и touchmove, добавленных с { passive: false }. Иначе телефон примет свайп за прокрутку страницы и через несколько пикселей перестанет сообщать о нём игре.
- События pointer (pointerdown, pointermove) тоже приходят на телефонах. Игра может слушать оба вида, если один палец засчитывается один раз.
- Snake Party делает всё это, и его свайпы работают на iPhone; его исходный код показывает как.
- Если вашу игру собрал движок, сенсорный ввод на совести движка. Чем бы она ни была сделана, проверьте игру на телефоне перед публикацией.
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 });Мультиплеер
- Sofala ведёт комнаты, так что вашей игре не нужен сервер. Положите sofala-game-1.1.js в ZIP рядом с index.html, загрузите его перед своим скриптом, и одна строка поместит игрока в комнату с другими.
- То, что отправляет один игрок, доходит до остальных в комнате в порядке отправки. В комнате до 32 игроков, и каждый может отправлять 60 сообщений в секунду размером до 16 КБ: подходит для пошаговых, вечериночных и спокойных игр в реальном времени. Быстрому шутеру по-прежнему нужен свой сервер.
- Sofala не выполняет ваш код. Игрок, который дольше всех в комнате, становится хостом: пусть он ведёт игру и сообщает остальным, что изменилось. Когда хост уходит, хостом становится следующий игрок.
- Быстрая игра заполняет публичные комнаты. У приватной комнаты есть код, по которому входят друзья.
- Игра знает каждого игрока по id, который в вашей игре не меняется, и по имени игрока, но никогда по адресу почты или аккаунту. Имя игрока совпадает с его именем на Sofala, если он не выбрал другое на странице аккаунта; ваша игра может также дать ему ввести имя при входе. Кто играет в бесплатную игру без входа, тот гость.
- На вашем компьютере всё работает так же: откройте игру с localhost, и комнаты станут вашим собственным тестовым пространством.
- Если у вас всё же есть сервер, Sofala.token() даёт ему подписанный токен, который сообщает, кто игрок. Проверьте его открытыми ключами по адресу
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>Всё, что умеют комнаты, перечислено в начале sofala-game-1.1.js. Целая игра для примера, в одном файле: Snake Party (его исходный код).
Продажа
- Сделайте её бесплатной или назначьте цену с НДС не меньше 0,50 €. Вы получаете цену без НДС за вычетом комиссии Sofala 5% и комиссии Stripe через Stripe: сначала настройте выплаты на странице «Продажи».
- Первое фото обложки объявления становится плиткой игры на play.sofala.market; лучше всего подходит широкий скриншот 16:9. Добавьте ещё скриншоты и видео-превью на странице редактирования объявления.
- Сотрудник Sofala играет в каждую новую игру перед публикацией; вы получите письмо, когда она появится.
- Чтобы обновить опубликованную игру, загрузите новый ZIP (ваш агент: upload_files с replace). Он займёт место старого примерно за минуту, без новой проверки и по тому же адресу, так что сохранения игроков останутся.