كيفية بناء لعبة في Roblox باستخدام AI + Thrixel

قبل البدء، ثبّت 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‏ (Cmd + Shift + P على Mac) لفتح لوحة الأوامر. اكتب «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

شغّل أمر تسجيل الدخول أدناه. عند فتح الصفحة في المتصفح، انقر على Approve لربط حساب Thrixel.

uvx thrixel-mcp@latest login

تثبيت Build World

اختر وكيل البرمجة أدناه. يحتاج Build World إلى المهارة التي توفر التعليمات، وإلى خادم Thrixel MCP الذي يوفر أدوات إنشاء الأصول.

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 جديدًا. ينشئ ذلك place، وهو ملف Roblox الذي يحتوي على عالم اللعبة.
2. انقر على أيقونة Assistant في أقصى أعلى يمين النافذة.
3. في لوحة Assistant، افتح … > Settings > Manage MCP Servers. شغّل Enable Studio as MCP server. يؤكد المؤشر الأخضر أن الخادم يعمل.

4. إنشاء مفتاح Roblox API

لا يزامن Rojo ملفات النماذج ثلاثية الأبعاد. يستخدم الوكيل مفتاح Roblox API لرفع النماذج بشكل منفصل.

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‏ (Cmd + Shift + P على Mac). اكتب «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. عُد إلى place الخاص بـBaseplate في Roblox Studio.
2. افتح علامة التبويب Plugins وانقر على Rojo.
3. اترك العنوان localhost والمنفذ 34872، إلا إذا أبلغ الخادم عن منفذ مختلف.
4. انقر على Connect.
5. ضمن «Sync changes for project»، راجع التغييرات التي سيُجريها Rojo على place ثم انقر على 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 الاختلافات بين الملفات وplace. انقر على Accept لتطبيقها، أو Abort لإلغاء الاتصال. إذا لم توجد اختلافات، يتصل دون طلب تأكيد.
• أثناء عمل الوكيل: تظهر السكربتات الجديدة والمعدّلة تلقائيًا في Studio. إذا أُغلق Studio أو فُصل الاتصال، فانقر على Connect مجددًا عندما يطلب الوكيل ذلك. لا يستطيع الوكيل إعادة توصيل Rojo بنفسه.
• لفحص التغييرات: انقر على وقت آخر تغيير في نافذة Rojo لفتح View changes. تعرض القائمة التغييرات المطبّقة وتُميّز التغييرات التي فشلت. تُسجّل تغييرات Rojo أيضًا في سجل التراجع داخل Studio.

لمراجعة دفعة من التغييرات قبل المزامنة، افتح Settings في نافذة Rojo واضبط Confirmation Behavior على Always. انقر على Disconnect وانتظر حتى ينتهي الوكيل، ثم انقر على Connect لمراجعة التغييرات معًا. تحدث هذه المراجعة عند الاتصال. أما التغييرات المحفوظة أثناء اتصال نشط فتظل تُزامن تلقائيًا.

هناك أمران يحتاجان إلى تدخل يدوي:

• احفظ النماذج المستوردة. يزامن Rojo السكربتات ومثيلات الكائنات. يرفع الوكيل النماذج ثلاثية الأبعاد بشكل منفصل ويُدرجها في ReplicatedStorage.Assets، لذا لا تُحفظ هذه النماذج في ملفات المشروع. استخدم File > Save في Studio للاحتفاظ بها.
• عدّل السكربتات المتزامنة في ملفات المشروع. المزامنة ثنائية الاتجاه في Rojo معطلة افتراضيًا. التعديلات التي تُجرى على هذه السكربتات في Studio لا تصل إلى الملفات وقد تُستبدل.

7. نشر اللعبة

استخدم File > Publish to Roblox في Studio عندما تصبح اللعبة جاهزة للمشاركة.