Mein erstes Spiel: Mein kleiner Laden
Etwa 15 Minuten, auf deinem eigenen Rechner. Du brauchst ein Terminal und Neugier, keine Programmiererfahrung.
Gar nichts installieren? Das Gleiche geht im Studio, im Browser: Studio öffnen
In etwa 15 Minuten hast du dein eigenes Klick-Ladenspiel, verbunden mit AikaHub: Anmeldung, Spitzname, Level, Erfolge. Programmieren musst du nicht können — du brauchst nur ein Terminal (Kommandozeile) und etwas Neugier.
1. Node installieren
Lade die Node.js-LTS-Version von nodejs.org herunter und installiere sie. Dann im Terminal:
node -v
Siehst du v18 oder höher, kann es losgehen.
2. Spiel herunterladen
Lade auf der Seite Für Entwickler das deutsche Laden-Starterpaket (aikahub-shop-de.zip) herunter, entpacke es und öffne ein Terminal im Ordner aikahub-shop.
3. Starten und spielen
npm run dev

Öffne http://127.0.0.1:5173/ im Browser. Klick auf Mit AikaHub anmelden: Das ist vorerst der lokale Mock Hub, ein kleines „Pseudo-AikaHub“ auf deinem Rechner. Wähle einen Testspieler (z. B. Aika-teszt — der spielt dich, den Entwickler).

Drück Laden öffnen!, klick auf die große Theke für Münzen und kauf dann einen Limonade-Stand: Der bringt von selbst eine Münze pro Sekunde. Dein erstes Upgrade bringt den Erfolg Erstes Upgrade. Du siehst ihn auch im Terminal (ACHIEVEMENT Aika-teszt …first-upgrade +10 XP) und auf der Mock-Hub-Seite: http://127.0.0.1:8788/

4. Mach es zu deinem
Öffne den Ordner in einem Editor (z. B. VS Code). Alles, was das Spiel verändert, steht in src/game.config.js:
- Name:
"name"inaikahub.config.json, dazu<title>und<h1 id="title">inindex.html. - Farben:
COLORS(z. B.accent: 0x7af0ff) — die ganze Seite folgt ihnen. - Schwierigkeit:
TUNING— mehr Münzen am Anfang (startCoins), günstigere Upgrades (priceGrowth: 1.05), ein größeres Ziel (goalCoins: 5000). - Upgrades:
UPGRADES— ändere einenpriceoderperSecond, oder füge eine neue Zeile hinzu (der Name kommt insrc/i18n.js).
Speichern, Browser neu laden (F5). Jetzt ist es dein Spiel.
Ein kleines Geheimnis: Ab und zu (selten, höchstens einmal pro Besuch) schaut eine Fuchs-Kundin namens Aika vorbei, grüßt und kauft etwas. Nicht gewünscht? Oben in src/guest.js steht, wie du sie entfernst.
Der Laden speichert sich selbst im Browser: schließen, wiederkommen, und es geht weiter. Hast du eine Zahl in TUNING oder UPGRADES geändert, startet ein neuer Laden, damit du die Änderung sofort siehst. Trotzdem von vorn? Neu starten (oben rechts).
5. Frag deine KI
Im Ordner liegt eine AGENTS.md (und eine CLAUDE.md): Daraus lernt dein KI-Assistent das Projekt und seine Regeln. Probier:
Füge ein Klick-Upgrade hinzu: eine neue Upgrade-Zeile mit einem
perClick-Feld, das jeden Klick auf die Theke mehr wert macht. Halte dich an AGENTS.md, schreib die Kommentare auf Deutsch und führe am Endenpm run checkaus.
6. Das echte AikaHub anbinden
Du brauchst ein AikaHub-Konto mit bestätigter E-Mail-Adresse und musst mindestens 18 Jahre alt sein.
- Öffne die Entwicklerkonsole: aikahub.com/developers/console und akzeptiere die Entwicklervereinbarung und die SDK-Lizenz.
- Neuer Client: eine
client_id, die mitx-beginnt, der Name des Spiels und die Redirect-URIhttp://127.0.0.1/. - Trag in
aikahub.config.jsonbei"clientId"deine ID ein und setze"hub": "https://aikahub.com". - Im Schritt Erfolge der Konsole mit Importieren das
achievements-Array ausaikahub.config.jsoneinfügen.
npm run dev, erneut anmelden: Jetzt fragt das echte AikaHub, ob du das Spiel hereinlässt, und deine Erfolge kommen als Test-Freischaltungen an (ohne XP, nur du und deine Tester sehen sie), bis das Spiel im Játéktér ist.
7. Beim Játéktér einreichen
Stell das Spiel unter eine https-Adresse (der Ordner ohne server/, tools/ und mock-hub/), trag die Adresse bei den Redirect-URIs ein, füll in der Konsole die Spielplatz-Seite aus und reiche ein. Wir prüfen es, danach kann jeder spielen.
Fragen? Schreib an info@aika.hu · Entwickler-Leitfaden: aikahub.com/developers