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.


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/


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"inaikahub.config.json, dazu<title>und<h1 id="title">inindex.html. - Farben:
COLORS(z. B.item: 0xff7ad9fü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 andererseedfü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 checkaus.
6. Das echte AikaHub verbinden
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, 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/. - Setze in
aikahub.config.json"clientId"auf deine ID und"hub": "https://aikahub.com". - Im Schritt Erfolge der Konsole das
achievements-Array ausaikahub.config.jsonimportieren.
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