AI + Thrixel көмегімен Roblox-та ойын жасау

Thrixel 3D модельдерді жасайды, Build World бағдарламалау агентіне бағыт береді, ал Rojo ойын кодын Roblox Studio-мен синхрондайды.

Бастамас бұрын Roblox Studio орнатылып, Roblox тіркелгісі болуы керек.

Build a Gigacorp, Thrixel компаниясының Build World дағдысымен жасалған Roblox ойыны.

1. Rojo-ны VS Code арқылы орнату

  1. Visual Studio Code (VS Code) орнатыңыз.
  2. VS Code үшін Rojo - Roblox Studio Sync кеңейтімін орнатыңыз.
  3. VS Code ішінде File > Open Folder арқылы ойынға арналған бос буманы ашыңыз.
  4. Пәрмендер палитрасын ашу үшін Ctrl + Shift + P (Mac-та Cmd + Shift + P) басыңыз. «Rojo» деп теріп, Rojo: Open Menu таңдаңыз.
  5. Мәзір Rojo орнатылмағанын көрсетсе, Install Rojo now басыңыз.
  6. Install Roblox Studio Plugin басыңыз. Studio ашық болса, қайта іске қосыңыз. Содан кейін Rojo Studio-ның Plugins қойындысында көрінуі тиіс.

2. Build World дағдысын қосу

Кіру

Дағдыны орнатпас бұрын Thrixel тіркелгісіне кіріңіз. Пәрмен барлық агентке бірдей және uv қажет етеді. uv орнатылмаса, терминалда операциялық жүйеңізге арналған пәрменді орындаңыз:

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

Төмендегі кіру пәрменін орындаңыз. Браузер беті ашылғанда, Thrixel тіркелгісін байланыстыру үшін Approve басыңыз.

Thrixel тіркелгісіне кіру
uvx thrixel-mcp@latest login

Build World орнату

Төменнен бағдарламалау агентін таңдаңыз. Build World үшін нұсқаулар беретін дағды да, ресурстар жасау құралдарын ұсынатын Thrixel MCP сервері де қажет.

Claude Code

Thrixel плагинін орнату үшін терминалда осы пәрмендерді орындаңыз. Оның құрамында дағды да, MCP сервері де бар.

Терминал
claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

claude plugin list орындап, thrixel@thrixel қосылғанын тексеріңіз. Одан кейін claude mcp list орындап, plugin:thrixel:thrixel жалғанғанын тексеріңіз. Орнатқан соң жаңа Claude Code сеансын бастаңыз.

Codex

Плагинді Codex-ке орнату үшін терминалда осы пәрмендерді орындаңыз:

Терминал
codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

codex plugin list орындап, Thrixel каталогында thrixel@thrixel орнатылып, қосылғанын тексеріңіз. codex mcp list арқылы thrixel қосылғанын тексеріңіз. Плагинді жүктеу үшін жаңа Codex сеансын бастаңыз.

Плагинді қолдамайтын Codex нұсқаларында қолмен орнату нұсқауларын пайдаланыңыз.

Cursor

Бұл конфигурацияны ~/.cursor/mcp.json файлына қосыңыз. Файлда mcpServers бөлімі бар болса, бұрынғы жазбаларды ауыстырмай, оған thrixel жазбасын қосыңыз.

Cursor MCP конфигурациясы
{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

Содан кейін операциялық жүйеңізге арналған пәрмендермен дағдыны орнатыңыз:

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"

Cursor-ды қайта іске қосыңыз. Settings > MCP ішінде thrixel барын тексеріп, Agent чатына / теріңіз де, build-world іздеңіз.

Gemini CLI

Thrixel MCP серверін тіркеп, дағдыны орнату үшін терминалда осы пәрмендерді орындаңыз:

Терминал
gemini mcp add -s user --trust thrixel uvx -- thrixel-mcp@latest
gemini skills install https://github.com/thrixel/build-world --path skills/build-world

Жаңа Gemini CLI сеансын бастаңыз. thrixel барын тексеру үшін /mcp, ал build-world үшін /skills list орындаңыз.

Build World баптау нұсқаулығында қолмен орнату, жаңарту және бұрын орнатылған нұсқалар да қарастырылады.

3. Roblox Studio-ны баптау

Агент Studio ішінде код орындап, ойынның скриншоттарын түсіруі үшін Studio MCP серверін қосыңыз.

  1. Roblox Studio-ны ашып, жаңа Baseplate жасаңыз. Осылай ойын әлемін сақтайтын Roblox файлы, яғни орын жасалады.
  2. Терезенің жоғарғы оң жақ шетіндегі Assistant белгішесін басыңыз.
  3. Assistant панелінде … > Settings > Manage MCP Servers ашыңыз. Enable Studio as MCP server қосыңыз. Жасыл көрсеткіш оның жұмыс істеп тұрғанын растайды.

4. Roblox API кілтін жасау

Rojo 3D модель файлдарын синхрондамайды. Агент модельдерді бөлек жүктеу үшін Roblox API кілтін пайдаланады.

  1. Creator Hub тіркелгі деректері бетіне өтіп, Create API Key басыңыз.
  2. Access Permissions ішінде Assets API жүйесін қосыңыз. Иесі ретінде өз тіркелгіңізді таңдап, Read және Write рұқсаттарын қосыңыз.
  3. Accepted IP Addresses ішінде 0.0.0.0/0 қосыңыз немесе IP шектеулерін өшіріңіз. Бұл өріс бос қалса, жүктеулер аяқталмайды.
  4. Кілт кез келген IP мекенжайдан кіруге рұқсат беретіндіктен, қысқа жарамдылық мерзімін, мысалы, 30 күн белгілеңіз.
  5. Save басып, кілтті көшіріңіз. Ол тек бір рет көрсетіледі.
  6. Кілтті ойын бумасындағы roblox_api_key.txt атты файлға сақтаңыз. Бұл файлды Git-ке қоспаңыз.

5. Серверді іске қосу

Серверді VS Code ішінен іске қосу

  1. VS Code ішінде Ctrl + Shift + P (Mac-та Cmd + Shift + P) арқылы пәрмендер палитрасын ашыңыз. «Rojo» теріп, Rojo: Open Menu таңдаңыз.
  2. Бумада Rojo жобасы болмаса, Create one now басыңыз. Rojo default.project.json файлын және ойынның бастапқы бумаларын қосады.
  3. Projects in this workspace ішінде іске қосу белгішесінің жанындағы жоба атауын басыңыз.

VS Code-тың төменгі оң жақ бұрышындағы хабарлама сервердің localhost мекенжайындағы 34872 портын тыңдап тұрғанын растайды. Тоқтату үшін Rojo мәзірін ашып, жобаны қайта басыңыз. Сервер жұмыс істегенде іске қосу белгішесі тоқтату белгішесіне ауысады.

Roblox Studio-ны серверге жалғау

  1. Roblox Studio ішіндегі Baseplate орнына оралыңыз.
  2. Plugins қойындысын ашып, Rojo басыңыз.
  3. Сервер басқа порт көрсетпесе, мекенжайды localhost, портты 34872 күйінде қалдырыңыз.
  4. Connect басыңыз.
  5. «Sync changes for project» ішінде Rojo орынға енгізетін өзгерістерді қарап, Accept басыңыз.

Rojo терезесінде енді жоба атауы, сервер мекенжайы және Disconnect түймесі көрінеді. Studio жалғанды және өзгерістерді қабылдауға дайын.

Studio жалғана алмаса, браузерде http://localhost:34872/ ашыңыз. Rojo күй беті сервердің жұмыс істеп тұрғанын растайды.

6. Ойынды жасау

Thrixel Cubes

Thrixel 3D ресурстарды жасау үшін Cubes есептейді. Жалпы құн қолданылған әрекеттерге және ойындағы ресурстар санына байланысты. Кейбір әрекеттің бағасы тұрақты, басқаларының қолданылуы өлшеніп, төлемі орындалғаннан кейін есептеледі. Толық ойын жасау бағдарламалау агенті жоспарының лимиттерінің көп бөлігін де жұмсауы мүмкін. Үлкен жұмысты бастамас бұрын теңгерімді тексеріп, ағымдағы бағаларды Thrixel сайтынан қараңыз.

Build World іске қосу

  1. Бағдарламалау агентін Rojo жобасы бар бумада ашыңыз.
  2. Хабарламаны агентіңізге арналған Build World пәрменімен бастаңыз:
    АгентПәрмен
    Claude Code/thrixel:build-world
    Codex$build-world
    Cursor/build-world
    Gemini CLI/build-world
  3. Пәрменнен кейін ойынды сипаттаңыз. Дағды дұрыс қозғалтқышты қолдануы үшін «Roblox» сөзін қосыңыз.
  4. Агент екінші серверді іске қоспауы үшін Rojo жұмыс істеп тұрғанын және портын айтыңыз.

Codex ішінде $build теріп, ойын сипаттамасын қоспас бұрын дағдылар тізімінен build-world таңдаңыз.

Claude Code үшін сұрау мысалы
/thrixel:build-world Roblox-та қалықтаған аралдардағы кедергілер жолағы ойынын жаса. Rojo мен оның Studio плагині бапталған, ал Rojo осы буманы 34872 портында ұсынып тұр, сондықтан басқа серверді іске қоспа.

Roblox Studio ішінде өзгерістерді қабылдау

Rojo-ға алғашқы жалғану мақұлдау қадамы болады. Жалғанған соң Rojo агент өзгерістерді дискіге сақтай салысымен синхрондайды.

  • Жалғану кезінде: Rojo файлдар мен орынның айырмаларын көрсетеді. Қолдану үшін Accept, жалғанудан бас тарту үшін Abort басыңыз. Айырма болмаса, сұрамай жалғанады.
  • Агент жұмыс істегенде: Жаңа және өңделген скрипттер Studio ішінде автоматты түрде пайда болады. Studio жабылса немесе ажыратылса, агент сұрағанда Connect қайта басыңыз. Агент Rojo-ны өзі қайта жалғай алмайды.
  • Өзгерістерді тексеру үшін: View changes ашу үшін Rojo терезесіндегі соңғы өзгеріс уақытын басыңыз. Онда қолданылған өзгерістер тізімі мен сәтсіз болғандары көрсетіледі. Rojo өзгерістері Studio-ның болдырмау тарихында да көрінеді.

Өзгерістер тобын синхрондамас бұрын қарау үшін Rojo терезесінде Settings ашып, Confirmation Behavior мәнін Always етіп қойыңыз. Disconnect басып, агенттің бітіруін күтіңіз, кейін өзгерістерді бірге қарау үшін Connect басыңыз. Бұл тексеру жалғанғанда орындалады. Белсенді байланыс кезінде сақталған өзгерістер бәрібір автоматты синхрондалады.

Екі нәрсеге қолмен назар аудару керек:

  • Импортталған модельдерді сақтаңыз. Rojo скрипттер мен нысан даналарын синхрондайды. Агент 3D модельдерді бөлек жүктеп, ReplicatedStorage.Assets ішіне қосады, сондықтан олар жоба файлдарында сақталмайды. Оларды сақтау үшін Studio ішінде File > Save таңдаңыз.
  • Синхрондалатын скрипттерді жоба файлдарында өңдеңіз. Rojo-ның екіжақты синхрондауы әдепкіде өшірулі. Studio ішінде бұл скрипттерге енгізілген өзгерістер файлдарға өтпейді және үстінен жазылуы мүмкін.

7. Ойынды жариялау

Ойын бөлісуге дайын болғанда Studio ішінде File > Publish to Roblox таңдаңыз.