هذا الدليل والفيديو المرافق يمشيك عبر كيفية توصيل حزمة برمجية مدعومة بالذكاء الاصطناعي بـ Roblox Studio عبر MCP، بحيث يمكن لوكيلك القراءة والكتابة واختبار اللعبة باسمك.
بنهاية هذا الدليل، سيكون لديك مجلد مشروع يتزامن مع الاستوديو من خلال Script Sync (وهي ميزة تسمح لك باستخدام محررك الخاص لكتابة الكود)، ووصلة MCP تسمح لوكيلك بالتحكم في الاستوديو مباشرة، ومستودع 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.
- حافظ على فتح الاستوديو. ستحتاج إليه من أجل Script Sync وMCP.
الخطوة 5: تفعيل نسخة بيتا من Script Sync
Script Sync هي ميزة تجريبية، لذا تحتاج إلى تفعيلها قبل أن تتمكن من استخدامها.
التحديثات تكون متكررة في الاستوديو. إذا لم ترى Script Sync في القائمة، قم بتثبيت أحدث إصدار من الاستوديو وحاول مرة أخرى.
- في الاستوديو، اختر ملف → ميزات بيتا.
- ابحث عن Script Sync، وقم بتمكينه، ثم انقر على حفظ.
- أعد تشغيل الاستوديو عند الطلب.
الخطوة 6: ربط Script Sync
تقوم بربط Script Sync مرة واحدة لكل مشروع عن طريق ربط كل خدمة في الاستوديو بمجلدها المتطابق على القرص.
- في المتصفح، انقر بزر الماوس الأيمن على ServerScriptService.
- اختر Script Sync → المزامنة إلى، ثم تصفح إلى مجلد WaveSurvival.
- كرر ذلك بالنسبة لـ ReplicatedStorage و StarterPlayerScripts.
اختر المجلد الرئيسي WaveSurvival، وليس المجلدات داخله. لأن المجلدات تحمل أسماء صحيحة، يقوم Script Sync بمطابقة كل خدمة بالتالي بشكل تلقائي.
أي ملفات .luau تقوم بإنشائها في تلك المجلدات تظهر الآن كسكريبتات في الاستوديو تلقائيًا.
الخطوة 7: تحقق من Script Sync
في لوحة الدردشة لمحررك، اطلب من وكيلك:
أنشئ سكريبت اختبار في ServerScriptService/Test.server.luau يقوم بطباعة 'مرحبًا من Script Sync!' إلى الإخراج.
في الاستوديو، تحقق من المتصفح. يجب أن ترى Test تظهر تحت ServerScriptService. ستقوم بإجراء تحقق أعمق مدفوع من الوكيل بعد الاتصال بـ MCP.
الخطوة 8: تفعيل اتصال MCP
تتيح لك خادم MCP في الاستوديو تفاعل وكيل الذكاء الاصطناعي الخاص بك مع الاستوديو مباشرة، قراءة شجرة اللعبة، إنشاء كائنات، تشغيل سكريبتات، والتحقق من الإخراج. تغطي هذه الوظائف أي شيء لا يستطيع Script Sync الوصول إليه، مثل StarterGui و StarterPack.
- في الاستوديو، افتح نافذة المساعد باستخدام زر المساعد في الزاوية العلوية اليمنى.
- انقر على ⋯ → إدارة خوادم MCP.
- تأكد من تمكين MCP.
- تحت الاتصال السريع، قم بتمكين Cursor أو Visual Studio Code.
إذا قمت بتثبيت محررك أثناء فتح الاستوديو، قد تحتاج إلى إعادة تشغيل الاستوديو أو محررك أو كليهما لإقامة الاتصال. لمزيد من التفاصيل، راجع الاتصال بخادم MCP في Roblox Studio.
الخطوة 9: تحقق من اتصال MCP
اطلب من وكيلك:
استخدم MCP الخاص بـ Roblox لقراءة شجرة اللعبة الحالية في Roblox Studio. أدرج ما هو موجود في Workspace.
قد تحتاج إلى الموافقة على الأمر أو إضافة أداة MCP إلى قائمة السماح. بالنسبة لقالب Baseplate جديد، سيصف الرد الكاميرا الافتراضية، والتضاريس، وBaseplate، وSpawnLocation ويؤكد عدم وجود محتوى آخر بعد.
الخطوة 10: إجراء تحقق شامل
اطلب من وكيلك التحقق من الإعداد بالكامل دفعة واحدة:
استخدم اتصال MCP الخاص بـ Roblox للتحقق من أن Script Sync يعمل بشكل صحيح. قم بإجراء بعض التغييرات على Test.server.luau، أضف سكريبتات جديدة في المجلدين الآخرين، وتحقق من إخراج كل منها. شغل game:GetService("InstanceFileSyncService"):GetStatus(instance) في كل سكريبت للتحقق من حالة المزامنة. عند الانتهاء، احذف جميع السكريبتات الثلاثة.
راقب في الاستوديو وسترى الوكيل يبدأ اختبار اللعبة لتأكيد الإخراج.
الخطوة 11: الالتزام إلى Git
لديك الآن تكوين نظيف وعامل، مما يجعل هذه لحظة جيدة للاعتماد. من موجه الأوامر:
الخطوات التالية
مشروعك متزامن الآن مع الاستوديو، يمكن لوكيل الذكاء الاصطناعي التحدث إليه مباشرة، ولديك مستودع Git لتتبع التغييرات والتقدم.
من هنا، يمكنك استخدام ملف WAVE_SURVIVAL.md من مشروع البدء كسياق لوكيلك لبناء لعبة البقاء على الموجات. تابع مع الفيديو المرافق لبناء اللعبة مرحلة واحدة مع اختبار في كل مرة.