هذا الدليل والفيديو المرافق يوضحان لك كيفية ربط حزام برمجي مدعوم بالذكاء الاصطناعي بـ Roblox Studio عبر MCP، بحيث يمكن لوكيلك القراءة والكتابة وتجربة اللعب نيابة عنك.
بنهاية هذا الدليل، سيكون لديك مجلد مشروع يتزامن مع Studio عبر Script Sync (ميزة تتيح لك استخدام محررك الخاص لكتابة الكود)، واتصال MCP الذي يسمح لوكيلك بالتحكم في Studio مباشرة، ومستودع Git جاهز للتطوير.
الخطوة 1: تثبيت المتطلبات الأساسية
ستحتاج إلى المكونات التالية قبل البدء:
- محرر نصوص مدعوم بالذكاء الاصطناعي - الخيارات الأكثر شيوعًا هي Visual Studio Code و Cursor. يحتوي Cursor على مساعده الذكي مدمجًا، بينما يحتاج VS Code إلى إضافة مثل Claude Code. كلاهما يعمل بشكل جيد هنا، لذا استخدم ما تفضله.
- Roblox Studio - قم بتنزيله من create.roblox.com.
- Git - قم بتثبيته من git-scm.com.
الخطوة 2: تسجيل الدخول إلى كل شيء
- محرر النصوص الخاص بك:
- VS Code — يختلف تسجيل الدخول حسب الإضافة. بالنسبة لـ Claude Code، انقر على أيقونة Claude في شريط النشاط، سجل الدخول باستخدام حسابك في Anthropic، وتأكد من فتح لوحة الدردشة. مقدمو الخدمة الآخرون مشابهون.
- Cursor — افتح Cursor، سجل الدخول باستخدام حسابك في Cursor، وتأكد من فتح لوحة الدردشة. يمكنك استخدام أي نموذج تفضله.
- Roblox Studio — افتح Studio، سجل الدخول باستخدام حساب Roblox الخاص بك، وتأكد من أنه يمكنك إنشاء مكان جديد.
الخطوة 3: تنزيل مستودع البداية
يوفر مستودع البداية تخطيط المجلد وملف .gitignore بحيث يقوم Git بتسجيل الأجزاء المهمة من مشروعك فقط. تم إعداد معظم الإعدادات اليدوية لك.
- قم بتنزيل مستودع البداية وفك ضغطه. يحتوي بالفعل على مجلد باسم WaveSurvival.
- في محررك، اختر ملف → فتح مجلد وحدد WaveSurvival. يجب أن ترى ثلاثة مجلدات داخلها:
- ServerScriptService/ يحتوي على سكربتات الخادم، مثل منطق اللعبة، والذكاء الاصطناعي للعدو، وإدارة الموجات.
- ReplicatedStorage/ يحتوي على وحدات مشتركة يمكن أن يستخدمها كل من الخادم والعميل.
- StarterPlayerScripts/ يحتوي على سكربتات العميل التي تعمل لكل لاعب.
ملفات .gitkeep داخل كل مجلد هي عناصر نائب حتى يتمكن Git من تتبع المجلدات بينما لا تزال فارغة.
الخطوة 4: إنشاء مشروع فارغ في Roblox Studio
- افتح Roblox Studio وانقر على تجربة جديدة.
- اختر ملف → حفظ في ملف، انتقل إلى مجلد WaveSurvival الخاص بك، واحفظ المكان باسم WaveSurvival.rbxlx. يستبعد ملف .gitignore الخاص بمستودع البداية بالفعل ملفات .rbxlx من Git.
- احتفظ بـ Studio مفتوحًا. ستحتاج إليه من أجل Script Sync و MCP.
الخطوة 5: تفعيل بيتا Script Sync
Script Sync هي ميزة تجريبية، لذا تحتاج إلى تفعيلها قبل أن تتمكن من استخدامها.
تقوم Studio بالتحديث بشكل متكرر. إذا لم ترَ Script Sync في القائمة، قم بتثبيت أحدث إصدار من Studio وحاول مرة أخرى.
- في Studio، اختر ملف → ميزات بيتا.
- ابحث عن Script Sync، قم بتمكينه، وانقر على حفظ.
- أعد تشغيل Studio عند الطلب.
الخطوة 6: ربط Script Sync
تقوم بربط Script Sync مرة واحدة لكل مشروع عن طريق ربط كل خدمة في Studio بمجلدها المطابق على القرص.
- في مستكشف الملفات، انقر بزر الماوس الأيمن على ServerScriptService.
- اختر Script Sync → مزامنة إلى، ثم تصفح إلى مجلد WaveSurvival الخاص بك.
- كرر ذلك لـ ReplicatedStorage و StarterPlayerScripts.
اختر المجلد العلوي WaveSurvival، وليس المجلدات داخله. نظرًا لأن المجلدات تحمل الأسماء الصحيحة بالفعل، يقوم Script Sync بمطابقة كل خدمة مع الصحيحة تلقائيًا.
أي ملفات .luau تقوم بإنشائها في تلك المجلدات ستظهر الآن كسكربتات في Studio تلقائيًا.
الخطوة 7: التحقق من Script Sync
في لوحة الدردشة في محررك، اطلب من وكيلك:
أنشئ سكربت اختبار في ServerScriptService/Test.server.luau يقوم بطباعة 'Hello from Script Sync!' إلى الإخراج.
في Studio، تحقق من مستكشف الملفات. يجب أن ترى Test تظهر تحت ServerScriptService. ستقوم بإجراء فحص أعمق يقوده الوكيل بعد الاتصال بـ MCP.
الخطوة 8: تفعيل اتصال MCP
يتيح خادم MCP في Studio لوكيل الذكاء الاصطناعي الخاص بك التفاعل مع Studio مباشرة، قراءة شجرة اللعبة، إنشاء كائنات، تشغيل سكربتات، والتحقق من الإخراج. يغطي أي شيء لا يمكن لـ Script Sync الوصول إليه، مثل StarterGui و StarterPack.
- في Studio، افتح نافذة المساعد باستخدام زر المساعد في الزاوية العلوية اليمنى.
- انقر على ⋯ → إدارة خوادم MCP.
- تأكد من تفعيل MCP.
- تحت الاتصال السريع، قم بتمكين Cursor أو Visual Studio Code.
إذا قمت بتثبيت محررك أثناء فتح Studio، قد تحتاج إلى إعادة تشغيل Studio، محررك، أو كليهما لإقامة الاتصال. لمزيد من التفاصيل، راجع الاتصال بخادم MCP في Roblox Studio.
الخطوة 9: التحقق من اتصال MCP
اطلب من وكيلك:
استخدم MCP في Roblox لقراءة شجرة اللعبة الحالية في Roblox Studio. قم بإدراج ما هو موجود في Workspace.
قد تحتاج إلى الموافقة على الأمر أو إضافة أداة MCP إلى قائمة السماح. بالنسبة لقالب Baseplate جديد، تصفح الاستجابة الوصف الافتراضي لـ Camera و Terrain و Baseplate و SpawnLocation وتأكيد عدم وجود محتوى آخر بعد.
الخطوة 10: إجراء فحص شامل
اطلب من وكيلك التحقق من الإعداد الكامل دفعة واحدة:
استخدم اتصال MCP في Roblox للتحقق من أن Script Sync يعمل بشكل صحيح. قم بإجراء بعض التغييرات على Test.server.luau، أضف سكربتات جديدة في المجلدين الآخرين، وتحقق من الإخراج لكل منها. قم بتشغيل game:GetService("InstanceFileSyncService"):GetStatus(instance) في كل سكربت للتحقق من حالة المزامنة. عندما تنتهي، احذف جميع السكربتات الثلاثة.
راقب في Studio وسترى الوكيل يبدأ اختبار اللعب لتأكيد الإخراج.
الخطوة 11: الالتزام بـ Git
لديك الآن تكوين نظيف وعامل، مما يجعل هذه لحظة جيدة للالتزام. من الطرفية الخاصة بك:
git add .
git commit -m "تم ربط Script sync والتحقق من MCP"الخطوات التالية
مشروعك الآن متزامن مع Studio، يمكن لوكيل الذكاء الاصطناعي الخاص بك التحدث إليه مباشرة، ولديك مستودع Git لتتبع التغييرات والتقدم.
من هنا، يمكنك استخدام ملف WAVE_SURVIVAL.md من مشروع البداية كمرجع لوكيلك لبناء لعبة بقاء الموجات. تابع مع الفيديو المرافق لبناء اللعبة مرحلة واحدة تم اختبارها في كل مرة.