AikaHub.dev Megnyitom a Studiót

Első játékom: Csillagsziget

Kb. 15 perc, a saját gépeden. Egy terminál és kíváncsiság kell hozzá, programozói múlt nem.

Semmit nem telepítenél? Ugyanezt a Studióban is megcsinálhatod, a böngésződben: Megnyitom a Studiót

Kb. 15 perc alatt kész a saját nyugis 3D szigeti sétád, AikaHubbal összekötve: belépés, becenév, szint, achievementek — és a szigeten a saját AikaHub-karaktereddel sétálsz. Nem kell hozzá programozói múlt, csak egy terminál (parancssor) és egy kis kíváncsiság.

1. Telepítsd a Node-ot

Töltsd le a Node.js LTS változatát a nodejs.org oldalról, és telepítsd. Utána egy terminálban:

node -v

Ha v18 vagy nagyobb számot látsz, mehetünk.

2. Töltsd le a játékot

A Fejlesztőknek oldalon töltsd le a magyar szigeti kezdőcsomagot (aikahub-island-hu.zip), csomagold ki, és nyiss egy terminált az aikahub-island mappában.

3. Indítsd el, és játssz

npm run dev

Nyisd meg a böngészőben: http://127.0.0.1:5173/, és nyomd meg az Indulás! gombot. WASD-vel vagy a nyilakkal sétálsz, a kamerát Q/E-vel vagy egérhúzással fordítod. Telefonon: a bal hüvelykujjad sétál (alatta megjelenik egy kis botkormány), jobb oldalon húzva fordul a kamera. Minden csillag számít, amibe belesétálsz; az első az Első csillag achievementet hozza.

A sziget kezdőképernyője

Séta a szigeten

Kattints a Belépés AikaHubbal gombra: ez most a helyi Mock Hub, egy kis „ál-AikaHub” a gépeden. Válassz tesztjátékost (pl. Kitsune). A belépés előtt megszerzett achievementek most felmennek. A terminálban is látod őket (ACHIEVEMENT Kitsune …first-star +10 XP), és a Mock Hub oldalán: http://127.0.0.1:8788/

Belépés tesztjátékossal

Az első achievement

A saját karaktered: a valódi AikaHubon a játék azt a karaktert tölti be, amit a Karakterem oldalon választottál. A Mock Hubon még nincs ilyen, ezért egy egyszerű tartalék-figura sétál — ha helyben is ki akarod próbálni, nézd meg a mock-hub/characters/README.txt fájlt.

4. Tedd a sajátoddá

Nyisd meg a mappát egy szerkesztőben (pl. VS Code). Minden, amitől más lesz a játék, a src/game.config.js-ben van:

  • Név: "name" az aikahub.config.json-ban, és a <title> meg a <h1 id="title"> az index.html-ben.
  • Színek: COLORS (pl. item: 0xff7ad9 rózsaszín csillagokhoz, sky, grass, water).
  • Szabályok: TUNING — gyorsabb séta (walkSpeed: 8), több csillag (items: 20), könnyebb cél (goalItems: 8).
  • A sziget: WORLD — nagyobb sziget (islandSize: 24), több fa, vagy más seed egy új elrendezéshez.

Mentsd, frissítsd a böngészőt (F5). Mostantól a te játékod.

A séta magától elmentődik a böngészőben: bezárod, visszajössz, és a megtalált csillagok megmaradnak. Ha a csillagokon, a célon vagy a szigeten változtattál, új séta indul, hogy rögtön lásd a változást. Mégis elölről kezdenéd? Újrakezdés (jobb fent).

Psszt: a sziget szélén elbújt valami apróság. Sétálj körbe, és nézz be a kövek mögé.

5. Kérd meg az AI-t, hogy segítsen

A mappában van egy AGENTS.md (és egy CLAUDE.md): ebből tanulja meg az AI-asszisztensed a projektet és a szabályait. Próbáld ki:

Tegyél a partra kagylókat második gyűjthető tárgynak, saját számlálóval a HUD-ban. Kövesd az AGENTS.md-t, a kommentek legyenek magyarul, és a végén futtasd az npm run check-et.

6. Kösd össze a valódi AikaHubbal

Kell hozzá egy AikaHub-fiók megerősített e-mail-címmel, és legalább 18 évesnek kell lenned.

  1. Nyisd meg a Fejlesztői konzolt: aikahub.com/developers/console, fogadd el a Fejlesztői megállapodást és az SDK-licencet.
  2. Új kliens: egy x- kezdetű client_id, a játék neve, és a visszatérési cím: http://127.0.0.1/.
  3. Az aikahub.config.json-ban írd be a "clientId"-hez az azonosítódat, és állítsd be: "hub": "https://aikahub.com".
  4. A konzol Achievementek lépésében Importáld az aikahub.config.json achievements tömbjét.

npm run dev, lépj be újra: most a valódi AikaHub kérdezi meg, beengeded-e a játékot (és megmutathatja-e a karakteredet), a saját karaktered sétál a szigeten, az achievementjeid pedig tesztfeloldásként érkeznek (XP nélkül, csak te és a tesztelőid látjátok), amíg a játék fel nem kerül a Játéktérre.

7. Küldd be a Játéktérre

Tedd fel a játékot egy https címre (a mappát a server/, tools/ és mock-hub/ nélkül), vedd fel ezt a címet a visszatérési címek közé, töltsd ki a konzolban a Játéktér-oldalt, és Küldd be. Átnézzük, és utána bárki játszhat vele.

Kérdésed van? Írj az info@aika.hu címre · Fejlesztői útmutató: aikahub.com/developers