Φτιάξτε ένα παιχνίδι browser για τη 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.
Με τον πράκτορα AI σας
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.
- Ό,τι φορτώνει το παιχνίδι βρίσκεται στο ZIP, συνδεδεμένο με σχετικές διαδρομές: Build/game.wasm, ποτέ /Build/game.wasm ή πλήρη διεύθυνση του δικού σας ιστότοπου.
- Έως 1 GB συμπιεσμένο, 10 000 αρχεία και 2 GB αποσυμπιεσμένο.
Μηχανές και τύποι αρχείων
- Λειτουργεί κάθε παιχνίδι που τρέχει σε browser: 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.
- Τα modules JavaScript, τα import maps, τα αρχεία .mjs, τα μοντέλα glTF και GLB, οι υφές KTX2 και ο ήχος WAV, OGG, Opus και MP3 στέλνονται όλα με τον σωστό τύπο.
Πολυνηματικά παιχνίδια
- Οι εκδόσεις που χρησιμοποιούν νήματα (SharedArrayBuffer), όπως το Godot 4 με ενεργά νήματα, το Emscripten με -pthread και οι πολυνηματικές εκδόσεις Unity ή love.js, χρειάζονται σελίδα με απομόνωση προελεύσεων. Η Sofala τις αναγνωρίζει όταν ανεβάζετε το ZIP και τις τρέχει έτσι. Για έκδοση Unity συμπιεσμένη μόνο με Brotli, επιλέξτε «Χρειάζεται SharedArrayBuffer» στην αγγελία.
- Ένα απομονωμένο παιχνίδι δεν μπορεί να φορτώσει scripts, εικόνες ή ήχους από άλλους ιστότοπους, εκτός αν αυτοί στέλνουν κεφαλίδες CORS ή Cross-Origin-Resource-Policy, οπότε βάλτε τα όλα στο ZIP. Τα παιχνίδια χωρίς νήματα μπορούν να φορτώνουν από άλλους ιστότοπους.
Μέσα στο παιχνίδι
- Οι αποθηκεύσεις σε localStorage ή IndexedDB μένουν στον browser του παίκτη, χωριστά για κάθε παιχνίδι.
- Το παιχνίδι μπορεί να χρησιμοποιεί πλήρη οθόνη, τον δείκτη του ποντικιού, χειριστήρια, ήχο και WebXR. Η σελίδα της Sofala έχει κι αυτή κουμπί πλήρους οθόνης.
- Τρέχει σε απομονωμένο πλαίσιο, στη δική του διεύθυνση: δεν μπορεί να ανοίξει αναδυόμενα παράθυρα, να φύγει από τη σελίδα ή να δει τον λογαριασμό Sofala του παίκτη. Μη ζητάτε από τους παίκτες να συνδεθούν ή να πληρώσουν μέσα στο παιχνίδι· το πουλά η Sofala.
- Το παιχνίδι πολλών παικτών δεν χρειάζεται δικό σας διακομιστή: η Sofala τρέχει τα δωμάτια (παρακάτω). Ένα παιχνίδι μπορεί επίσης να μιλά με δικό σας διακομιστή.
Κινητά και tablet
- Ακούτε τα αγγίγματα σε ένα στοιχείο του παιχνιδιού σας, όπως το canvas του, όχι στο window ή στο document: μέσα στο πλαίσιο, ένα iPhone δεν περνά πάντα τα αγγίγματα στο window.
- Δώστε σε αυτό το στοιχείο το CSS touch-action: none και καλέστε preventDefault() στους listeners touchstart και touchmove του, που προστίθενται με { passive: false }. Αλλιώς το κινητό θεωρεί το σύρσιμο κύλιση της σελίδας και σταματά να το λέει στο παιχνίδι σας μετά από λίγα pixel.
- Τα συμβάντα 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, φορτώστε το πριν από το δικό σας script, και μία γραμμή βάζει τον παίκτη σε δωμάτιο με άλλους.
- Ό,τι στέλνει ένας παίκτης φτάνει στους άλλους στο δωμάτιο, με τη σειρά που στάλθηκε. Ένα δωμάτιο χωρά έως 32 παίκτες, και ο καθένας μπορεί να στείλει 60 μηνύματα το δευτερόλεπτο έως 16 KB: σωστό για παιχνίδια με γύρους, party games και χαλαρά παιχνίδια πραγματικού χρόνου. Ένα γρήγορο shooter χρειάζεται ακόμη δικό του διακομιστή.
- Η Sofala δεν τρέχει κανέναν κώδικά σας. Ο παίκτης που είναι περισσότερο χρόνο στο δωμάτιο είναι ο οικοδεσπότης: αφήστε τον να τρέχει το παιχνίδι και να λέει στους άλλους τι άλλαξε. Όταν ο οικοδεσπότης φύγει, οικοδεσπότης γίνεται ο επόμενος παίκτης.
- Το γρήγορο παιχνίδι γεμίζει δημόσια δωμάτια. Ένα ιδιωτικό δωμάτιο έχει κωδικό για να μπαίνουν φίλοι.
- Το παιχνίδι γνωρίζει κάθε παίκτη από ένα id που μένει ίδιο στο παιχνίδι σας και από το όνομα παίκτη του, ποτέ από διεύθυνση email ή λογαριασμό. Το όνομα παίκτη είναι το όνομά του στη Sofala, εκτός αν έχει επιλέξει άλλο στη σελίδα του λογαριασμού του· το παιχνίδι σας μπορεί επίσης να τον αφήσει να γράψει ένα όταν μπαίνει. Όσοι παίζουν ένα δωρεάν παιχνίδι χωρίς σύνδεση είναι επισκέπτες.
- Στον δικό σας υπολογιστή λειτουργεί το ίδιο: ανοίξτε το παιχνίδι από το localhost και τα δωμάτια είναι ένας δικός σας χώρος δοκιμών.
- Αν τελικά τρέχετε διακομιστή, το Sofala.token() του δίνει ένα υπογεγραμμένο 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 €. Παίρνετε την τιμή χωρίς ΦΠΑ, μείον την προμήθεια 5% της Sofala και τη χρέωση της Stripe, μέσω Stripe: ρυθμίστε πρώτα τις πληρωμές στη σελίδα Πωλήσεις.
- Η πρώτη φωτογραφία εξωφύλλου της αγγελίας είναι το πλακίδιο του παιχνιδιού στο play.sofala.market· ταιριάζει καλύτερα ένα φαρδύ στιγμιότυπο 16:9. Προσθέστε κι άλλα στιγμιότυπα και ένα βίντεο προεπισκόπησης στη σελίδα επεξεργασίας της αγγελίας.
- Ένας άνθρωπος της Sofala παίζει κάθε νέο παιχνίδι πριν ανέβει· λαμβάνετε email όταν είναι διαθέσιμο.
- Για να ενημερώσετε ένα παιχνίδι που είναι ήδη διαθέσιμο, ανεβάστε το νέο ZIP (ο πράκτοράς σας: upload_files με replace). Παίρνει τη θέση του παλιού σε περίπου ένα λεπτό, χωρίς νέο έλεγχο και στην ίδια διεύθυνση, οπότε οι παίκτες κρατούν τις αποθηκεύσεις τους.