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/

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ő).

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:

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/

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 azaikahub.config.json→"name". - Színek:
style.csslegteteje (--neon,--pink…), és asrc/game.config.js→COLORS(pl.player: 0xff8800). - Ellenfelek:
src/game.config.js→ENEMY_TYPES. Írd át aspeedszá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.
- Nyisd meg a Fejlesztői konzolt: aikahub.com/developers/console.
- 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.
- 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.
- Azonosító (client_id):
- 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.
- 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. - Í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:
- 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/ésmock-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 azaikahub.config.json-ban. - 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).
- 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