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.


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/


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"azaikahub.config.json-ban, és a<title>meg a<h1 id="title">azindex.html-ben. - Színek:
COLORS(pl.item: 0xff7ad9ró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ásseedegy ú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.
- Nyisd meg a Fejlesztői konzolt: aikahub.com/developers/console, fogadd el a Fejlesztői megállapodást és az SDK-licencet.
- Új kliens: egy
x-kezdetűclient_id, a játék neve, és a visszatérési cím:http://127.0.0.1/. - Az
aikahub.config.json-ban írd be a"clientId"-hez az azonosítódat, és állítsd be:"hub": "https://aikahub.com". - A konzol Achievementek lépésében Importáld az
aikahub.config.jsonachievementstö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