AikaHub.dev Studio öffnen

Mein erstes Spiel: Sterneninsel

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 deinen eigenen gemütlichen 3D-Inselspaziergang, verbunden mit AikaHub: Anmeldung, Spitzname, Level, Erfolge — und du gehst als dein eigener AikaHub-Charakter über die Insel. Du brauchst keine Programmiererfahrung, 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. Das Spiel herunterladen

Lade auf der Seite Entwickler das deutsche Insel-Starterpaket (aikahub-island-de.zip) herunter, entpacke es und öffne ein Terminal im Ordner aikahub-island.

3. Starten und spielen

npm run dev

Öffne http://127.0.0.1:5173/ im Browser und drück Los geht’s!. Du gehst mit WASD oder den Pfeiltasten, die Kamera drehst du mit Q/E oder indem du die Maus ziehst. Am Handy: dein linker Daumen geht (darunter erscheint ein kleiner Stick), rechts ziehen dreht die Kamera. Jeder Stern, in den du hineinläufst, zählt; der erste bringt den Erfolg Erster Stern.

Der Startbildschirm der Insel

Spaziergang auf der Insel

Klick auf Mit AikaHub anmelden: Das ist erst einmal der lokale Mock Hub, ein kleines „Pseudo-AikaHub“ auf deinem Rechner. Wähle einen Testspieler (z. B. Kitsune). Die Erfolge von vor der Anmeldung kommen jetzt an. Du siehst sie auch im Terminal (ACHIEVEMENT Kitsune …first-star +10 XP) und auf der Mock-Hub-Seite: http://127.0.0.1:8788/

Mit Testspieler anmelden

Der erste Erfolg

Dein eigener Charakter: Auf dem echten AikaHub lädt das Spiel den Charakter, den du unter Mein Charakter gewählt hast. Im Mock Hub gibt es noch keinen, darum geht eine einfache Ersatzfigur — wie du es lokal ausprobierst, steht in mock-hub/characters/README.txt.

4. Mach es zu deinem Spiel

Ö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. item: 0xff7ad9 für rosa Sterne, sky, grass, water).
  • Regeln: TUNING — schneller gehen (walkSpeed: 8), mehr Sterne (items: 20), ein leichteres Ziel (goalItems: 8).
  • Die Insel: WORLD — eine größere Insel (islandSize: 24), mehr Bäume oder ein anderer seed für eine neue Anordnung.

Speichern, Browser neu laden (F5). Jetzt ist es dein Spiel.

Der Spaziergang speichert sich selbst im Browser: schließen, wiederkommen, und die gefundenen Sterne bleiben gefunden. Hast du Sterne, Ziel oder Insel geändert, startet ein neuer Spaziergang, damit du die Änderung sofort siehst. Trotzdem von vorn? Neu starten (oben rechts).

Psst: Am Inselrand versteckt sich etwas Kleines. Geh herum und schau hinter die Steine.

5. Lass dir von deiner KI helfen

Im Ordner liegt eine AGENTS.md (und eine CLAUDE.md): daraus lernt dein KI-Assistent das Projekt und seine Regeln. Probier:

Leg Muscheln als zweite Sammelsache an den Strand, mit eigenem Zähler im HUD. Halte dich an AGENTS.md, schreib die Kommentare auf Deutsch und führe am Ende npm run check aus.

6. Das echte AikaHub verbinden

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, 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. Setze in aikahub.config.json "clientId" auf deine ID und "hub": "https://aikahub.com".
  4. Im Schritt Erfolge der Konsole das achievements-Array aus aikahub.config.json importieren.

npm run dev, neu anmelden: Jetzt fragt das echte AikaHub, ob du das Spiel hereinlässt (und deinen Charakter zeigen darfst), dein eigener Charakter geht über die Insel, und deine Erfolge kommen als Test-Freischaltungen an (ohne XP, nur du und deine Tester sehen sie), bis das Spiel auf dem Játéktér ist.

7. Beim Játéktér einreichen

Stell das Spiel unter eine https-Adresse (den 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 · Entwicklerleitfaden: aikahub.com/developers