AikaHub.dev Studio öffnen

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

Der Startbildschirm des Ladens

Ö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).

Mit Testspieler anmelden

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/

Der erste Erfolg

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" in aikahub.config.json, dazu <title> und <h1 id="title"> in index.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 einen price oder perSecond, oder füge eine neue Zeile hinzu (der Name kommt in src/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 Ende npm run check aus.

6. Das echte AikaHub anbinden

Du brauchst ein AikaHub-Konto mit bestätigter E-Mail-Adresse und musst mindestens 18 Jahre alt sein.

  1. Öffne die Entwicklerkonsole: aikahub.com/developers/console und akzeptiere die Entwicklervereinbarung und die SDK-Lizenz.
  2. Neuer Client: eine client_id, die mit x- beginnt, der Name des Spiels und die Redirect-URI http://127.0.0.1/.
  3. Trag in aikahub.config.json bei "clientId" deine ID ein und setze "hub": "https://aikahub.com".
  4. Im Schritt Erfolge der Konsole mit Importieren das achievements-Array aus aikahub.config.json einfü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