AikaHub.dev Megnyitom a Studiót

Első játékom: Kisboltom

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 lesz a saját kattintós bolt-játékod, az AikaHubbal összekötve: belépés, becenév, szint, achievementek. Programozni nem kell tudnod — csak egy terminál (parancssor) kell, é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 a terminálban:

node -v

Ha v18 vagy nagyobb szám jön ki, mehetünk tovább.

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

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

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

npm run dev

A bolt kezdőképernyője

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 tesztjátékost (pl. Aika-teszt — ő játssza a fejlesztőt, vagyis téged).

Belépés tesztjátékossal

Nyomd meg a Nyitás! gombot, kattints a nagy pultra az érmékért, aztán vegyél egy Limonádé-standot: az magától is hoz egy érmét másodpercenként. Az első fejlesztésért megkapod az Első fejlesztés achievementet. A terminálban is látod (ACHIEVEMENT Aika-teszt …first-upgrade +10 XP), és a Mock Hub oldalán: http://127.0.0.1:8788/

Az első achievement

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: az aikahub.config.json "name" mezője, és az index.html <title> és <h1 id="title"> sora.
  • Színek: COLORS (pl. accent: 0x7af0ff) — az egész oldal követi.
  • Nehézség: TUNING — több érme induláskor (startCoins), olcsóbb fejlesztések (priceGrowth: 1.05), nagyobb cél (goalCoins: 5000).
  • Fejlesztések: UPGRADES — írd át egy price vagy perSecond értékét, vagy adj hozzá új sort (a neve a src/i18n.js-be kerül).

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

Egy kis titok: néha (ritkán, egy megnyitás alatt legfeljebb egyszer) benéz egy róka vásárló, Aika, köszön, és vesz valamit. Nem kell? A src/guest.js tetején leírtuk, hogyan veheted ki.

A bolt magától elmentődik a böngészőben: bezárod, visszajössz, és folytatódik. Ha a TUNING vagy az UPGRADES valamelyik számát átírtad, új bolt indul, hogy azonnal lásd a változást. Mégis elölről kezdenéd? Újrakezdés (jobbra fent).

5. Kérd meg az AI-odat

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:

Adj a bolthoz egy kattintás-fejlesztést: egy új fejlesztés-sort perClick mezővel, amitől minden kattintás a pultra többet ér. Kövesd az AGENTS.md-t, a megjegyzéseket magyarul írd, és a végén futtasd az npm run check-et.

6. Kösd be az igazi AikaHubot

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, és 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"-be az azonosítódat, és állítsd be: "hub": "https://aikahub.com".
  4. A konzol Achievementek lépésében az Importálás gombbal másold be az aikahub.config.json achievements tömbjét.

npm run dev, lépj be újra: most már az igazi AikaHub kérdezi meg, beengeded-e a játékot, és az achievementjeid tesztfeloldásként érkeznek (XP nélkül, csak te és a tesztelőid látjátok), amíg a játék ki 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 mappa server/, tools/ és mock-hub/ nélkül), vedd fel 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 leírás: aikahub.com/developers