Roblox-játék készítése MI és Thrixel segítségével

A Thrixel generálja a 3D-modelleket, a Build World irányítja a programozóügynököt, a Rojo pedig szinkronizálja a játék kódját a Roblox Studióval.

A kezdéshez telepített Roblox Studióra és egy Roblox-fiókra lesz szükség.

Build a Gigacorp, a Thrixel Build World készségével készült Roblox-játék.

1. A Rojo telepítése VS Code-dal

  1. Telepítsd a Visual Studio Code-ot (VS Code).
  2. Telepítsd a Rojo - Roblox Studio Sync bővítményt a VS Code-hoz.
  3. A VS Code-ban válaszd a File > Open Folder menüpontot, és nyiss meg egy üres mappát a játék számára.
  4. Nyisd meg a parancspalettát a Ctrl + Shift + P billentyűkkel (Macen Cmd + Shift + P). Írd be, hogy „Rojo”, majd válaszd a Rojo: Open Menu lehetőséget.
  5. Ha a menü szerint a Rojo nincs telepítve, kattints az Install Rojo now lehetőségre.
  6. Kattints az Install Roblox Studio Plugin lehetőségre. Ha a Studio nyitva van, indítsd újra. Ezután a Rojónak meg kell jelennie a Studio Plugins lapján.

2. A Build World készség hozzáadása

Bejelentkezés

A készség telepítése előtt jelentkezz be a Thrixelbe. A parancs minden ügynöknél azonos, és az uv szükséges hozzá. Ha az uv nincs telepítve, futtasd az operációs rendszeredhez tartozó parancsot egy terminálban:

macOS, Linux, WSL 
curl -LsSf https://astral.sh/uv/install.sh | sh
Windows PowerShell 
irm https://astral.sh/uv/install.ps1 | iex

Futtasd az alábbi bejelentkezési parancsot. Amikor megnyílik az oldal a böngészőben, kattints az Approve gombra a Thrixel-fiókod csatlakoztatásához.

Bejelentkezés a Thrixelbe 
uvx thrixel-mcp@latest login

A Build World telepítése

Válaszd ki alább a programozóügynöködet. A Build Worldnek a készségre és a Thrixel MCP-szerverére is szüksége van: előbbi az utasításokat, utóbbi az erőforrások generálásához szükséges eszközöket biztosítja.

Claude Code

Futtasd ezeket a parancsokat egy terminálban a Thrixel-bővítmény telepítéséhez. Ez a készséget és az MCP-szervert is tartalmazza.

Terminál 
claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

Futtasd a claude plugin list parancsot, és ellenőrizd, hogy a thrixel@thrixel engedélyezve van-e. Ezután futtasd a claude mcp list parancsot, és ellenőrizd, hogy a plugin:thrixel:thrixel csatlakoztatva van-e. A telepítés után indíts új Claude Code-munkamenetet.

Codex

Futtasd ezeket a parancsokat egy terminálban a bővítmény Codexbe való telepítéséhez:

Terminál 
codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

Futtasd a codex plugin list parancsot, és ellenőrizd, hogy a thrixel@thrixel telepítve és engedélyezve van-e a Thrixel piacterén. A codex mcp list paranccsal ellenőrizd, hogy a thrixel engedélyezve van-e. A bővítmény betöltéséhez indíts új Codex-munkamenetet.

Ha a Codex adott verziója nem támogatja a bővítményeket, kövesd a kézi telepítési útmutatót.

Cursor

Add hozzá ezt a konfigurációt a ~/.cursor/mcp.json fájlhoz. Ha a fájl már tartalmaz mcpServers szakaszt, add hozzá a thrixel bejegyzést a meglévők lecserélése nélkül.

A Cursor MCP-konfigurációja 
{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

Ezután telepítsd a készséget az operációs rendszeredhez tartozó parancsokkal:

macOS, Linux, WSL 
git clone https://github.com/thrixel/build-world ~/.thrixel/build-world
mkdir -p ~/.cursor/skills
ln -s ~/.thrixel/build-world/skills/build-world ~/.cursor/skills/build-world
Windows PowerShell 
git clone https://github.com/thrixel/build-world "$HOME\.thrixel\build-world"
New-Item -ItemType Directory -Force "$HOME\.cursor\skills" | Out-Null
New-Item -ItemType Junction -Path "$HOME\.cursor\skills\build-world" -Target "$HOME\.thrixel\build-world\skills\build-world"

Indítsd újra a Cursort. Ellenőrizd, hogy a thrixel megjelenik-e a Settings > MCP alatt, majd írd be a / jelet az Agent-csevegésbe, és keresd meg a build-world elemet.

Gemini CLI

Futtasd ezeket a parancsokat egy terminálban a Thrixel MCP-szerver regisztrálásához és a készség telepítéséhez:

Terminál 
gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

Indíts új Gemini CLI-munkamenetet. A /mcp paranccsal keresd meg a thrixel elemet, a /skills list paranccsal pedig a build-world készséget.

A Build World beállítási útmutatója a kézi telepítést, a frissítéseket és a meglévő telepítéseket is tárgyalja.

3. A Roblox Studio beállítása

Engedélyezd a Studio MCP-szerverét, hogy az ügynök kódot futtathasson a Studióban, és képernyőképeket készíthessen a játékról.

  1. Nyisd meg a Roblox Studiót, és hozz létre egy új Baseplate elemet. Ezzel létrejön egy hely, azaz a játék világát tartalmazó Roblox-fájl.
  2. Kattints az ablak jobb felső sarkában lévő Assistant ikonra.
  3. Az Assistant panelen nyisd meg a … > Settings > Manage MCP Servers menüt. Kapcsold be az Enable Studio as MCP server beállítást. A zöld jelző mutatja, hogy a szerver fut.

4. Roblox API-kulcs létrehozása

A Rojo nem szinkronizál 3D-modellfájlokat. Az ügynök Roblox API-kulccsal tölti fel külön a modelleket.

  1. Nyisd meg a Creator Hub hitelesítőadat-oldalát, és kattints a Create API Key gombra.
  2. Az Access Permissions alatt add hozzá az Assets API-rendszert. Válaszd a saját fiókodat tulajdonosnak, és engedélyezd a Read és a Write jogosultságot.
  3. Az Accepted IP Addresses alatt add meg a 0.0.0.0/0 értéket, vagy kapcsold ki az IP-korlátozásokat. Ha a mező üres marad, a feltöltések nem fejezhetők be.
  4. Mivel ez a kulcs bármely IP-címről hozzáférést enged, állíts be rövid lejárati időt, például 30 napot.
  5. Kattints a Save gombra, és másold ki a kulcsot. Csak egyszer jelenik meg.
  6. Mentsd a kulcsot egy roblox_api_key.txt nevű fájlba a játék mappájában. Ezt a fájlt ne add hozzá a Githez.

5. A szerver indítása

A szerver indítása VS Code-ból

  1. A VS Code-ban nyisd meg a parancspalettát a Ctrl + Shift + P billentyűkkel (Macen Cmd + Shift + P). Írd be, hogy „Rojo”, majd válaszd a Rojo: Open Menu lehetőséget.
  2. Ha a mappában nincs Rojo-projekt, kattints a Create one now lehetőségre. A Rojo hozzáadja a default.project.json fájlt és a játék kezdőmappáit.
  3. A Projects in this workspace alatt kattints a projekt nevére a lejátszás ikonja mellett.

A VS Code jobb alsó sarkában megjelenő értesítés megerősíti, hogy a szerver a localhost címen, a 34872 porton figyel. A leállításhoz nyisd meg a Rojo menüjét, és kattints újra a projektre. A lejátszás ikonja leállítási ikonra vált, amíg a szerver fut.

A Roblox Studio csatlakoztatása a szerverhez

  1. Térj vissza a Baseplate-helyhez a Roblox Studióban.
  2. Nyisd meg a Plugins lapot, és kattints a Rojo elemre.
  3. Hagyd a címet localhost, a portot pedig 34872 értéken, kivéve, ha a szerver más portot jelzett.
  4. Kattints a Connect gombra.
  5. A „Sync changes for project” alatt nézd át a helyen végrehajtandó módosításokat, majd kattints az Accept gombra.

A Rojo ablakában most már a projekt neve, a szerver címe és a Disconnect gomb látható. A Studio csatlakoztatva van, és készen áll a módosítások fogadására.

Ha a Studio nem tud csatlakozni, nyisd meg a http://localhost:34872/ címet egy böngészőben. A Rojo állapotoldala jelzi, hogy a szerver fut.

6. A játék elkészítése

Thrixel Cubes

A Thrixel Cubes-egységeket számít fel a 3D-erőforrások generálásáért. A végösszeg az elvégzett műveletektől és a játék erőforrásainak számától függ. Egyes műveletek ára rögzített, másokat használat alapján mérnek, és a futtatás után számolnak el. Egy teljes játék elkészítése a programozóügynök előfizetési keretének nagy részét is felhasználhatja. Nagyobb projekt előtt ellenőrizd az egyenlegedet, az aktuális díjakat pedig nézd meg a Thrixel webhelyén.

A Build World futtatása

  1. Nyisd meg a programozóügynököt a Rojo-projektet tartalmazó mappában.
  2. Kezdj egy üzenetet az ügynököd Build World-parancsával:
    ÜgynökParancs
    Claude Code/thrixel:build-world
    Codex$build-world
    Cursor/build-world
    Gemini CLI/build-world
  3. A parancs után írd le a játékot. Említsd meg a „Roblox” nevet, hogy a készség a megfelelő motort használja.
  4. Említsd meg, hogy a Rojo már fut, és add meg a portot is, hogy az ügynök ne indítson második szervert.

A Codexben írd be a $build kifejezést, és a játék leírása előtt válaszd ki a build-world készséget a készségválasztóból.

Példaprompt Claude Code-hoz 
/thrixel:build-world készíts Roblox-játékot lebegő szigeteken, akadálypályával. A Rojo és a Studio-bővítménye már be van állítva, és a Rojo ezt a mappát a 34872 porton szolgálja ki, ezért ne indíts másik szervert.

Módosítások elfogadása a Roblox Studióban

A kezdeti Rojo-kapcsolat a jóváhagyási lépés. Csatlakozás után a Rojo azonnal szinkronizálja a módosításokat, amint az ügynök lemezre menti őket.

  • Csatlakozáskor: A Rojo felsorolja a fájlok és a hely közötti eltéréseket. Az Accept gombbal alkalmazhatod őket, az Abort gombbal pedig megszakíthatod a csatlakozást. Ha nincsenek eltérések, kérdés nélkül csatlakozik.
  • Az ügynök munkája közben: Az új és módosított szkriptek automatikusan megjelennek a Studióban. Ha a Studiót bezártad vagy leválasztottad, kattints újra a Connect gombra, amikor az ügynök kéri. Az ügynök nem tudja önállóan újracsatlakoztatni a Rojót.
  • A módosítások ellenőrzése: Kattints az utolsó módosítás időpontjára a Rojo ablakában a View changes megnyitásához. Itt megjelennek az alkalmazott módosítások, és jelölést kapnak a sikertelenek. A Rojo módosításai a Studio visszavonási előzményeiben is megjelennek.

Ha szinkronizálás előtt egyben szeretnél átnézni több módosítást, nyisd meg a Rojo ablakában a Settings részt, és állítsd a Confirmation Behavior értékét Always lehetőségre. Kattints a Disconnect gombra, várd meg, amíg az ügynök végez, majd kattints a Connect gombra a módosítások együttes áttekintéséhez. Ez az ellenőrzés csatlakozáskor történik. Az aktív kapcsolat közben mentett módosítások továbbra is automatikusan szinkronizálódnak.

Két dologra kézzel kell figyelni:

  • Mentsd az importokat. A Rojo szkripteket és példányokat szinkronizál. Az ügynök külön tölti fel a 3D-modelleket, és a ReplicatedStorage.Assets alá illeszti őket, ezért ezek a modellek nem tárolódnak a projektfájlokban. Megőrzésükhöz használd a Studio File > Save parancsát.
  • A szinkronizált szkripteket a projektfájlokban szerkeszd. A Rojo kétirányú szinkronizálása alapértelmezés szerint ki van kapcsolva. A Studióban végzett szkriptmódosítások nem kerülnek át a fájlokba, és felülíródhatnak.

7. A játék közzététele

Ha a játék megosztásra kész, használd a Studio File > Publish to Roblox parancsát.