چگونه با AI + Thrixel در Roblox بازی بسازیم

پیش از شروع، باید Roblox Studio نصب باشد و یک حساب Roblox داشته باشید.

1. نصب Rojo با VS Code

1. Visual Studio Code (VS Code) را نصب کنید.
2. افزونهٔ Rojo - Roblox Studio Sync را برای VS Code نصب کنید.
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 باید در زبانهٔ Plugins در Studio ظاهر شود.

2. افزودن مهارت Build World

ورود به حساب

پیش از نصب مهارت، وارد حساب Thrixel شوید. فرمان برای همهٔ عامل‌ها یکسان است و به uv نیاز دارد. اگر uv نصب نیست، فرمان مخصوص سیستم‌عامل خود را در ترمینال اجرا کنید:

curl -LsSf https://astral.sh/uv/install.sh | sh

irm https://astral.sh/uv/install.ps1 | iex

فرمان ورود زیر را اجرا کنید. وقتی صفحه در مرورگر باز شد، برای اتصال حساب Thrixel روی Approve کلیک کنید.

uvx thrixel-mcp@latest login

نصب Build World

عامل کدنویسی خود را در پایین انتخاب کنید. Build World هم به مهارت نیاز دارد که دستورالعمل‌ها را ارائه می‌کند و هم به سرور MCP مربوط به Thrixel که ابزارهای تولید دارایی‌ها را فراهم می‌کند.

claude plugin marketplace add thrixel/build-world
claude plugin install thrixel@thrixel

codex plugin marketplace add thrixel/build-world
codex plugin add thrixel@thrixel

{
  "mcpServers": {
    "thrixel": {
      "type": "stdio",
      "command": "uvx",
      "args": ["thrixel-mcp@latest"]
    }
  }
}

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

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"

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

راهنمای راه‌اندازی Build World نصب دستی، به‌روزرسانی‌ها و نصب‌های موجود را نیز پوشش می‌دهد.

3. راه‌اندازی Roblox Studio

سرور MCP در Studio را فعال کنید تا عامل بتواند در Studio کد اجرا کند و از بازی تصویر بگیرد.

1. Roblox Studio را باز و یک Baseplate جدید ایجاد کنید. این کار یک مکان یا همان فایل Roblox حاوی دنیای بازی می‌سازد.
2. روی نماد Assistant در گوشهٔ بالای سمت راست پنجره کلیک کنید.
3. در پنل Assistant، مسیر … > Settings > Manage MCP Servers را باز کنید. Enable Studio as MCP server را روشن کنید. نشانگر سبز تأیید می‌کند که سرور در حال اجراست.

4. ساخت کلید API برای Roblox

Rojo فایل‌های مدل سه‌بعدی را همگام نمی‌کند. عامل برای بارگذاری جداگانهٔ مدل‌ها از کلید API مربوط به Roblox استفاده می‌کند.

1. به صفحهٔ اطلاعات دسترسی خود در Creator Hub بروید و روی Create API Key کلیک کنید.
2. در Access Permissions، سامانهٔ API به نام Assets را اضافه کنید. حساب خود را به‌عنوان مالک انتخاب و 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. به مکان Baseplate در Roblox Studio برگردید.
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 برای تولید دارایی‌های سه‌بعدی 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 را از انتخابگر مهارت انتخاب کنید.

/thrixel:build-world یک بازی مسیر موانع در Roblox روی جزیره‌های شناور بساز. Rojo و افزونهٔ Studio آن از قبل راه‌اندازی شده‌اند و Rojo این پوشه را روی درگاه 34872 ارائه می‌کند، پس سرور دیگری اجرا نکن.

پذیرفتن تغییرات در Roblox Studio

اتصال اولیهٔ Rojo مرحلهٔ تأیید است. پس از اتصال، Rojo تغییرات را به‌محض ذخیره‌شدن روی دیسک توسط عامل همگام می‌کند.

• هنگام اتصال: Rojo تفاوت‌های میان فایل‌ها و مکان را فهرست می‌کند. برای اعمال آن‌ها روی Accept یا برای لغو اتصال روی Abort کلیک کنید. اگر تفاوتی نباشد، بدون پرسش متصل می‌شود.
• هنگام کار عامل: اسکریپت‌های تازه و ویرایش‌شده خودکار در Studio ظاهر می‌شوند. اگر Studio بسته یا اتصال آن قطع شد، وقتی عامل درخواست کرد دوباره روی Connect کلیک کنید. عامل نمی‌تواند خودش Rojo را دوباره متصل کند.
• برای بررسی تغییرات: روی زمان آخرین تغییر در پنجرهٔ Rojo کلیک کنید تا View changes باز شود. این بخش تغییرات اعمال‌شده را فهرست و موارد ناموفق را مشخص می‌کند. تغییرات Rojo در تاریخچهٔ بازگردانی Studio نیز دیده می‌شوند.

برای بررسی دسته‌ای از تغییرات پیش از همگام‌سازی، Settings را در پنجرهٔ Rojo باز و Confirmation Behavior را روی Always تنظیم کنید. روی Disconnect کلیک کنید، بگذارید عامل کارش را تمام کند و سپس برای بررسی یکجای تغییرات روی Connect کلیک کنید. این بررسی هنگام اتصال انجام می‌شود. تغییرات ذخیره‌شده در طول اتصال فعال همچنان خودکار همگام می‌شوند.

دو کار به رسیدگی دستی نیاز دارد:

• موارد واردشده را ذخیره کنید. Rojo اسکریپت‌ها و نمونه‌ها را همگام می‌کند. عامل مدل‌های سه‌بعدی را جداگانه بارگذاری و در ReplicatedStorage.Assets قرار می‌دهد، پس این مدل‌ها در فایل‌های پروژه ذخیره نمی‌شوند. برای نگه‌داشتن آن‌ها در Studio از File > Save استفاده کنید.
• اسکریپت‌های همگام‌شده را در فایل‌های پروژه ویرایش کنید. همگام‌سازی دوطرفهٔ Rojo به‌طور پیش‌فرض خاموش است. تغییر این اسکریپت‌ها در Studio به فایل‌ها منتقل نمی‌شود و ممکن است بازنویسی شود.

7. انتشار بازی

وقتی بازی آمادهٔ اشتراک‌گذاری شد، در Studio از File > Publish to Roblox استفاده کنید.