AikaHub.dev Megnyitom a Studiót

Első játékom

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 lesz egy saját játékod, ami össze van kötve az AikaHubbal: belépés, becenév, szint, achievementek. Nem kell hozzá programozói múlt, csak egy terminál (parancssor) és 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, kész vagy.

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

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

A mappát nyugodtan nevezd át a játékod nevére. A játék nevét az aikahub.config.json name mezőjében írhatod át (lásd a 4. lépést).

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

cd neon-rokak
npm run dev

Nyisd meg a böngészőben: http://127.0.0.1:5173/

A játék kezdőképernyője

Kattints a Belépés AikaHubbal gombra. Ez most még a helyi Mock Hub, egy kis „ál-AikaHub” a gépeden: válassz egy tesztjátékost (pl. Aika-teszt — ő vagy te, a fejlesztő).

Belépés tesztfiókkal

Visszaérsz a játékba, és jobb fent ott a beceneved és a szinted. Nyomd meg az Indítás gombot: WASD-vel mozogsz, egérrel célzol és lősz (telefonon: bal hüvelykujj mozog, jobb céloz). Az első legyőzött ellenfélnél megkapod az Első vér achievementet:

Az első achievement

A terminálban is látod (ACHIEVEMENT Aika-teszt …first-blood +10 XP), és a Mock Hub oldalán is: http://127.0.0.1:8788/

A Mock Hub áttekintője

4. Legyen a tiéd

Most jön a legjobb rész. Nyisd meg a mappát egy szerkesztőben (pl. VS Code), és írj át pár dolgot:

  • Név: index.html → a <title> és a <h1 id="title">, meg az aikahub.config.json → "name".
  • Színek: style.css legteteje (--neon, --pink …), és a src/game.config.js → COLORS (pl. player: 0xff8800).
  • Ellenfelek: src/game.config.js → ENEMY_TYPES. Írd át a speed számot (pl. 5 → 8), és figyeld, mi történik.
  • Nehézség: src/game.config.js → TUNING — több élet (lives), gyorsabb lövés (fireRate), több ellenfél (perWave).

Ments, frissítsd a böngészőt (F5). Ez már a te játékod.

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

A mappában van egy AGENTS.md (és CLAUDE.md): ebből az AI-asszisztensed (Claude, ChatGPT, Copilot, Cursor …) megérti a projektet és a szabályokat. Próbáld ki ezt a kérést:

Adj a játékhoz egy power-upot: néha egy zöld gyűrű esik ki a legyőzött ellenfélből, és ha felveszem, 5 másodpercig kétszer olyan gyorsan lövök. Kövesd az AGENTS.md-t, a kommentek legyenek magyarul, és a végén futtasd az npm run check-et.

Nézd át, mit változtatott, és próbáld ki. Ha nem tetszik, kérj mást — vagy írd át magad.

6. Fejlesztői fiók és saját kliens az AikaHubon

Eddig minden a gépeden történt. Most kösd össze a valódi AikaHubbal (ingyenes). Kell hozzá egy AikaHub-fiók megerősített e-mail-címmel (Beállítások), és legalább 18 évesnek kell lenned.

  1. Nyisd meg a Fejlesztői konzolt: aikahub.com/developers/console.
  2. 1. Megállapodás: olvasd el a Fejlesztői Megállapodást és az SDK Licencet. Jelöld be a két négyzetet (a megállapodás + SDK Licenc, és külön a Kiemelt feltételek), a nyilatkozatokat (18 éves elmúltál; az EGT-ben vagy megfelelőségi döntéssel rendelkező országban vagy), azt, hogy magánszemélyként vagy vállalkozásként csatlakozol, aztán Elfogadom. A visszaigazolást e-mailben is megkapod.
  3. 2. Kliens → Új kliens:
    • Azonosító (client_id): x- előtaggal, pl. x-neon-rokak (később nem változtatható).
    • A játék neve: pl. Neon Rókák.
    • Visszatérési címek (soronként egy): http://127.0.0.1/ — port nélkül, mert helyben bármelyik port jó.
    • Létrehozás — és már meg is van a client_id-d.
  4. Tesztelők: ha a barátaid is kipróbálnák, add hozzá őket becenév szerint (legfeljebb 5), majd Tesztelők mentése. A fejlesztői változatba csak te és ők léphettek be.
  5. Szerverkulcs (csak ha a server/ részt is használod): a játék létrehozásakor már kaptál egy kulcsot (server/.env.local, ahk_…), és a program kiírta a hash-ét. Újat így kérhetsz: npm run key -- --force. A kiírt 64 karakteres hash-t másold be, és Hash feltöltése. Magát a kulcsot (ahk_…) soha ne másold be, és ne küldd el senkinek — a konzol el sem fogadja.
  6. Írd át az aikahub.config.json-t:
"clientId": "x-neon-rokak",
"hub": "https://aikahub.com",

7. Lépj be élesben

npm run dev, a játékban Belépés AikaHubbal — most már a valódi AikaHub kérdezi meg, beengeded-e a játékot. Az első valódi belépésed a saját játékodba hozza a „Van saját játékom!” achievementet az AikaHubon. Gratulálunk!

Most jöjjenek a játékod saját achievementjei (Első vér, Ötödik hullám, Ezres klub): a Fejlesztői konzolban nyisd meg a kliensed Achievementek lépését, és az Importálás gombbal másold be az aikahub.config.json achievements tömbjét (ugyanaz a formátum — vagy vedd fel őket egyenként). Mentés után játssz újra: az első legyőzött ellenfélnél az Első vér most már a valódi AikaHubon is feloldódik — tesztfeloldásként („homokozó”): XP nem jár érte, és csak te meg a tesztelőid látjátok. A konzolban látod („Sandbox: 1 tesztfeloldás”), és ott törölheted is, ha újra ki akarod próbálni. Az első ilyen hozza az „Az első saját achievementem” alkotói achievementet. 🎉

Amikor a játékod kikerül a Játéktérre, az átnézett achievementek élesek lesznek (valódi XP, profil, játékoldal), a tesztfeloldások pedig törlődnek. Ami a konzolban nincs felvéve, arra a Hub 404 unknown_achievement-tel felel — a játék ezt egy sorral jelzi a böngésző konzoljában, és kihagyja.

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

Ha szeretnéd, hogy mások is játszhassanak vele:

  1. Tedd fel a játékot egy https-címre (bármilyen statikus tárhely jó: a mappát úgy, ahogy van, a server/, tools/ és mock-hub/ mappa nélkül). A konzolban vedd fel ezt a címet is a visszatérési címek közé, és állítsd be a "redirectUri"-t az aikahub.config.json-ban.
  2. A konzolban a 4. Játéktér lépésnél töltsd ki a Játéktér-oldalt: név, rövid leírás magyarul, platform, a link, ahol játszani lehet, borítókép (16:9), az üzemeltető neve és országa, a játék adatkezelési tájékoztatója (https) és egy elérhetőség (ezt csak mi látjuk).
  3. Beküldöm. Átnézzük, és ha minden rendben, kikerül a Játéktérre: onnantól bárki beléphet vele.

Kérdésed van? Írj: info@aika.hu · Fejlesztői leírás: aikahub.com/developers